禪道11.7版本開始,webhook支持集成釘釘工作消息通知。
這樣在釘釘裏,該用戶就可以收到禪道里與自己相關的信息的工作通知,可以多一個渠道去通知用戶禪道的信息動向。
在禪道後臺--通知--webhook添加時,可以添加“釘釘工作消息通知”類型的webhook,之前“釘釘”類型的webhook改爲“釘釘羣通知機器人”。
下面我們來介紹“釘釘工作消息通知”類型的webhook的添加和使用。
一、“釘釘工作消息通知”類型的webhook的添加頁面
添加頁面,我們需要獲取到釘釘AgentId,釘釘AppKey,釘釘AppSecret。這些信息需要註冊登錄釘釘的 開放平臺,添加應用獲取。
二、註冊登錄釘釘開放平臺,創建應用
釘釘開發平臺: https://open-dev.dingtalk.com。
2.1 創建應用
2.2 填寫應用的基本信息
按照提示和要求填寫應用的基本信息,帶紅色星號的都是必填項。
填寫完成點擊下一步即可。
2.3 獲取釘釘AgentId,釘釘AppKey,釘釘AppSecret
應用確定創建完成後,下一步我們就可以直接進入到應用詳情頁,查看到應用憑證:AgentId、AppKey、AppSecret。
也可以從小程序頁面,點擊應用後再進入到應用詳情頁查看。
2.4 填寫應用配置開發信息
在小程序詳情頁中,切換到第二個標籤“開發管理”,即可看到服務器出口IP的信息,點擊右側的修改按鈕,即可進入編輯頁面。
輸入服務器出口IP,請填寫禪道所在服務器的外網IP。且這個IP在釘釘的開放平臺中,沒有被使用過,一個應用對應一個IP。
填寫完成後點擊保存即可。
三、在禪道中,輸入釘釘的AgentId、AppKey和AppSecret
3.1 把釘釘AgentId,釘釘AppKey,釘釘AppSecret信息複製粘貼到禪道後臺。
禪道後臺--通知--webhook的“釘釘工作消息通知類型”的添加頁面裏。
3.2 同步和綁定用戶
需要特別提醒的是:創建“釘釘工作消息通知”類型的應用後,因爲還需要同步和綁定用戶。
把禪道用戶和釘釘用戶做綁定,需要到“權限管理”裏開通通訊錄只讀權限,獲取企業員工的通訊錄數據的權限。
權限管理頁面中,默認勾選的範圍是全部員工,如果只需要部分員工的,可以選擇部分員工,點擊授權部門右側的添加按鈕可進行選擇。
四、釘釘工作消息通知的webhook的使用
應用添加成功後,我們就可以具體的使用了。
首先,我們需要點擊“綁定用戶”按鈕,進行用戶的同步和關聯。
綁定用戶之前,需要登錄到釘釘( https://oa.dingtalk.com/contacts.htm),點擊“通訊錄管理”,錄入公司部門及成員信息。
需要特別提醒的是:釘釘中添加應用的人員設置中的開發人員需要有通訊錄管理權限。
綁定用戶頁面:
- 已綁定的用戶不會顯示到釘釘Userid列表裏;
- 可以解除綁定的用戶;
- 可以修改綁定的用戶。
用戶綁定成功後,根據禪道後臺--通知--設置--webhook的設置,綁定的用戶就可以在釘釘裏接收到禪道里與該用戶相關的消息。
例如以下的工作通知。