钉钉互动卡片有哪些属性,如何发送、更新和控制回调?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
钉钉互动卡片是一种在钉钉工作通知、审批等场景下使用的消息类型,具有丰富的交互功能。以下是钉钉互动卡片的常见属性和相关操作:
属性:
发送卡片消息:
更新卡片消息:
控制回调:
需要注意的是,以上操作涉及到钉钉开放平台的接口和相关参数,具体的接口名称和参数可能会因钉钉版本和组织设置而有所不同。建议您查阅钉钉开放平台的文档和接口说明,以获取最新的接口列表和具体使用方法。
钉钉的互动卡片(Interactive Card)是一种用于在群聊中展示交互式内容的消息类型。它可以包含文本、图片、按钮、表单等元素,并且支持通过回调进行用户操作的响应。
互动卡片具有以下属性:
msgtype
:消息类型,设置为interactive
表示发送互动卡片。interaction_type
:互动类型,指定互动卡片的样式和行为。例如,可选值为card
、form
、picker
等。title
:卡片标题,用于展示在互动卡片的顶部。content
:卡片内容,可以是文本或富文本形式的内容描述。buttons
:按钮列表,包含多个按钮,在互动卡片上展示不同的操作按钮。发送互动卡片:
要发送互动卡片,您需要使用钉钉开放平台提供的机器人接口(Webhook),将互动卡片作为消息内容发送到指定的群聊。
更新互动卡片:
如果您想要更新已经发送的互动卡片,可以通过再次发送一个新的互动卡片消息来覆盖原有的卡片内容。这样,钉钉会自动将新的卡片显示在群聊中,并隐藏旧的卡片。
控制回调:
互动卡片中的按钮可以设置回调参数,当用户点击按钮时,钉钉会发送一个回调事件给您的服务器。您可以在机器人接口(Webhook)配置的回调 URL 中处理这些回调事件,并根据需要进行业务逻辑的处理。
卡片类型:
action_card:操作类卡片,包含一组操作按钮
news_card:图文类卡片,包含标题、内容和图片
其他类型
配置属性:
title:卡片标题
description:描述
btns:按钮组,用于操作类卡片
articles:文章组,用于图文类卡片
image:图片地址
更多属性
发送过程:
调用聊天API或个人API,发送初始化卡片
钉钉在手机端显示该卡片
更新卡片:
通过聊天API或个人API再次发送卡片JSON
手机号端会判断为更新操作,实时更新卡片内容
控制回调:
在按钮组btns中,配置action_url作为回调URL
用户点击按钮后,会 GET 或 POST请求配置的回调URL
在回调URL中,可以获取到调用该API的钉钉用户userid和部门deptid信息
回调数据格式:
json
Copy
{
"encrypt_type": 0,
"msg_signature": "xxxxxx",
"timestamp": 1582471623,
"nonce": "1584136020",
"user_id":"xxxx" //回调用户ID
}
{
"userid":"xxxx",
"deptid":"1"
}
通过上述方式,就可以实现钉钉互动卡片的发送、更新和事件回调。
互动卡片的属性包括发送人、接收人、卡片标题、卡片内容、卡片按钮等。可以通过调用API接口来发送、更新和控制回调互动卡片。具体包括:发送互动卡片、更新互动卡片、注册互动卡片回调地址、人与人会话中机器人发送互动卡片等。此回答整理自钉群“钉钉开发者社区(互助群)”