在钉钉的Webhook方式中,文本、链接、Markdown、整体跳转ActionCard和独立跳转ActionCard都需要哪些必填参数?
在钉钉的Webhook方式中,不同类型的消息所需的必填参数不同。以下是文本、链接、Markdown、整体跳转ActionCard和独立跳转ActionCard所需的必填参数:
文本类型消息
文本类型消息是最简单的一种消息类型,只包含一段文本内容。在发送文本类型消息时,需要以下必填参数:
msgtype: 消息类型,固定为text;
text: 文本消息内容,最长不超过2048个字节。
链接类型消息
链接类型消息可以包含一个标题、一段描述和一个URL链接。在发送链接类型消息时,需要以下必填参数:
msgtype: 消息类型,固定为link;
title: 消息标题,最长不超过128个字节;
text: 消息描述,最长不超过2048个字节;
messageUrl: 点击消息跳转的URL链接,最长不超过2048个字节。
Markdown类型消息
Markdown类型消息可以使用Markdown语法来格式化消息内容。在发送Markdown类型消息时,需要以下必填参数:
msgtype: 消息类型,固定为markdown;
title: 首屏会话透出的展示内容,最长不超过128个字节;
text: Markdown格式的消息内容,最长不超过4096个字节。
整体跳转ActionCard类型消息
整体跳转ActionCard类型消息可以包含一个标题、一段描述和一个按钮,点击按钮可以跳转到一个URL链接。在发送整体跳转ActionCard类型消息时,需要以下必填参数:
msgtype: 消息类型,固定为actionCard;
title: 消息标题,最长不超过128个字节;
text: 消息描述,最长不超过2048个字节;
singleTitle: 按钮标题,最长不超过16个字节;
singleURL: 点击按钮跳转的URL链接,最长不超过2048个字节。
独立跳转ActionCard类型消息
独立跳转ActionCard类型消息可以包含一个标题、一段描述和多个按钮,点击每个按钮可以跳转到一个不同的URL链接。在发送独立跳转ActionCard类型消息时,需要以下必填参数:
msgtype: 消息类型,固定为actionCard;
title: 消息标题,最长不超过128个字节;
text: 消息描述,最长不超过2048个字节;
btnOrientation: 按钮排列的方向,可选值为0(竖直排列)或1(横向排列);
btns: 按钮列表,最多包含4个按钮,每个按钮需要包含两个参数:
title: 按钮标题,最长不超过16个字节;
actionURL: 点击按钮跳转的URL链接,最长不超过2048个字节。
在钉钉的Webhook方式中,你可以使用以下几种方式发送消息:
text
类型的消息,可以发送简单的文本内容。例如:{
"msgtype": "text",
"text": {
"content": "这是一条文本消息"
}
}
link
类型的消息,可以发送带有标题、描述和链接的消息。例如:{
"msgtype": "link",
"link": {
"title": "这是一个链接消息",
"text": "点击查看详情",
"messageUrl": "https://example.com"
}
}
markdown
类型的消息,可以发送支持Markdown语法的消息。例如:{
"msgtype": "markdown",
"markdown": {
"title": "这是一个Markdown消息",
"text": "# 标题\n\n- 列表项1\n- 列表项2\n\n[链接文本](https://example.com)"
}
}
actionCard
类型的消息,可以以整体跳转的方式展示消息,并包含一个按钮。例如:{
"msgtype": "actionCard",
"actionCard": {
"title": "这是一个整体跳转ActionCard",
"text": "点击按钮进行跳转",
"singleTitle": "跳转按钮",
"singleURL": "https://example.com"
}
}
actionCard
类型的消息,可以以独立跳转的方式展示消息,并包含多个按钮供用户选择。例如:{
"msgtype": "actionCard",
"actionCard": {
"title": "这是一个独立跳转ActionCard",
"text": "请选择要进行的操作",
"btnOrientation": "1",
"btns": [
{
"title": "按钮1",
"actionURL": "https://example.com/1"
},
{
"title": "按钮2",
"actionURL": "https://example.com/2"
}
]
}
}
以上是钉钉Webhook方式中常用的几种消息类型及其对应的示例。根据你的需求,选择相应的消息类型和参数来发送消息。
在Webhook方式中,无论是文本、链接、Markdown、整体跳转ActionCard还是独立跳转ActionCard,都需要填写msgtype参数,并且文本和Markdown类型需要填写text或markdown参数,链接类型需要填写link参数,整体跳转ActionCard类型需要填写singleTitle和singleURL参数,独立跳转ActionCard类型需要填写btns参数。其他参数根据需求选择填写。—此回答来自钉群“钉钉开发者社区(互助群)”
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。