飞书消息渠道配置

xylplm2026/4/23大约 6 分钟

📱 飞书消息渠道配置

飞书渠道适合用于团队内通知和远程交互。本文按“飞书平台配置 -> Media Saber 配置 -> 联调验证”完整展开，避免漏项。

📋 配置流程概览

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

✅ 前置检查

开始前请先确认：

你可以登录飞书开发者平台并有应用管理权限
Media Saber 已可正常访问外网
你已经准备好在消息通知中新增一个“飞书”渠道

图片来源为你指定的教程页面，已下载到本地目录 ./image/feishu/。

🧭 飞书开发者平台配置

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

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

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

步骤二：添加机器人能力

在左侧导航找到“添加应用能力”。
在能力列表中选择“机器人”。
添加完成后，确认机器人能力已启用。

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

飞书步骤二-1
飞书步骤二-2

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

App ID
App Secret

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

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

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

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

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

再次回到飞书开发者后台页面，在应用管理页左侧导航栏找到事件与回调
事件配置和回调配置均使用使用长连接模式。注意：如果这一步提示未建立长连接，请检查自己的APP ID和APP Secret是否已正确配置，返回步骤三重新执行或重启ms重试即可。
点击事件配置中的添加事件，在弹出的事件列表中，选择消息与群组分类，勾选接收消息，点击 “确定”，完成事件订阅。
配置飞书应用权限，打开在应用管理页左侧导航栏找到权限管理。

选择批量导入/导出权限

将以下命令粘贴进文本域：

{
   "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 通知，且交互命令可执行。

1、在聊天页面发送任意消息到飞书
2、正常情况下，首次配对，消息会返回【未完成配对。请到消息通知中编辑飞书渠道，将“配对口令”设置为：CSE7PCLT，并保存后再次发送消息。】消息内容。这里面会有一个随机配对口令 5分钟有效如果没有正常返回，请检查前面的App ID、App Secret是否填写正确，以及其他步骤是否完整
3、此时复制里面的口令比如这里示例的CSE7PCLT
4、回到mediasaber 编辑飞书消息渠道，在配对口令的输入框中填写刚才的CSE7PCLT口令
5、点击保存
6、回到飞书机器人界面发送任意消息
7、机器人返回【配对成功，已开通交互权限】消息就表示配对成功了。

8、下面就可以自由的和飞书聊天互动了。