Skip to main content
这篇把专家接到飞书里，让团队在日常聊天窗口里直接用，并且能读写你的飞书文档和多维表格。 飞书接入最容易卡住的地方不是配置，而是两套授权是分开的：接入让机器人能收发消息，/auth 才让它能碰你的文档。很多人配完接入就以为完事了，结果一让它读文档就报权限错误，然后回去反复检查接入配置——那里是好的，问题在另一套授权上。这篇会把这条分界线讲清楚。

​
你会得到什么

  • 飞书里一个能对话的机器人，单聊群聊都可用
  • 授权之后，专家能读写你有权限的飞书文档、多维表格、知识库
  • 可以在飞书里直接说一句话建定时任务，结果推回同一个会话

​
关键认知：两套授权

用户授权是逐人的。你自己 /auth 过之后一切正常，不代表同事也能用——他必须自己执行一次。这是最常见的「在我这儿是好的」类型的困惑。

​
第一部分：接入

​
方式 A：扫码（推荐）

1

进入渠道接入

在专家 Studio 的「渠道接入」里选飞书。
2

扫码

用飞书管理员账号扫描二维码。普通成员账号扫不出来——这是第一个卡点。
3

确认授权

确认后自动创建飞书应用并配好权限与回调地址。
4

在飞书里找到机器人

搜索机器人名称，发一句「你好」测试。

​
方式 B：手动配置

需要精细控制权限范围，或想复用已有飞书应用时走这条：
1

创建企业自建应用

在飞书开放平台创建。
2

开启机器人能力

在「机器人」能力里启用。
3

配置事件订阅

回调地址从袋袋的接入面板里复制。地址填错是「机器人不回复」的头号原因，配完在飞书侧点一次验证。
4

添加权限

至少需要消息收发；要读通讯录、文档、多维表格的，对应权限一并加上。
5

回填凭证

把 App ID 和 App Secret 填进袋袋接入面板。
6

发布并等审核

企业自建应用需要发布版本并通过审核。审核没过之前机器人不会响应，这是第二个卡点，而且现象和配置错误一模一样。

​
验收接入

在飞书里给机器人发「你好」。收到回复即接入成功。没回复时按这个顺序查：应用是否已发布通过审核 → 回调地址是否正确 → 群聊里是否 @ 了机器人。

​
第二部分：用户授权

​
执行 /auth

1

发送命令

在与机器人的飞书对话里发 /auth。
2

点开链接

机器人回一条带授权链接的消息。
3

确认范围

在飞书 OAuth 页面确认授权范围，点同意。
4

回到对话

授权生效，可以让它读文档了。

​
验收授权

找一份你有权限的飞书文档，把链接发给机器人：
能读出内容即授权成功。报权限错误说明授权没生效或已过期，重新 /auth。
授权后专家的访问范围等于你自己的访问范围——你看不到的文档它也看不到。它不会因为被授权就获得超出你权限的访问能力。

​
第三部分：能做什么

授权后可用的能力分三块。注意这些工具只在飞书渠道的对话里可用，在网页端和同一个专家聊天时它们不会出现。

​
文档

「整体重写」是清空后重写，不是智能合并。对一份有人在维护的文档说「更新一下第三节」，有可能得到「整份文档只剩第三节」。要改局部就明确说「在文末追加」，或者先让它读出来、你确认新版全文之后再让它写。

​
多维表格

支持查询和修改记录、以及表结构相关的操作。典型用法是把对话里得到的结论直接写进表：
「先读表头再写」这句要带上。字段名对不上时的默认行为可能是跳过那一列，你会得到一批缺字段的记录。

​
在飞书里建定时任务

飞书渠道有个容易被忽略的能力：可以直接在聊天里创建袋袋的定时任务（不是飞书日程）：
这条任务会记录来源是飞书，所以到点执行后结果会推回这个飞书会话。任务本身在袋袋网页端可以查看和管理。周期同样只有 no-repeat / daily / weekly / monthly 四种，详见 每日简报。

​
群聊里的行为

  • 群里必须 @机器人 它才响应，不会对群内所有消息插话
  • 群成员各自的 /auth 互相独立，A 授权过不代表 B 也能读文档
  • 回复以多气泡形式发送，工具执行时会有状态提示（如「正在搜索…」）
  • 超长回复自动分段

​
边界与失败态

​
相关页面

飞书渠道

渠道配置的完整说明

飞书工具

三个工具的全部 action 与参数

知识库连接

另一条读飞书内容的路径

渠道总览

其他 IM 平台