# 企业机器人发送消息的消息类型 如果你需要了解企业机器人的可以发送的消息类型和数据格式，可以参考本文档内容。 **说明** 本文档介绍的是**企业内部应用机器人**发送消息的消息类型。 ## **数据格式** * **消息模板Key** ：消息模板Key是开发者发送消息时需要用到的一个唯一标识。它可以在编写程序代码时，能快速地指向一个事先设定好的消息模板。 * **消息模板参数**：用于在消息模板中替换预定义占位符的实际数据。例如，当你有一个\`sampleText\`消息模板Key时，此时你需要定义\`content\`字段的值。 * **示例** ：提供了企业内部应用机器人在**群内** 发送**文本类型**的 HTTP 示例代码： * 消息模板Key： \`"msgKey" : "sampleText"\` * 消息模板参数：\`"msgParam" : "{\\"content\\":\\"钉钉，让进步发生\\"}"\` 详情参考[机器人发送群聊消息](https://open.dingtalk.com/document/orgapp/the-robot-sends-a-group-message)。 ```http POST /v1.0/robot/groupMessages/send HTTP/1.1 Host:api.dingtalk.com x-acs-dingtalk-access-token: Content-Type:application/json { "msgParam" : "{\"content\":\"钉钉，让进步发生\"}", "msgKey" : "sampleText", "openConversationId" : "cid6KeBBLov********", "robotCode" : "dingue4kfzdxbyn*******" } ``` | 消息类型 | 消息模板Key | 消息模板参数 | 说明 | |---------------------|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 文本类型 |
sampleText | { "content": "xxxx" } | ![text](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1922002861/p634074.png) | | Markdown类型 | sampleMarkdown |
{ "title": "xxxx", "text": "xxxx" } | ![markdown](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1922002861/p634076.png) | | 图片类型 | sampleImageMsg | { "photoURL": "xxxx" } | ![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1922002861/p634077.png) | | 链接类型 | sampleLink |
{ "text": "消息内容测试", "title": "sampleLink消息测试", "picUrl": "@lADOADmaWMzazQKA", "messageUrl": "http://dingtalk.com" } | 链接消息。 | |
ActionCard类型 | sampleActionCard | { "title": "测试标题", "text": "内容测试", "singleTitle": "查看详情", "singleURL": "https://open.dingtalk.com" } > text 字段支持 markdown 格式 | 卡片消息：一个按钮。![一个按钮](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7903389461/p429115.png) | |
ActionCard类型 | sampleActionCard2 | { "title": "消息标题测试", "text": "消息正文测试", "actionTitle1": "一个按钮", "actionURL1": "https://www.taobao.com", "actionTitle2": "两个按钮", "actionURL2": "https://www.tmall.com" } > text 字段支持 markdown 格式 | 卡片消息：竖向二个按钮。![两个按钮竖直按钮](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7903389461/p429121.png) | |
ActionCard类型 | sampleActionCard3 | { "title": "消息标题测试", "text": "消息内容测试", "actionTitle1": "第一个按钮的文本", "actionURL1": "第一个按钮触发的url", "actionTitle2": "第二个按钮的文本", "actionURL2": "第二个按钮触发的url", "actionTitle3": "第三个按钮的文本", "actionURL3": "第三个按钮触发的url" }
| 卡片消息：竖向三个按钮。 | |
ActionCard类型 | sampleActionCard4 | { "title":"消息标题测试", "text":"消息内容测试", "actionTitle1":"第一个按钮的文本", "actionURL1":"第一个按钮触发的url", "actionTitle2":"第二个按钮的文本", "actionURL2":"第二个按钮触发的url", "actionTitle3":"第三个按钮的文本", "actionURL3":"第三个按钮触发的url", "actionTitle4":"第四个按钮的文本", "actionURL4":"第四个按钮触发的url" }
| 卡片消息：竖向四个按钮。 | |
ActionCard类型 | sampleActionCard5 | { "title":"消息标题测试", "text":"消息内容测试", "actionTitle1":"第一个按钮的文本", "actionURL1":"第一个按钮触发的url", "actionTitle2":"第二个按钮的文本", "actionURL2":"第二个按钮触发的url", "actionTitle3":"第三个按钮的文本", "actionURL3":"第三个按钮触发的url", "actionTitle4":"第四个按钮的文本", "actionURL4":"第四个按钮触发的url", "actionTitle5":"第五个按钮的文本", "actionURL5":"第五个按钮触发的url" }
| 卡片消息：竖向五个按钮。 | |
ActionCard类型 | sampleActionCard6 |
{ "title": "xxxx", "text": "xxxx", "buttonTitle1":"xxxxx", "buttonUrl1":"xxxxx", "buttonTitle2":"xxxxx", "buttonUrl2":"xxxxx" } | 卡片消息：横向二个按钮。![横向按钮](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7903389461/p429132.png) | | 语音类型 | sampleAudio | { "mediaId": "@IR_P********nFkfhsisbf4A", "duration":"xxxxx" } | 语音消息： * **mediaId** ：通过[上传媒体文件](https://open.dingtalk.com/document/orgapp/upload-media-files)接口，获取\`media_id\`参数值。 **说明** 支持ogg、amr格式。 * **duration**：语音消息时长，单位毫秒。 ![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5283366761/p563015.png) | | 文件类型 | sampleFile | { "mediaId":"@lAz*********shRs5m2pRL", "fileName":"表格.xlsx", "fileType":"xlsx", } | 文件消息： * **mediaId** ：通过[上传媒体文件](https://open.dingtalk.com/document/orgapp/upload-media-files)接口，获取\`media_id\`参数值。 * **fileName**：文件名称。 * **fileType**：文件类型。 **说明** 文件类型，支持xlsx、pdf、zip、rar、doc、docx格式。 ![image](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5283366761/p563016.png) | | 视频类型 | sampleVideo | { "duration":"999", "videoMediaId":"$iQEL**********AXNSs6QPPAAABhKN2L3EEzTcTB84BFM7iCAAJomlt", "videoType":"mp4", "picMediaId":"$igE**********tAFzQUABtoAIYQBpAtR3SICqrQ7ZX0nEJzAKxUDzwAAAYSjdi2cBM02vwcACAAJomltCgQ" }
| 视频消息： * **duration**：语音消息时长，单位秒。 * **videoMediaId** ：通过[上传媒体文件](https://open.dingtalk.com/document/orgapp/upload-media-files)接口，获取\`media_id\`参数值。 * **videoType**：视频类型，支持mp4格式。 * **picMediaId** ：视频封面图，通过[上传媒体文件](https://open.dingtalk.com/document/orgapp/upload-media-files)接口，获取\`media_id\`参数值。 * height：视频展示高度，单位px。 * width：视频展示宽度，单位px。 | ## **Markdown支持的语法** > 对于消息类型 sampleMarkdown 的markdown语法的补充说明。 ```markdown 标题 # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 引用 > A man who stands for nothing will fall for anything. 文字加粗、斜体 **bold** *italic* 链接 [this is a link](http://name.com) 图片 ![](http://name.com/pic.jpg) 无序列表 - item1 - item2 有序列表 1. item1 2. item2 换行 \n (建议\n前后分别加2个空格) ```