連線飛書 / Lark

把你的智慧體放進飛書（Lark），用於私信和群聊。Buda 通過持久 WebSocket 連線——提供你的 App ID 和 App Secret，Buda 便會在後臺保持連線。無需公網 webhook URL 或內網穿透。

步驟 1：建立飛書應用

1.1 開啟飛書開放平臺

訪問 飛書開放平臺並登入。

1.2 建立企業自建應用

1. 點選 Create enterprise app（建立企業自建應用）
2. 填寫應用名稱、描述和圖示
3. 點選 Create（建立）

1.3 複製憑據

在 **Credentials & Basic Info（憑證與基礎資訊）**中複製：

App ID:      cli_xxxxxxxxxxxx
App Secret:  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

App Secret 預設隱藏——點選「View（檢視）」以顯示。請妥善保密。

1.4 配置許可權

在 **Permissions（許可權）**中點選 **Batch import（批次匯入）**並貼上：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "contact:contact.base:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

1.5 釋出應用（首次）

在啟用事件訂閱之前，你必須先發布應用。

1. 前往 Version Management & Release（版本管理與釋出） → Create Version（建立版本）
2. 將版本設為 1.0.0，點選 Save（儲存） → Submit for release（提交發布）
3. 等待審批（企業自建應用通常自動通過）

步驟 2：在 Buda 中配置渠道

開啟 Buda 的渠道設定，點選新增渠道，在渠道下拉選單中選擇 Lark——這是 Buda 介面上飛書/Lark 渠道的顯示名稱。輸入你的 App ID 和 App Secret，然後儲存。

Buda 會立即在後臺與飛書建立 WebSocket 長連線。

步驟 3：啟用事件訂閱

1. 前往 Event Subscription（事件訂閱） → Event Configuration（事件配置）
2. 啟用 Use long connection to receive events（使用長連線接收事件）
3. 點選 **Add Event（新增事件）**並新增 im.message.receive_v1
4. 點選 Save（儲存）

⚠️ 如果長連線開關呈灰色不可用，說明應用尚未釋出。請先完成步驟 1.5。

步驟 4：釋出新版本

新增事件後，需要釋出一個新版本才能讓更改生效：

1. Version Management & Release（版本管理與釋出） → Create Version（建立版本），遞增版本號（例如 1.0.1）
2. 點選 Save（儲存） → Submit for release（提交發布）

步驟 5：測試

1. 開啟飛書並找到你的機器人
2. 傳送一條訊息，例如 Hello
3. 機器人回覆——大功告成 🎉

故障排查

機器人無響應

長連線無法啟用

應用尚未釋出。請完成步驟 1.5，等待 1–2 分鐘後重試。

App Secret 洩露

1. 在飛書開放平臺重置 App Secret
2. 在 Buda 中更新 App Secret
3. 重啟閘道器

支援的訊息型別

接收

• ✅ 文本、富文本
• ✅ 圖片、檔案、音訊、影片
• ✅ 表情貼紙

傳送

• ✅ 文本、圖片、檔案、音訊、影片
• ✅ 互動卡片（流式輸出）

配置參考

新增渠道時，Buda 只需要這兩個欄位——沒有其他配置項：

相關內容

• 渠道總覽 —— 渠道如何把訊息路由給智慧體
• 連線 WeCom（企業微信） —— 另一個企業通訊渠道