跳转到主要内容
将你的 AI 专家接入飞书（Lark），让团队成员在日常办公的飞书消息中直接与专家对话。飞书渠道支持完整的对话能力，并额外提供用户级 OAuth 授权，允许专家访问用户的个人文档和多维表格。

​
接入方式

飞书提供两种接入方式：
最快的接入方式，几分钟即可完成：
  1. 在专家 Studio 的「渠道接入」中选择飞书
  2. 点击「扫码接入」
  3. 使用飞书管理员账号扫描二维码
  4. 确认授权，自动完成所有配置
  5. 在飞书中找到机器人开始测试
扫码方式会自动创建飞书应用并配置必要的权限和回调地址。
如果你需要更精细的权限控制，可以选择手动配置：
  1. 登录飞书开放平台，创建企业自建应用
  2. 在「机器人」能力中启用机器人
  3. 配置事件订阅回调地址（在袋袋接入面板中获取）
  4. 添加所需权限（消息收发、通讯录读取等）
  5. 将 App ID 和 App Secret 填入袋袋的接入配置面板
  6. 发布应用版本并审核通过
手动配置适合需要限定特定权限范围、或已有飞书应用希望复用的场景。

​
消息格式

飞书渠道采用「多气泡」消息风格：
  • 专家的文本回复作为独立消息气泡发送
  • 工具调用时发送状态通知（如「🔍 正在搜索…」）
  • 工具完成后发送最终回复
  • 支持 Markdown 格式渲染
飞书消息有长度限制。超长回复会被自动分段发送。

​
对话场景

​
单聊

直接给机器人发送消息即可开始一对一对话，适合个人使用场景。

​
群聊

在群组中 @机器人 后发送消息，专家会在群内回复。适合团队协作场景，其他成员可以看到对话过程。
群聊中专家只响应 @它的消息，不会对群内所有消息做出回应。

​
用户 OAuth 授权

飞书渠道的独特功能——通过 /auth 命令完成用户级 OAuth 授权后，专家可以访问你的个人飞书资源。

​
授权流程

1

发送授权命令

在与专家的飞书对话中发送 /auth。
2

点击授权链接

专家会回复一条包含授权链接的消息，点击该链接。
3

确认授权

在飞书 OAuth 页面确认授权范围（文档读取、多维表格访问等），点击同意。
4

授权生效

授权成功后，专家即可代你访问飞书文档和多维表格。

​
授权后的能力

完成 OAuth 授权后，专家获得以下额外能力：
OAuth Token 有有效期。过期后专家会提示你重新执行 /auth 命令。Token 刷新失败时会自动回退到基础能力（不访问你的个人资源），不影响正常对话。

​
常见问题

检查以下几项：
  • 确认应用已发布并通过审核
  • 确认事件回调地址配置正确
  • 确认专家的袋袋服务正常运行
  • 如果是群聊，确认已 @机器人
IM 渠道的响应速度取决于 AI 模型的推理时间和工具调用耗时。如果使用了搜索或文件处理等工具，回复时间会相应增加。这与网页端一致。
确认你使用的专家已由创作者配置了飞书 OAuth 能力。并非所有专家都支持此功能。

​
相关页面

渠道总览

了解所有支持的 IM 平台

钉钉接入

钉钉渠道配置指南