飛書是字節(jié)跳動旗下的企業(yè)協(xié)同 OA 系統(tǒng)，飛書有兩種接入方式，一個(gè)企業(yè)自建的飛書機(jī)器人進(jìn)行接入，一個(gè)使用數(shù)環(huán)通在飛書平臺的機(jī)器人進(jìn)行接入。兩個(gè)方式的功能有所不同，本文介紹的是飛書企業(yè)自建機(jī)器人的接入方式。

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

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

飛書應(yīng)用連接器賬號授權(quán)方式為 APPTOKEN，需要前往飛書開放平臺，獲取授權(quán)信息，并將相關(guān)信息填入數(shù)環(huán)通飛書應(yīng)用連接器的授權(quán)賬戶信息中。

### 第 1 步：登錄飛書開放平臺賬號

后臺地址：[https://open.feishu.cn/](https://open.feishu.cn/)，登錄賬號。

![1655884413843.jpg](/media/202307/2023-07-24_1509060.9656629784077693.png "1655884413843.jpg")

進(jìn)入飛書客戶端界面，點(diǎn)擊左側(cè)的工作臺菜單，然后點(diǎn)擊右上的“創(chuàng)建應(yīng)用”

![](/media/202307/2023-07-24_1509060.294911731773833.png)

### 第 2 步：安全設(shè)置

應(yīng)用審核上線后，點(diǎn)擊「安全設(shè)置」，在重定向 URL 添加鏈接 [http://www.ztnbzvn.cn/redirect](http://www.ztnbzvn.cn/redirect)， 若需要設(shè)置 IP 白名單，可聯(lián)系數(shù)環(huán)通獲取 IP。

![image.png](/media/202307/2023-07-24_1509060.6574814254590595.png)

### 第 3 步：獲取授權(quán)信息

登錄后，進(jìn)入應(yīng)用創(chuàng)建界面，在“企業(yè)自建應(yīng)用”里點(diǎn)擊 “創(chuàng)建企業(yè)自建應(yīng)用”，按照步驟創(chuàng)建完成后，在應(yīng)用的憑證與基礎(chǔ)信息菜單找到 「App ID 」和 「App Secret」。

在“權(quán)限管理”頁面添加消息，通訊錄，群聊，審批等應(yīng)用管理權(quán)限：

授權(quán)時(shí)需要先在飛書開放平臺進(jìn)行權(quán)限開通，這樣才可以收到推送的消息。如：使用“當(dāng)審批狀態(tài)變化時(shí)”，需先開通權(quán)限狀態(tài)，具體操作步驟：點(diǎn)擊左側(cè)菜單欄【權(quán)限管理】-【審批】-確保權(quán)限狀態(tài)是【已開通】。

![](/media/202307/2023-07-24_1509060.8021021416594737.png)

### 第 4 步：賬號授權(quán)登錄

將獲取到的授權(quán)信息，填寫到數(shù)環(huán)通飛書應(yīng)用連接器的授權(quán)賬戶信息中，自定義賬戶名稱后，即完成賬號授權(quán)。

![1655883383518.jpg](/media/202307/2023-07-24_1509060.8669723612062346.png "1655883383518.jpg")

## 二、支持的動作

### 觸發(fā)器

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

* 當(dāng)員工打卡時(shí)
* 當(dāng)有員工加入群時(shí)
* 當(dāng)員工加班時(shí)
* 當(dāng)員工請假時(shí)
* 當(dāng)員工出差審批通過時(shí)
* 當(dāng)員工入職時(shí)
* 當(dāng)員工離職時(shí)
* 當(dāng)用戶主動退群或被移出群聊時(shí)
* 當(dāng)有新的審批單時(shí)

### 動作執(zhí)行器

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

* 執(zhí)行轉(zhuǎn)交審批操作
* 抄送審批實(shí)例
* 通過員工 ID 獲取入職信息
* 發(fā)送文本消息
* 獲取員工信息
* 獲取部門列表
* 查詢用戶列表
* 獲取打卡流水記錄
* 獲取審批實(shí)例列表
* 撤回審批實(shí)例
* 創(chuàng)建審批實(shí)例
* 根據(jù)員工手機(jī)號查詢員工 ID
* 獲取審批定義
* 執(zhí)行同意或者拒絕審批操作
* 獲取審批任務(wù)列表
* 獲取審批實(shí)例詳情

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

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

1. 飛書 + 郵件/短信系統(tǒng)：實(shí)時(shí)消息推送，高效溝通！使用 @ 飛書機(jī)器人，您可以輕松將郵件或短信消息發(fā)送給指定用戶，確保信息及時(shí)傳達(dá)，工作更加順暢！
2. 飛書 + 快遞 100：物流信息一手掌握！通過 @ 飛書機(jī)器人，快速創(chuàng)建并獲取快遞信息，讓您隨時(shí)掌握包裹狀態(tài)，確保順暢的物流運(yùn)營！
3. CRM + 飛書：銷售線索實(shí)時(shí)同步，銷售業(yè)績倍增！讓您的 CRM 與飛書緊密結(jié)合，當(dāng)有新的銷售線索產(chǎn)生時(shí)，系統(tǒng)會自動同步信息到飛書，并提醒跟進(jìn)的銷售人員，助力您的業(yè)務(wù)拓展！

飛書（自建）