跳至主要內容

飛書 / Lark

日常接入請先使用長連線。它由 Gateway 主動連線平台,不要求公用網路入站 Webhook。需要飛書/Lark App ID 和 App Secret,並在平台啟用機器人、訊息權限和事件訂閱。

現有設定入口的範圍​

v0.1.107 的一般設定介面為未設定的飛書選擇預設長連線 Profile。Dashboard、TUI 和 CLI 精靈沒有連線 Profile 選擇/切換控制項,無法透過尚未實作的按鈕把帳號改為 Webhook。

目錄中同時宣告了 feishu.websocket.v1、feishu.webhook.v1 及切換動作,這是協定能力;它不代表標準設定流程已經提供選擇入口。已有 Webhook 帳號可按其目前 Profile 更新。Dashboard/TUI 只更新所展示的 App 認證資料,CLI 對現有 Webhook Profile 還會展示相應驗籤認證資料。

按長連線完成首次接入​

  1. 在平台為應用啟用 Bot,授予收發訊息權限,訂閱訊息事件並選擇長連線投遞。
  2. 開啟 Dashboard 通訊管道 → 新增 → Feishu / Lark,填寫 app_id 與 app_secret。
  3. 預設帳號 ID 為 work;儲存後檢查健康狀態的觀測結果。
  4. 需要調整存取策略時執行 anyy setup channel,在清單中選飛書。

平台主控台的變更請參考飛書官方概覽。

配對之後再驗證群組對話​

預設私訊為 pairing,群組對話為 mention。可選私訊策略為 pairing/open/allowlist/disabled,群組對話為 mention/open/allowlist/disabled。一般 Dashboard 認證資料表單不提供策略或名單編輯;設定限制見訊息平台。

anyy channel pairing list --channel feishu
anyy channel pairing approve --request REQUEST_ID
anyy channel reload
anyy channel doctor feishu

批准後先傳送新私訊,再測試群組中明確提及 Bot。長連線線上不代表 Bot 在所有群組中都有收發權限。

已有 Webhook 帳號​

該 Profile 還要求 Verification Token、Encrypt Key,與平台保持一致。它使用:

/channels/feishu/ACCOUNT_ID/webhook

啟用監聽與 HTTPS 轉發的方法見訊息平台。沒有公用網路路由時不會因為儲存帳號而自動出現回呼服務。

若長連線不通,先查出站網路、App 認證資料和訂閱;若 Webhook 校驗失敗,分別查 HTTPS、Verification Token、Encrypt Key;若訊息已到但未回覆,再檢查存取策略與 Bot 權限。