資訊專欄INFORMATION COLUMN
摘要：目前釘釘機(jī)器人支持方式，仍屬于內(nèi)側(cè)階段。方式是指被動(dòng)接受通知，釘釘群中添加的群機(jī)器人默認(rèn)都是該模式。截止撰寫文章時(shí)，釘釘?shù)臋C(jī)器人文檔不可訪問，所以會(huì)在下面介紹下。本文同步發(fā)表于作者博客從零開始打造專屬釘釘機(jī)器人
官方定義如下：
群機(jī)器人是釘釘群的高級(jí)擴(kuò)展功能。群機(jī)器人可以將第三方服務(wù)的信息聚合到群聊中，實(shí)現(xiàn)自動(dòng)化的信息同步。目前，大部分機(jī)器人在添加后，還需要進(jìn)行Webhook配置，才可正常使用(配置說明詳見操作流程中的幫助鏈接)。例如：
通過聚合GitHub，GitLab等源碼管理服務(wù)，實(shí)現(xiàn)源碼更新同步。
通過聚合Trello，JIRA等項(xiàng)目協(xié)調(diào)服務(wù)，實(shí)現(xiàn)項(xiàng)目信息同步。
另外，群機(jī)器人支持Webhook協(xié)議的自定義接入，支持更多可能性，例如：你可將運(yùn)維 報(bào)警通過自定義機(jī)器人聚合到釘釘群實(shí)現(xiàn)提醒功能。
實(shí)際上，通過機(jī)器人我們可以對接各類服務(wù)，比如源碼提交通知，服務(wù)器告警通知，甚至是可以主動(dòng)查詢天氣、加班點(diǎn)餐等服務(wù)。
目前釘釘機(jī)器人支持incoming方式，outgoing仍屬于內(nèi)側(cè)階段。官方文檔可以點(diǎn)此查看。
incoming方式incoming是指被動(dòng)接受通知，釘釘群中添加的群機(jī)器人默認(rèn)都是該模式。
添加機(jī)器人我們添加的時(shí)候可以看到已經(jīng)自帶一些常見的機(jī)器人，比較推薦的是GitHub、GitLab、JIRA、Travis、Trello，當(dāng)然我們這次需要選擇最后的"自定義"機(jī)器人。
在機(jī)器人信息欄填寫"機(jī)器人姓名"即可，需要的話也可以設(shè)置一個(gè)頭像。圖中"是否開啟Outgoing機(jī)制"在沒有開通的情況下是不可見。
點(diǎn)擊完成就會(huì)生成hook地址，如下圖：
我們會(huì)用到"Hook地址"，后面我們發(fā)送消息都需要請求到該地址。
如何發(fā)送消息只要想Webhook地址發(fā)起POST請求，帶上特定格式消息即可。
具體的接口文檔可以看官方，這里不做擴(kuò)展。
開源工具在一些簡單的通知場景，我們可以使用npm上面的輪子來快速實(shí)現(xiàn)。
dingtalk-robot
dingtalk-robot-sender
outgoing方式outgoing機(jī)器人的配置和前面基本一樣，只需要額外配置POST 地址以及Token。
需要注意的是Token保存后無法再次修改，POST 地址就是釘釘機(jī)器人接受消息后調(diào)用的地址。
開通方式釘釘上加入"釘釘機(jī)器人交流群"，群號(hào):11733391
在 https://open-dev.dingtalk.com 首頁上找到corpId
記得添加"大柚"，并把coprId私發(fā)給他。
目前每周四提交開通，預(yù)計(jì)周五會(huì)生效。如何收取消息
當(dāng)群里有人@機(jī)器人時(shí)，釘釘會(huì)通過POST方式回調(diào)我們前面設(shè)置的地址，該地址實(shí)質(zhì)是接口，可以在Body中獲取到消息內(nèi)容。
截止撰寫文章時(shí)，釘釘?shù)?b>outgoing機(jī)器人文檔不可訪問，所以會(huì)在下面介紹下。
釘釘請求格式HTTP Header 格式如下：
"Content-Type": "application/json; charset=utf-8" "token": "6a71a455ffcfba92a66"
HTTP Body 文本消息內(nèi)容：
{
// 會(huì)話id
"conversationId": "8Yu7H8H8890kkl7h==",
"atUsers": [
{
"dingtalkId": "$:DFDS51:$R7E8dffdufdfjsdf2/oUCO/"
}
],
"chatbotUserId": "$:df3234:$sdfsdfsdfsdfd234234/oUCO/",
"msgId": "msg4sdf35jh8jc9b51ss6/noYdzw==",
"senderNick": "Neo",
"isAdmin": false,
"sessionWebhookExpiredTime": 1561711409165,
// 消息發(fā)送的時(shí)間
"createAt": 1561710209132,
// 群聊消息類型還是單聊
"conversationType": "2",
"senderId": "$:ASDD_v1:$df8sdfj&JS*J#FF==",
// 當(dāng)類型是群聊時(shí)，這個(gè)參數(shù)有效
"conversationTitle": "avalon",
"isInAtList": true,
// sessionWebhook是臨時(shí)的發(fā)送消息接口
"sessionWebhook": "https://oapi.dingtalk.com/robot/sendBySession?session=qwe",
// 消息內(nèi)容
"text": {
"content": "我就是我, 是不一樣的煙火"
},
// 消息類型
"msgtype": "text",
}
HTTP 響應(yīng)格式
支持返回文本、圖片和markdown，actionCard，feedCard消息類型。
下面僅列出markdown格式的消息，詳細(xì)的文件可以參考網(wǎng)友提供的PDF，提取碼: 4qht 。
{
"msgtype": "markdown", // 消息類型
"markdown": {
"title":"杭州天氣", // 消息主題
"text": "#### 杭州天氣 @ptt6gbq @17681800905
" +
"> 9度，西北風(fēng)1級(jí)，空氣良89，相對溫度73%
" +
"> 
" +
"> ###### 10點(diǎn)20分發(fā)布 [天氣](http://www.thinkpage.cn/)
" // 消息體
},
"at": { // @的人員
"atMobiles": [
"17681800905"
],
"atDingtalkIds": [
"ptt6gbq"
],
"isAtAll": false
}
}
如果我們回復(fù)的消息需要@某人，就會(huì)配置at字段，里面atDingtalkIds需要的dingtaklId可以是我們從請求中拿到的senderId，即$:ASDD_v1:$k8DFJ837349On my way!==的形式也可以傳入正常@。
另外如果出于某些原因，無法響應(yīng)請求時(shí)返回消息，我們還可以通過sessionWebhook來主動(dòng)發(fā)送消息。
本文同步發(fā)表于作者博客: 從零開始打造專屬釘釘機(jī)器人
文章版權(quán)歸作者所有，未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址：http://systransis.cn/yun/106879.html
摘要：釘釘釘釘是阿里巴巴集團(tuán)專為中國企業(yè)打造的免費(fèi)溝通和協(xié)同的多端平臺(tái)，提供版，版和手機(jī)版，支持手機(jī)和電腦間文件互傳。 1：@teamhttps://www.atteam.cn/項(xiàng)目協(xié)作管理，越復(fù)雜越有序，足夠簡單足夠有效，@Team針對企業(yè)團(tuán)隊(duì)協(xié)作所遇到的困境而研發(fā)的新一代基于云服務(wù)的企業(yè)級(jí)協(xié)同工作平臺(tái)，通過為每個(gè)企業(yè)或團(tuán)隊(duì)提供專屬的私密網(wǎng)絡(luò)空間和全新的協(xié)作方式，幫助企業(yè)實(shí)現(xiàn)高效便捷的跨部...
摘要：自阮大神的文章發(fā)布以來，有了一些改動(dòng)，添加有很多有用的功能，特別是這個(gè)功能，對打造命令行工具集合非常有用，所以寫一個(gè)新版本的教程還是有必要的。 前言 使用命令行程序?qū)Τ绦騿T來說很常見，就算是前端工程師或者開發(fā)gui的，也需要使用命令行來編譯程序或者打包程序 熟練使用命令行工具能極大的提高開發(fā)效率，linux自帶的命令行工具都非常的有用，但是這些工具都是按照通用需求開發(fā)出來的，如果有一些...
摘要：摘要在剛剛結(jié)束的上海云棲大會(huì)飛天技術(shù)匯分論壇上，阿里云視頻云產(chǎn)品架構(gòu)師羅小飛進(jìn)行了阿里云面向金融政企的最佳實(shí)踐主題分享，為上海的嘉賓介紹的解決方案與技術(shù)服務(wù)體系。隨后，年阿里云宣布全面降價(jià)，打破了行業(yè)原有的價(jià)格不透明一客一價(jià)的模式。 摘要：?在剛剛結(jié)束的上海云棲大會(huì)飛天技術(shù)匯分論壇上，阿里云視頻云產(chǎn)品架構(gòu)師羅小飛進(jìn)行了《阿里云CDN——面向金融政企的CDN最佳實(shí)踐》主題分享，為上海的嘉...
摘要：摘要在剛剛結(jié)束的上海云棲大會(huì)飛天技術(shù)匯分論壇上，阿里云視頻云產(chǎn)品架構(gòu)師羅小飛進(jìn)行了阿里云面向金融政企的最佳實(shí)踐主題分享，為上海的嘉賓介紹的解決方案與技術(shù)服務(wù)體系。隨后，年阿里云宣布全面降價(jià)，打破了行業(yè)原有的價(jià)格不透明一客一價(jià)的模式。 摘要：?在剛剛結(jié)束的上海云棲大會(huì)飛天技術(shù)匯分論壇上，阿里云視頻云產(chǎn)品架構(gòu)師羅小飛進(jìn)行了《阿里云CDN——面向金融政企的CDN最佳實(shí)踐》主題分享，為上海的嘉...
摘要：為了滿足在更多復(fù)雜場景科研攻堅(jiān)時(shí)，對于超高性能算力高速網(wǎng)絡(luò)傳輸海量數(shù)據(jù)存儲(chǔ)的更高需求，再次發(fā)力，于近日推出了為科研量身定制的新一代超算產(chǎn)品，并將正式更名為云極高性能計(jì)算以下簡稱?？蒲惺强萍紕?chuàng)新的基礎(chǔ)，而高性能計(jì)算則是科研的基石。隨著數(shù)字化走向縱深，科研教育進(jìn)入信息化時(shí)代。在科研項(xiàng)目的推進(jìn)過程中，往往會(huì)面對復(fù)雜的數(shù)據(jù)密集型計(jì)算任務(wù)，例如仿真、數(shù)據(jù)建模、渲染等大量運(yùn)算場景。此時(shí)如果使用單一的通用...
閱讀 783·2023-04-25 20:47
閱讀 2550·2019-08-30 15:53
閱讀 959·2019-08-26 14:05
閱讀 903·2019-08-26 11:59
閱讀 1692·2019-08-26 11:43
閱讀 1693·2019-08-26 10:57
閱讀 1366·2019-08-23 18:23
閱讀 2683·2019-08-23 12:57
