飛書推送工具
要獲取飛書開發所需的 APP_ID、APP_SECRET?以及用戶的 USER_ID,需通過飛書開放平臺和飛書客戶端的相關設置操作。以下是詳細步驟:
一、獲取 APP_ID?和 APP_SECRET(飛書應用憑證)
APP_ID?和 APP_SECRET?是飛書開放平臺為應用分配的唯一憑證,用于接口調用的身份驗證。需先創建一個飛書應用(企業自建應用):
1. 登錄飛書開放平臺
- 訪問飛書開放平臺官網:飛書開放平臺
- 使用企業管理員賬號登錄(個人賬號可能無權限創建企業應用)。
2. 創建企業自建應用
- 登錄后,進入「開發者后臺」→ 「應用列表」→ 點擊「創建應用」。
- 選擇「企業自建應用」(適用于企業內部使用的應用),填寫應用名稱(如 “測試報告推送工具”),選擇應用圖標,點擊「確定」。
3. 獲取 APP_ID?和 APP_SECRET
- 應用創建后,進入應用詳情頁,在左側導航欄選擇「憑證與基礎信息」。
- 在「應用憑證」欄目中,即可看到 APP_ID(應用 ID)和 APP_SECRET(應用密鑰)。
- 注意:APP_SECRET?為敏感信息,需妥善保管,不要泄露給無關人員。
二、獲取 USER_ID(飛書用戶 ID)
USER_ID?是飛書用戶的唯一標識(通常為一串字符串,如 ou_xxxxxx),用于指定消息的接收者。獲取方式有兩種:
方法 1:通過飛書客戶端查詢
- 打開飛書客戶端,進入目標用戶的聊天窗口。
- 點擊用戶頭像,進入用戶資料頁。
- 點擊資料頁右上角的「...」→「更多信息」,在「用戶 ID」欄目中即可看到 USER_ID(格式通常為 ou_?開頭)。
方法 2:通過飛書開放平臺接口查詢
如果需要批量獲取用戶 ID,可調用飛書開放平臺的「獲取用戶信息」接口(需先為應用添加「通訊錄」權限):
- 在應用詳情頁的「權限管理」中,申請「獲取用戶基本信息」「獲取部門用戶列表」等權限,并等待企業管理員審批。
- 調用接口 GET /contact/v3/users,傳入用戶手機號或郵箱,即可返回對應的 USER_ID。
- 接口文檔參考:飛書開放平臺 - 獲取用戶信息
三、補充說明
- REPORT_PATH:這是本地測試報告的路徑(如 ./test_report.html),無需從飛書獲取,只需確保該路徑在打包后的 EXE 文件運行環境中存在且正確即可。
- 權限配置:如果應用需要向用戶推送消息,需在「權限管理」中申請「消息推送」相關權限(如「發送單聊消息」),否則接口調用會失敗。
- 調試建議:在開發階段,可先通過飛書開放平臺的「API 調試工具」測試接口調用是否成功,確認 APP_ID、APP_SECRET?和 USER_ID?無誤后,再集成到代碼中。
通過以上步驟,即可獲取代碼中所需的 APP_ID、APP_SECRET?和 USER_ID,進而實現通過飛書推送消息的功能。