钉钉互动卡片如何推送给个人?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
钉钉的互动卡片(Interactive Card)通常是在群聊中发送和展示的,用于与多人进行交互。如果您想要将互动卡片推送给个人用户,可以通过以下方式实现:
私聊机器人:创建一个专门用于与个人用户进行私聊的钉钉机器人。您可以在钉钉管理后台创建一个自定义机器人,并获取相应的Webhook地址。
使用消息推送接口:借助钉钉开放平台提供的消息推送接口,将互动卡片作为消息内容,通过API向指定的个人用户推送消息。
具体步骤如下:
创建互动卡片:使用合适的开发语言和框架构建互动卡片的内容,包括文本、图片、按钮等元素。
获取个人用户的ID:为了向个人用户推送消息,您需要获得目标用户的钉钉用户ID。可以通过调用钉钉开放平台提供的用户信息接口,或者通过其他方式获取用户的ID。
调用消息推送接口:使用您所选择的编程语言和HTTP库,将互动卡片作为消息内容,调用钉钉开放平台的消息推送接口,将消息发送给指定用户。
请注意,钉钉的消息推送接口可能需要配置正确的权限和签名验证。确保您已经熟悉和遵循钉钉开放平台的相关文档和要求,以便正确地调用接口并推送互动卡片给个人用户。
钉钉互动卡片可以通过两个API推送给个人:
群聊消息发送API
json
Copy
post https://oapi.dingtalk.com/chat/send?access_token=ACCESS_TOKEN
{
"chat_id": "CHAT_ID",
"sender_id": "SENDER_ID",
"msg_type": "interactive",
"interactive": {
...
}
}
需要指定chat_id为个人的OpenID,发送方sender_id也指定为机器人ID。
2.个人消息发送API
json
Copy
post https://oapi.dingtalk.com/topapi/message/corpconversation/send_interactive?access_token=ACCESS_TOKEN
{
"touser": "USER_ID",
"msg": {
"type": "interactive",
"interactive": {
...
}
}
}
直接指定touser为接收方的用户ID。
其中interactive内容为卡片JSON配置,比如:
json
Copy
{
"card_type": "action_card",
"config": {
"wide_screen_mode": true,
"title": "互动卡片",
"action_list": [
{
"action_name": "操作1",
"action_url": "xxxxxxxx"
},
{
"action_name": "操作2",
"action_url": "yyyyyyyy"
}
]
}
}
两种API的区别是:
群聊消息API推送,对方会收到类似@机器人的消息提醒
个人消息API推送,对方不会收到额外消息推送,卡片直接显示