*釘釘*是阿里集團(tuán)專為中國(guó)企業(yè)打造的通訊、協(xié)同的免費(fèi)移動(dòng)辦公平臺(tái)，幫助企業(yè)內(nèi)部溝通和商務(wù)溝通更加高效安全。

> 產(chǎn)品官網(wǎng)：[https://www.dingtalk.com/](https://www.dingtalk.com/)
> 連接器地址：[http://www.ztnbzvn.cn/apps/app/10007](http://www.ztnbzvn.cn/apps/app/10007)

## 一、應(yīng)用授權(quán)

釘釘應(yīng)用連接器賬號(hào)授權(quán)方式為 APPTOKEN，需要具有釘釘企業(yè)管理權(quán)限的賬戶前往后臺(tái)配置應(yīng)用，并同時(shí)將相關(guān)信息填入數(shù)環(huán)通釘釘應(yīng)用連接器的授權(quán)賬戶信息中。

### 1.前往釘釘企業(yè)管理后臺(tái)

后臺(tái)地址：[https://open-dev.dingtalk.com](https://open-dev.dingtalk.com/)，使用釘釘企業(yè)管理員賬號(hào)掃碼或手機(jī)號(hào)登陸；

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

### 2.創(chuàng)建企業(yè)內(nèi)部應(yīng)用

創(chuàng)建企業(yè)內(nèi)部應(yīng)用地址：[https://open-dev.dingtalk.com/fe/app#/corp/app](https://open-dev.dingtalk.com/fe/app#/corp/app)，點(diǎn)擊創(chuàng)建應(yīng)用，選擇 H5 應(yīng)用，如下圖：

![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. 賬號(hào)授權(quán)信息填寫

**釘釘應(yīng)用 APPKEY：** 在創(chuàng)建好的應(yīng)用詳情里可查看，如下圖：

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

**釘釘應(yīng)用 Agentid：** 在創(chuàng)建好的應(yīng)用詳情里可查看，如下圖：

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

**釘釘應(yīng)用秘鑰 APPSecret：** 在創(chuàng)建好的應(yīng)用詳情里可查看，如下圖：

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

到首頁復(fù)制 [corpid]

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

**事件訂閱加密 aes_key 與事件訂閱簽名 token：** 在釘釘開放平臺(tái)左側(cè)點(diǎn)擊[事件與回調(diào)]，進(jìn)入頁面，點(diǎn)擊重置后生成，復(fù)制內(nèi)容至數(shù)環(huán)通，如下：

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

最后，將創(chuàng)建成功后的應(yīng)用相關(guān)信息，填入數(shù)環(huán)通釘釘應(yīng)用連接器的賬號(hào)授權(quán)里，如下：

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

**請(qǐng)求網(wǎng)址：** 將數(shù)環(huán)通生成的請(qǐng)求網(wǎng)址復(fù)制輸入到釘釘開放平臺(tái)-事件請(qǐng)閱的請(qǐng)求網(wǎng)址處，點(diǎn)擊保存，如下：

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

由于釘釘授權(quán)比較特殊，需在釘釘開放平臺(tái)創(chuàng)建的應(yīng)用左側(cè)，進(jìn)入權(quán)限管理，將個(gè)人權(quán)限、通訊錄權(quán)限、OA 權(quán)限、考勤、消息通知等全部權(quán)限逐一開通，操作如下：

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

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

## 二、抖音支持動(dòng)作

### 觸發(fā)器

當(dāng)前釘釘應(yīng)用連接器的觸發(fā)器如下：

* 當(dāng)有員工加入群時(shí)；
* 當(dāng)有員工主動(dòng)退群時(shí)；
* 當(dāng)審批實(shí)例開始時(shí)；
* 當(dāng)審批實(shí)例結(jié)束時(shí)；
* 當(dāng)審批任務(wù)開始時(shí)；
* 當(dāng)審批任務(wù)轉(zhuǎn)交時(shí)；
* 當(dāng)審批任務(wù)結(jié)束時(shí)；
* 當(dāng)員工打卡時(shí)；
* 當(dāng)員工加班時(shí)。

### 動(dòng)作執(zhí)行器

當(dāng)前釘釘應(yīng)用連接器的動(dòng)作執(zhí)行器如下：

* 創(chuàng)建群會(huì)話
* 查詢部門用戶列表
* 發(fā)起待辦事項(xiàng)
* 查詢員工詳情
* 創(chuàng)建審批實(shí)例
* 更新審批模板
* 查詢審批實(shí)例詳情
* 查詢審批模板詳情
* 查詢審批模板列表
* 查詢部門列表
* 查詢?nèi)簳?huì)話信息
* 執(zhí)行審批操作
* 發(fā)送工作通知
* 查詢審批實(shí)例 ID 列表
* 動(dòng)態(tài)創(chuàng)建字段
* 創(chuàng)建知識(shí)庫
* 創(chuàng)建文檔

詳細(xì)可參考：[http://www.ztnbzvn.cn/apps/app/10007](http://www.ztnbzvn.cn/apps/app/10007)

## 三、應(yīng)用示例

* **簡(jiǎn)道云+釘釘** ：當(dāng)簡(jiǎn)道云有數(shù)據(jù)修改時(shí)，給員工，發(fā)送釘釘工作通知。
* **金山表單+釘釘** ：當(dāng)有新的數(shù)據(jù)收集時(shí)發(fā)送到釘釘工作群

釘釘（自建應(yīng)用）