飞书消息渠道配置

xylplm2026/4/23大约 7 分钟

📱 飞书消息渠道配置

飞书渠道适合用于团队内通知和远程交互。本文按“飞书平台配置 -> Media Saber 配置 -> 联调验证”完整展开，所有关键步骤都保留并细化为图文对应的实操说明，方便首次接入用户逐项对照完成。

📋 配置流程概览

在飞书开放平台创建企业自建应用
为应用添加机器人能力并获取 App ID、App Secret
在 Media Saber 中填入 App ID、App Secret 并应用配置
回到飞书平台完成事件订阅与权限配置
发布应用并在飞书客户端验证
完成首次配对，开通交互权限

建议按顺序执行，不要跳步。尤其是“先在 Media Saber 保存渠道成功，再回飞书配置事件回调”，这是长连接能否建立的关键。

🧭 飞书开发者平台配置

步骤一：创建企业自建应用

登录飞书开发者平台。
点击创建应用，选择“企业自建应用”。
填写应用名称、描述等基础信息。
创建成功后进入应用管理页。

预期结果：进入应用详情页，可继续添加应用能力。

步骤二：添加机器人能力

在左侧导航找到“添加应用能力”。
在能力列表中选择“机器人”。
点击添加并保存。
返回应用能力页面，确认机器人能力已启用。

预期结果：应用具备收发消息能力。

在应用基础信息页面记录后续要用到的凭证：

App ID
App Secret

步骤三：在 Media Saber 中先接入飞书应用

进入 Media Saber：系统设置 -> 消息通知 -> 添加渠道。
渠道类型选择“飞书”。
填入上一步保存的 App ID、App Secret。
推荐启用配对模式（默认通常已打开）。
点击保存，等待配置执行成功。

预期结果：Media Saber 成功保存飞书渠道配置，并开始尝试建立长连接。

这一步一定要执行成功后，再继续配置飞书平台的事件与回调。

步骤四：配置事件与回调、订阅事件、配置权限

再次回到飞书开发者后台，在应用管理页左侧进入“事件与回调”。
将事件配置和回调配置都设置为“长连接模式”。

注意：如果提示“未建立长连接”，请先确认第 3 步中 App ID、App Secret 已正确保存；必要时重启 Media Saber 后回到当前页面刷新重试。

点击事件配置中的“添加事件”。
在事件列表中选择“消息与群组”分类，勾选“接收消息”，点击“确定”，完成事件订阅。
继续配置飞书应用权限，在左侧导航进入“权限管理”。
选择“批量导入/导出权限”。
将以下 JSON 粘贴进文本域并保存：

{
   "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:write",
         "contact:user.base:readonly",
         "contact:user.employee_id:readonly",
         "corehr:file:download",
         "docs:document.content:read",
         "event:ip_list",
         "im:chat",
         "im:chat.access_event.bot_p2p_chat:read",
         "im:chat.members:bot_access",
         "im:chat:read",
         "im:message",
         "im:message.group_at_msg:readonly",
         "im:message.group_msg",
         "im:message.p2p_msg:readonly",
         "im:message:readonly",
         "im:message:send_as_bot",
         "im:resource",
         "sheets:spreadsheet",
         "wiki:wiki:readonly"
      ],
      "user": [
         "aily:file:read",
         "aily:file:write",
         "contact:contact.base:readonly",
         "im:chat.access_event.bot_p2p_chat:read"
      ]
   }
}

保存后，页面应出现已配置完成的权限状态。

配置完成页面示例：
飞书步骤四-4

预期结果：

事件订阅已生效
长连接状态正常
权限配置完成

步骤五：验证飞书接入

发布刚才编辑好的应用，在顶部导航点击“创建版本”，进入版本详情。
填写版本号和更新说明，保存并发布。
在飞书客户端打开“工作台”，进入已发布应用。
触发一次测试通知，确认消息可到达飞书。

预期结果：飞书中可正常收到 Media Saber 通知，且交互命令可执行。

步骤六：配对飞书聊天

在飞书聊天页面向机器人发送任意消息。
正常情况下，首次会收到“未完成配对”提示，内容类似：
“未完成配对。请到消息通知中编辑飞书渠道，将‘配对口令’设置为：CSE7PCLT，并保存后再次发送消息。”
复制消息中的随机配对口令（示例：CSE7PCLT，口令有效期约 5 分钟）。
回到 Media Saber，编辑飞书消息渠道，在“配对口令”输入框填写该口令。
点击保存。
回到飞书机器人会话，再发送任意消息。
机器人返回“配对成功，已开通交互权限”即表示配对完成。
配对成功后，即可正常使用飞书交互能力。

如果没有返回配对提示，请检查：