连接飞书 / 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（企业微信） —— 另一个企业通讯渠道