*釘釘*是阿里集團專為中國企業打造的通訊、協同的免費移動辦公平臺，幫助企業內部溝通和商務溝通更加高效安全。

> 產品官網：[https://www.dingtalk.com/](https://www.dingtalk.com/)
> 連接器地址：[http://www.xmfmdq.com/apps/app/10007](http://www.xmfmdq.com/apps/app/10007)

## 一、應用授權

釘釘應用連接器賬號授權方式為 APPTOKEN，需要具有釘釘企業管理權限的賬戶前往后臺配置應用，并同時將相關信息填入數環通釘釘應用連接器的授權賬戶信息中。

### 1.前往釘釘企業管理后臺

后臺地址：[https://open-dev.dingtalk.com](https://open-dev.dingtalk.com/)，使用釘釘企業管理員賬號掃碼或手機號登陸；

![1655175046095.jpg](/media/202307/2023-07-21_1203300.4189093479254328.png "1655175046095.jpg")

### 2.創建企業內部應用

創建企業內部應用地址：[https://open-dev.dingtalk.com/fe/app#/corp/app](https://open-dev.dingtalk.com/fe/app#/corp/app)，點擊創建應用，選擇 H5 應用，如下圖：

![image.png](/media/202307/2023-07-21_1203300.7778437713343364.png "image.png")

![image.png](/media/202307/2023-07-21_1203300.9994446991628477.png "image.png")

### 3. 賬號授權信息填寫

**釘釘應用 APPKEY：** 在創建好的應用詳情里可查看，如下圖：

![image.png](/media/202307/2023-07-21_1203300.45553466462455483.png "image.png")

**釘釘應用 Agentid：** 在創建好的應用詳情里可查看，如下圖：

![image.png](/media/202307/2023-07-21_1203300.6635462606521356.png "image.png")

**釘釘應用秘鑰 APPSecret：** 在創建好的應用詳情里可查看，如下圖：

![image.png](/media/202307/2023-07-21_1203300.6581340553507103.png "image.png")

到首頁復制 [corpid]

![1660892873352.jpg](/media/202307/2023-07-21_1203320.23454181599230728.png "1660892873352.jpg")

**事件訂閱加密 aes_key 與事件訂閱簽名 token：** 在釘釘開放平臺左側點擊[事件與回調]，進入頁面，點擊重置后生成，復制內容至數環通，如下：

![image.png](/media/202307/2023-07-21_1203310.2770270963444921.png "image.png")![image.png](/media/202307/2023-07-21_1203310.5148889261208192.png "image.png")

最后，將創建成功后的應用相關信息，填入數環通釘釘應用連接器的賬號授權里，如下：

![1665992407645.jpg](/media/202307/2023-07-21_1203310.19919427152826075.png "1665992407645.jpg")

**請求網址：** 將數環通生成的請求網址復制輸入到釘釘開放平臺-事件請閱的請求網址處，點擊保存，如下：

![image.png](/media/202307/2023-07-21_1203310.5850717935400024.png "image.png")

由于釘釘授權比較特殊，需在釘釘開放平臺創建的應用左側，進入權限管理，將個人權限、通訊錄權限、OA 權限、考勤、消息通知等全部權限逐一開通，操作如下：

![image.png](/media/202307/2023-07-21_1203320.4531996422401471.png "image.png")

![1659517523165.jpg](/media/202307/2023-07-21_1203310.5541097311915163.png "1659517523165.jpg")

## 二、抖音支持動作

### 觸發器

當前釘釘應用連接器的觸發器如下：

* 當有員工加入群時；
* 當有員工主動退群時；
* 當審批實例開始時；
* 當審批實例結束時；
* 當審批任務開始時；
* 當審批任務轉交時；
* 當審批任務結束時；
* 當員工打卡時；
* 當員工加班時。

### 動作執行器

當前釘釘應用連接器的動作執行器如下：

* 創建群會話
* 查詢部門用戶列表
* 發起待辦事項
* 查詢員工詳情
* 創建審批實例
* 更新審批模板
* 查詢審批實例詳情
* 查詢審批模板詳情
* 查詢審批模板列表
* 查詢部門列表
* 查詢群會話信息
* 執行審批操作
* 發送工作通知
* 查詢審批實例 ID 列表
* 動態創建字段
* 創建知識庫
* 創建文檔

詳細可參考：[http://www.xmfmdq.com/apps/app/10007](http://www.xmfmdq.com/apps/app/10007)

## 三、應用示例

* **簡道云+釘釘** ：當簡道云有數據修改時，給員工，發送釘釘工作通知。
* **金山表單+釘釘** ：當有新的數據收集時發送到釘釘工作群

釘釘（自建應用）