如何发送markdown消息并展示在钉钉会话中?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
要发送Markdown消息并在钉钉会话中展示,您可以使用钉钉开放平台的消息发送接口,并在消息内容中使用Markdown格式。以下是一般情况下发送Markdown消息的步骤:
首先,确保您已经完成了钉钉开放平台的接入和权限验证,并获得了相应的访问令牌(access_token)。
使用POST请求方式,向以下接口地址发送请求:
https://oapi.dingtalk.com/message/send?access_token=ACCESS_TOKEN
将上述URL中的ACCESS_TOKEN替换为您获取到的有效访问令牌。
在请求的Body中,传递相应的参数来指定消息的内容和格式。例如:
{
"touser": "员工UserID",
"agentid": 12345678,
"msgtype": "markdown",
"markdown": {
"title": "Markdown消息",
"text": "# 这是一条Markdown消息\n- 列表项1\n- 列表项2\n**加粗文本** *斜体文本*"
}
}
其中,"touser"为员工的用户ID,"agentid"为您在钉钉开放平台创建应用时分配的AgentID,"msgtype"指定消息类型为Markdown,"title"为消息标题,"text"为消息内容。
发送请求,并根据接口返回的结果进行处理。
群聊消息接口: robot/send
个人消息接口: topapi/message/corpconversation/send
根据需要选择相应的接口。
两种接口的调用格式基本相同,示例如下:
Copy
POST https://oapi.dingtalk.com/robot/send?access_token=XXX
access_token为机器人的全局唯一标识。
请求体参数为:
json
Copy
{
"msgtype": "markdown",
"markdown": {
"title": "消息标题",
"text": "这是带#格式的文本 #标题\n ###标题"
}
}
msgtype 设置为 markdown 表示一条markdown消息
markdown下定义了title和text,分别为:
title: 消息标题
text: markdown格式的文本内容
text支持的markdown格式有:
标题
列表
链接
图片
代码块
等等
发送此请求后,就可以在钉钉会话中查看对应的富文本消息。
最后还可以根据不同的需要,在markdown参数中定义不同的消息内容。
要发送markdown消息并展示在钉钉会话中,需要使用消息类型为"markdown",并在消息体中设置标题和内容,内容可以使用markdown语法进行格式化。消息内容最大不超过5000字符。具体接入流程可以参考钉钉提供的消息通知接口接入流程示例。此回答整理自钉群“钉钉开发者社区(互助群)”