飞书

说明

通过飞书自建应用接入超级 AI 助理，使用 WebSocket 长连接 模式，无需公网 IP，支持单聊与群聊（@机器人），支持流式卡片回复和 Markdown 渲染。

支持 扫码接入 和 手动填写 两种方式，推荐使用扫码接入，更加快捷。

接入前请确保使用的是飞书企业用户且具有企业管理权限。

方式一：扫码接入（推荐）

在 超级AI助理 - 渠道接入 界面找到【飞书】渠道，选择「扫码接入」模式，点击 一键创建飞书应用，使用 飞书 App 扫描二维码即可自动完成应用创建并接入：

扫码或点击链接后即可进入飞书创建页面：

扫码创建出的应用会自动预置全部所需权限（消息收发、卡片读写、群聊事件等）和事件订阅，无需到飞书开放平台手动配置。

方式二：手动填写

1. 飞书应用创建和权限配置

1.1 进入飞书开发平台 ，点击创建企业自建应用

1.2 在添加应用能力菜单中，为应用添加机器人能力

1.3 添加权限

打开权限管理菜单，点击开通权限，一键复制下方的权限项，粘贴到开通权限的输入框内，全选筛选结果，点击批量开通权限：

im:message,im:message.group_at_msg,im:message.group_at_msg:readonly,im:message.p2p_msg,im:message.p2p_msg:readonly,im:message:send_as_bot,im:resource,cardkit:card:write

cardkit:card:write 权限用于流式卡片回复，未开通该权限将自动降级为普通文本回复。

2. 填写配置

2.1 在凭证与基础信息内获取到 App ID 和 App Secret

2.2 LinkAI 渠道接入配置

在 超级AI助理 - 渠道接入 界面找到【飞书】渠道，选择「手动填写」模式，把上一步获取到的 App ID、App Secret 填到对应位置，最后点击确认创建。

3. 配置事件订阅

3.1 在飞书开放平台点击 事件与回调，选择 长连接 方式，点击保存：

3.2 点击下方的 添加事件，搜索 "接收消息"，选择 "接收消息 v2.0"，确认添加。

4. 发布应用

完成全部配置后，点击 版本管理与发布，点击 创建版本，并申请 线上发布，在飞书客户端查看审批消息并审核通过：

使用

完成接入后，在飞书中搜索创建的机器人名称，即可开始单聊对话。

如需在群聊中使用，将机器人添加到群中，@机器人发送消息即可。

功能说明

功能	支持情况
单聊	✅
群聊（@机器人）	✅
文本消息	✅ 收发
图片消息	✅ 收发
Markdown 渲染	✅
流式卡片回复	✅（默认开启）

流式卡片回复要求接收方飞书客户端版本 ≥ 7.20，低版本客户端会显示升级提示，权限或版本不满足时自动降级为普通文本回复。