钉钉互动卡片有哪些属性,如何发送、更新和控制回调?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
钉钉互动卡片(Interactive Card)是一种在钉钉工作台中展示交互内容的方式,它可以包含多种属性和功能。以下是一些常见的钉钉互动卡片属性和相关操作说明:
标题(title):互动卡片的标题,用于描述卡片的主题或内容。
消息内容(text):互动卡片的详细内容,可以包含文本、链接、图片等信息。
按钮(buttons):互动卡片中的按钮,可以用于触发特定的操作或跳转到其他页面。每个按钮包含一个标题和一个点击事件。
表单(form):互动卡片中的表单,用于收集用户输入的信息。表单可以包含文本输入框、下拉框、单选框等控件。
发送互动卡片:
您可以通过钉钉的机器人或消息接口发送互动卡片。在消息中包含互动卡片的相关属性,如标题、内容、按钮等,以及指定卡片的接收人或群组。
更新互动卡片:
如果您需要更新已发送的互动卡片,可以使用钉钉的消息更新接口。通过指定卡片的唯一标识符和要更新的属性,可以更新卡片的内容、按钮等。
控制回调:
互动卡片中的按钮可以触发回调事件,您可以通过钉钉的回调接口来接收和处理按钮的点击事件。在发送卡片时,可以指定回调的URL,当用户点击按钮时,钉钉会向该URL发送回调通知,您可以根据回调通知进行相应的业务处理。
钉钉互动卡片是一种在群聊中展示丰富内容和交互操作的消息类型。它具有以下属性:
msgtype
:消息类型,固定为"interactive"。card_type
:互动卡片的类型,可以是"action_card"(按钮式)或"feed_card"(图文式)。title
:卡片的标题,通常用于展示主要内容。content
:卡片的正文内容,可以包含文字、链接等信息。buttons
:按钮列表,用于用户点击后触发相应的操作。card_url
:卡片的跳转链接,点击卡片将打开此链接。发送钉钉互动卡片可以通过调用钉钉开放平台的消息发送接口实现,在请求参数中指定对应的属性信息即可。
更新钉钉互动卡片可以通过发送一个新的互动卡片消息来替换之前的卡片。每次发送新的卡片消息都会覆盖之前的消息内容。
控制回调可以通过设置按钮的params
属性来实现。在按钮的params
字段中,可以指定url
和callback_id
。当用户点击按钮时,钉钉会回调预设的url
并附带callback_id
作为参数。应用服务器可以根据callback_id
进行识别和处理,并返回相应的结果。
需要注意的是,具体的属性和用法可能会根据钉钉的更新迭代而有所变化。在开发过程中,建议参考钉钉开放平台的相关文档和接口说明,以了解最新的属性和操作方式。
钉互动卡片主要有以下属性和功能:
属性
title - 标题
subtitle - 副标题
brief - 摘要
imageUrl - 卡片图片
button - 按钮,包括 text(文本)和actionURL(点击跳转URL)
rich - 文本块,包括标题、内容、图片等
form - 表单,包括输入框和选项
功能
发送:通过OA消息API发布卡片到一个或多个对象(用户/部门)
更新:指定card_id调用卡片API,更新卡片的内容
关闭:调用卡片API,关闭card_id指定的卡片
回调:
表单提交回调 - 记录表单数据的变化
点击按钮回调 - 当用户点击卡片上的按钮时回调
过期自动关闭回调 - 用户在指定时间内未操作卡片自动关闭时回调
控制回调
可以通过设置回调方式来控制卡片:
json
Copy
{
"callback": {
"card_url": "url", # 表单提交回调URL
"button_action": "url", # 按钮点击回调URL
"expired_time": 600 # 过期时间(秒)
}
}
发送卡片时指定回调URL,即可实现相应的行为控制。
比如:
表单提交回调URL接收表单内容,处理相关业务逻辑
按钮点击回调URL可以跳转到指定页面
过期时间后,自动调用过期回调
互动卡片的属性包括发送人、接收人、卡片标题、卡片内容、卡片按钮等。可以通过调用API接口来发送、更新和控制回调互动卡片。具体包括:发送互动卡片、更新互动卡片、注册互动卡片回调地址、人与人会话中机器人发送互动卡片等。此回答整理自钉群“钉钉开发者社区(互助群)”