飛書是字節跳動旗下的企業協同 OA 系統，飛書有兩種接入方式，一個企業自建的飛書機器人進行接入，一個使用數環通在飛書平臺的機器人進行接入。兩個方式的功能有所不同，本文介紹的是飛書企業自建機器人的接入方式。

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

## 一、應用授權

飛書應用連接器賬號授權方式為 APPTOKEN，需要前往飛書開放平臺，獲取授權信息，并將相關信息填入數環通飛書應用連接器的授權賬戶信息中。

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

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

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

進入飛書客戶端界面，點擊左側的工作臺菜單，然后點擊右上的“創建應用”

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

### 第 2 步：安全設置

應用審核上線后，點擊「安全設置」，在重定向 URL 添加鏈接 [http://www.xmfmdq.com/redirect](http://www.xmfmdq.com/redirect)， 若需要設置 IP 白名單，可聯系數環通獲取 IP。

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

### 第 3 步：獲取授權信息

登錄后，進入應用創建界面，在“企業自建應用”里點擊 “創建企業自建應用”，按照步驟創建完成后，在應用的憑證與基礎信息菜單找到 「App ID 」和 「App Secret」。

在“權限管理”頁面添加消息，通訊錄，群聊，審批等應用管理權限：

授權時需要先在飛書開放平臺進行權限開通，這樣才可以收到推送的消息。如：使用“當審批狀態變化時”，需先開通權限狀態，具體操作步驟：點擊左側菜單欄【權限管理】-【審批】-確保權限狀態是【已開通】。

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

### 第 4 步：賬號授權登錄

將獲取到的授權信息，填寫到數環通飛書應用連接器的授權賬戶信息中，自定義賬戶名稱后，即完成賬號授權。

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

## 二、支持的動作

### 觸發器

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

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

### 動作執行器

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

* 執行轉交審批操作
* 抄送審批實例
* 通過員工 ID 獲取入職信息
* 發送文本消息
* 獲取員工信息
* 獲取部門列表
* 查詢用戶列表
* 獲取打卡流水記錄
* 獲取審批實例列表
* 撤回審批實例
* 創建審批實例
* 根據員工手機號查詢員工 ID
* 獲取審批定義
* 執行同意或者拒絕審批操作
* 獲取審批任務列表
* 獲取審批實例詳情

詳細可參考：http://www.xmfmdq.com/apps/app/10008

## 三、應用示例

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

飛書（自建）