詳細介紹可參考釘釘官方文檔 https://developers.dingtalk.com/document/robots/custom-robot-access
釘釘自定義機器人介紹及調用代碼請見 https://www.cnblogs.com/howardzhangdqs/p/dingtalk_robot_instruction_1.html
消息類型
釘釘支持 文本 (text
)、鏈接 (link
)、markdown
、ActionCard
、FeedCard
五種格式
text
類型消息
{
"text": {
"content":"消息內容(記得在此處加上自定義的關鍵字)"
},
"msgtype":"text"
}
注:text
類型消息 支持 @群成員,具體見關於@群成員
link
類型消息
{
"msgtype": "link",
"link": {
"text": "消息內容(如果太長則會只顯示部分並以省略號結尾)",
"title": "消息標題(記得在此處加上自定義的關鍵字)",
"picUrl": "要展示的圖片URL",
"messageUrl": "點擊消息跳轉的URL"
}
}
markdown
類型消息
{
"msgtype": "markdown",
"markdown": {
"title":"會話展示內容(不會顯示在消息中,記得在此處加上自定義的關鍵字)",
"text": "markdown格式的消息"
}
}
具體釘釘支持的markdown
類型在https://www.cnblogs.com/howardzhangdqs/p/dingtalk_robot_instruction_3.html一文中有介紹
ActionCard
類型消息
整體跳轉ActionCard
類型消息
{
"actionCard": {
"title": "會話展示內容(不會顯示在消息中,記得在此處加上自定義的關鍵字)",
"text": "markdown格式的消息",
"singleTitle" : "底部按鈕的標題",
"singleURL" : "點擊按鈕后跳轉的的URL"
},
"msgtype": "actionCard"
}
獨立跳轉ActionCard
類型消息
{
"actionCard": {
"title": "會話展示內容(不會顯示在消息中,記得在此處加上自定義的關鍵字)",
"text": "markdown格式的消息",
"btnOrientation": "0或1 0:按鈕豎直排列; 1:按鈕橫向排列",
"btns": [
{
"title": "按鈕1",
"actionURL": "點擊按鈕1后跳轉的的URL"
},
{
"title": "按鈕2",
"actionURL": "點擊按鈕2后跳轉的的URL"
}
]
},
"msgtype": "actionCard"
}
具體釘釘支持的markdown
類型在https://www.cnblogs.com/howardzhangdqs/p/dingtalk_robot_instruction_3.html一文中有介紹
markdown
類型消息
該類型類似link
類型,但可以有多條link
堆疊在一起
{
"msgtype":"feedCard",
"feedCard": {
"links": [
{
"title": "link1(記得在此處加上自定義的關鍵字)",
"messageURL": "點擊link1后跳轉的的URL",
"picURL": "link1使用配圖"
},
{
"title": "link2(記得在此處加上自定義的關鍵字)",
"messageURL": "點擊link1后跳轉的的URL",
"picURL": "link2使用配圖"
}
]
}
}
關於@群成員
在最外層花括號內加入以下代碼即可@相應的群成員:
"at": {
"atMobiles":["被@人的手機號"],
"atUserIds":["被@人的用戶userid"],
"isAtAll": true 或 false
},
如以下代碼會@電話為11451419198
和釘釘號為dingtalksb
的用戶並且不會@所有人:
{
"at": {
"atMobiles":[
"11451419198"
],
"atUserIds":[
"dingtalksb"
],
"isAtAll": false
},
"text": {
"content":"你們的電話和釘釘號有問題!"
},
"msgtype":"text"
}
注:
- 被@人的手機號 和 被@人的用戶userid 如非群內成員則會被自動過濾
isAtAll
為 是否@所有人,如要 @所有人 則為"isAtAll": true
,反之用"isAtAll": false