钉钉如何发送一条整体跳转ActionCard样式的卡片消息?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在钉钉中发送一条整体跳转ActionCard样式的卡片消息,您可以按照以下步骤进行:
构建消息内容:首先,构建卡片消息的内容,包括标题、内容、按钮等。整体跳转ActionCard样式的卡片消息通常包含一个跳转链接和一个按钮。
创建消息对象:根据钉钉开放平台提供的消息格式,创建一个JSON对象,用于描述消息的具体内容。
设置消息类型和样式:在消息对象中设置msgtype
字段为actionCard
,并设置actionCard
字段中的title
、text
、singleTitle
、singleURL
等字段,分别对应卡片的标题、内容、按钮文字和跳转链接。
发送消息:使用钉钉开放平台提供的接口,如/topapi/message/corpconversation/asyncsend_v2
,将消息对象作为参数发送给指定会话或用户。
下面是发送整体跳转ActionCard样式卡片消息的示例代码(以Python为例):
import requests
url = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2"
access_token = "YOUR_ACCESS_TOKEN"
headers = {'Content-Type': 'application/json'}
data = {
"agent_id": YOUR_AGENT_ID,
"userid_list": ["user1", "user2"], # 目标用户列表,可根据需要修改
"msg": {
"msgtype": "actionCard",
"actionCard": {
"title": "卡片标题",
"text": "卡片内容",
"singleTitle": "查看详情",
"singleURL": "https://example.com"
}
}
}
response = requests.post(url, headers=headers, params={"access_token": access_token}, json=data)
print(response.json())
具体的操作如下:
注册应用并获得access token
首先,在钉钉开放平台注册一个应用,会获得appkey和appsecret。使用appsecret和auth code换取access token。
准备请求参数
请求参数需要指定卡片的标题、描述、图片、按钮等内容:
标题和描述
图片url
一个跳转整体ActionCard类型的按钮,指定跳转url和文本
调用群消息接口
利用access token 调用群消息接口发送卡片消息:
Copy
https://oapi.dingtalk.com/message/transpot/send_to_conversation?access_token={access_token}
请求参数如下:
json
Copy
{
"msgtype": "action_card",
"action_card":{
"title": "卡片标题",
"text": "卡片描述",
...
"btnorient": "0",
"btns": [{
"action_url": "跳转URL",
"title": "按钮文本",
"type": "action_url"
}]
}
}
其中type值为action_url,表示整体跳转类型的按钮。
要发送一条整体跳转ActionCard样式的卡片消息,需要传入参数msgtype、action_card.markdown、action_card.title、action_card.single_title和action_card.single_url。其中,action_card.single_title和action_card.single_url必须同时设置。消息样例如下: { "msgtype": "action_card", "action_card": { "title": "是透出到会话列表和通知的文案", "markdown": "支持markdown格式的正文内容", "single_title": "查看详情", "single_url": "https://open.dingtalk.com" } }此回答整理自钉群“钉钉开发者社区(互助群)”