簡介
我們在使用釘釘?shù)臅r候晒衩，有時候會需要向員工發(fā)送很多日常打卡消息或者業(yè)務(wù)預(yù)警嗤瞎，這個時候墙歪，我們就可以利用釘釘?shù)娜簷C器人功能，可以大幅提高效率猫胁。
先注冊一個機器人到群里
1.打開釘釘電腦版
2.選擇需要添加機器人的群聊箱亿，然后依次單擊群設(shè)置 > 智能群助手。
3.在機器人管理頁面選擇自定義機器人弃秆，輸入機器人名字并選擇要發(fā)送消息的群届惋，同時可以為機器人設(shè)置機器人頭像。
4.完成必要的安全設(shè)置（點擊查看更多安全設(shè)置）菠赚，至少一項脑豹，勾選我已閱讀并同意《自定義機器人服務(wù)及免責(zé)條款》，然后單擊完成衡查。
5.完成安全設(shè)置后俱饿，復(fù)制出機器人的Webhook地址，可用于向這個群發(fā)送消息塌忽，格式如下：
https://oapi.dingtalk.com/robot/send?access_token=XXXXXX
注意
請保管好此Webhook 地址拍埠，不要公布在外部網(wǎng)站上，泄露后有安全風(fēng)險土居。
請保管好此Webhook 地址枣购，不要公布在外部網(wǎng)站上，泄露后有安全風(fēng)險擦耀。
請保管好此Webhook 地址棉圈，不要公布在外部網(wǎng)站上，泄露后有安全風(fēng)險眷蜓。
實現(xiàn)方法： 使用curl命令
1.發(fā)送簡單文字消息 text類型
在任意Linux或macOS或支持curl的設(shè)備上運行這個命令
curl '這里替換成你剛剛得到的Webhook地址' \ -H 'Content-Type: application/json' \ -d '{"msgtype": "text","text": {"content":"這里替換成你要發(fā)送的消息"}}'
發(fā)送完成后分瘾，正常情況下會返回200代碼和ok字樣
更多text類型消息的參數(shù)請參見這種圖片
2.發(fā)送一個鏈接 link類型
還是一樣在支持curl的設(shè)備上運行這個命令
curl '這里替換成你剛剛得到的Webhook地址' \ -H 'Content-Type: application/json' \ -d { ? ? "msgtype": "link", ? ? "link": { ? ? ? ? "text": "這里可以寫一段對于鏈接的簡介", "title": "鏈接標(biāo)題，可自定義", ? ? ? ? "picUrl": "如果有鏈接截圖或圖標(biāo)請在這里填寫圖片地址", ? ? ? ? "messageUrl": "鏈接地址寫在這里" ? ? } }
參數(shù)要求請參見下圖
3.發(fā)送一條圖文消息 markdown類型
示例命令如下：
curl '這里替換成你剛剛得到的Webhook地址' \ -H 'Content-Type: application/json' \ -d { ? ? "msgtype": "markdown", ? ? "markdown": { ? ? ? ? "title":"杭州天氣", ? ? ? ? "text": "#### 杭州天氣 @150XXXXXXXX \n > 9度吁系，西北風(fēng)1級芹敌，空氣良89，相對溫度73%\n > \n > ###### 10點20分發(fā)布 [天氣](https://www.dingtalk.com) \n" ? ? }, ? ? ? "at": { ? ? ? ? ? "atMobiles": [ ? ? ? ? ? ? ? "150XXXXXXXX" ? ? ? ? ? ], ? ? ? ? ? "atUserIds": [ ? ? ? ? ? ? ? "user123" ? ? ? ? ? ], ? ? ? ? ? "isAtAll": false ? ? ? } }
效果就是這樣的
目前只支持markdown語法的子集垮抗，具體支持的元素如下：
標(biāo)題
# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題
引用
> A man who stands for nothing will fall for anything.
文字加粗、斜體
**bold**
*italic*
鏈接? ? [this is a link](http://name.com)
圖片? ? 
無序列表
- item1
- item2
有序列表
1. item1
2. item2
還有參數(shù)要求在這兒
4.卡片 整體跳轉(zhuǎn)ActionCard類型
示例命令如下：
curl '這里替換成你剛剛得到的Webhook地址' \ -H 'Content-Type: application/json' \ -d { ? ? "actionCard": { ? ? ? ? "title": "喬布斯 20 年前想打造一間蘋果咖啡廳碧聪，而它正是 Apple Store 的前身", ? ? ? ? "text": " ### 喬布斯 20 年前想打造的蘋果咖啡廳 Apple Store 的設(shè)計正從原來滿滿的科技感走向生活化冒版，而其生活化的走向其實可以追溯到 20 年前蘋果一個建立咖啡館的計劃", ? ? ? ? "btnOrientation": "0", ? ? ? ? "singleTitle" : "閱讀全文", ? ? ? ? "singleURL" : "https://www.dingtalk.com/" ? ? }, ? ? "msgtype": "actionCard" }
效果如下：
參數(shù)要求請參見下圖：
5.卡片 獨立跳轉(zhuǎn)ActionCard類型
示例代碼如下：
curl '這里替換成你剛剛得到的Webhook地址' \ -H 'Content-Type: application/json' \ -d { ? ? "msgtype": "actionCard", ? ? "actionCard": { ? ? ? ? "title": "我 20 年前想打造一間蘋果咖啡廳，而它正是 Apple Store 的前身", ? ? ? ? "text": " \n\n #### 喬布斯 20 年前想打造的蘋果咖啡廳 \n\n Apple Store 的設(shè)計正從原來滿滿的科技感走向生活化逞姿，而其生活化的走向其實可以追溯到 20 年前蘋果一個建立咖啡館的計劃", ? ? ? ? "btnOrientation": "0", ? ? ? ? "btns": [ ? ? ? ? ? ? { ? ? ? ? ? ? ? ? "title": "內(nèi)容不錯", ? ? ? ? ? ? ? ? "actionURL": "https://www.dingtalk.com/" ? ? ? ? ? ? }, ? ? ? ? ? ? { ? ? ? ? ? ? ? ? "title": "不感興趣", ? ? ? ? ? ? ? ? "actionURL": "https://www.dingtalk.com/" ? ? ? ? ? ? } ? ? ? ? ] ? ? } }
使用這種類型可以做到以下效果辞嗡，效果圖：
參數(shù)要求如下：
6.類似文章推送 FeedCard類型
示例代碼如下：
curl '這里替換成你剛剛得到的Webhook地址' \ -H 'Content-Type: application/json' \ -d { ? ? "msgtype":"feedCard", ? ? "feedCard": { ? ? ? ? "links": [ ? ? ? ? ? ? { ? ? ? ? ? ? ? ? "title": "時代的火車向前開1", ? ? ? ? ? ? ? ? "messageURL": "https://www.dingtalk.com/", ? ? ? ? ? ? ? ? "picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png" ? ? ? ? ? ? }, ? ? ? ? ? ? { ? ? ? ? ? ? ? ? "title": "時代的火車向前開2", ? ? ? ? ? ? ? ? "messageURL": "https://www.dingtalk.com/", ? ? ? ? ? ? ? ? "picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png" ? ? ? ? ? ? } ? ? ? ? ] ? ? } }
使用這種類型可以做到以下效果捆等，見下圖：
參數(shù)要求：
就這么幾種類型了，大家可以自行挖掘续室，最后附上常見錯誤代碼：
// 消息內(nèi)容中不包含任何關(guān)鍵詞 { ? "errcode":310000, ? "errmsg":"keywords not in content" }
// timestamp 無效 { ? "errcode":310000, ? "errmsg":"invalid timestamp" }
// 簽名不匹配 { ? "errcode":310000, ? "errmsg":"sign not match" }
// IP地址不在白名單 { ? "errcode":310000, ? "errmsg":"ip X.X.X.X not in whitelist" }
參考資料：
1.釘釘自定義機器人開放文檔：
https://open.dingtalk.com/document/group/custom-robot-access
2.釘釘機器人安全設(shè)置開放文檔：
https://open.dingtalk.com/document/robots/customize-robot-security-settings
3.釘釘機器人消息鏈接說明：
https://open.dingtalk.com/document/orgapp-server/message-link-description
