禪道集成釘釘工作消息通知

禪道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的設置,綁定的用戶就可以在釘釘裏接收到禪道里與該用戶相關的消息。

例如以下的工作通知。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章