飞书机器人接入教程：创建自建应用并配好权限让 WorkBuddy 听令

飞书团队里最常见的三件事：周报催交、文档变更没人知道、值班表对不上。这些事有个共同点——信息在群里，动作在人身上，中间靠嘴催。

把 WorkBuddy 接成飞书机器人之后，逻辑反过来了：群里 @机器人 下指令，它领活、执行、把结果连同飞书文档链接一起丢回群里。飞书的优势还在于它的文档、日历、群消息是一套的，机器人能直接读写文档内容，这在企微、钉钉上要另外想办法。

飞书机器人的两种做法怎么选 #

判断标准很简单：只想定时往群里推消息，走 Webhook 群机器人（见本站群机器人篇）；想让同事在群里 @它 派活，就必须走自建应用。

前置条件 #

1. 电脑上已安装 WorkBuddy，并已开启「助理」的远程控制。
2. 有飞书企业账号，且具备创建应用的权限（企业自建应用需有该权限；如果账号没有，找管理员要，或申请"创建企业自建应用"权限）。
3. 飞书应用发布需要管理员审核，所以本次配置要提前跟管理员约个时间。

六步接入流程 #

第 1 步：创建企业自建应用

登录飞书开放平台 open.feishu.cn → 开发者后台 → 「创建企业自建应用」→ 填写应用名称、描述、上传图标 → 创建。

名称建议直接写用途，例如「AI 助理-行政值班」，后面同事在群里认的是这个名字。

第 2 步：添加机器人能力

进入应用详情 → 「添加应用能力」→ 找到「机器人」→ 添加。

添加后应用会多一个机器人身份，之后才能在群里被 @ 到。

第 3 步：批量导入权限（关键一步）

左侧菜单「权限管理」→ 找到「批量导入/导出权限」（通常是一个"批量导入"入口）→ 先把输入框里的内容清空 → 粘贴下面的 JSON → 点「确定新增权限」。

{
  "scopes": [
    "im:message",
    "im:message:send_as_bot",
    "im:chat:read",
    "im:chat:update",
    "im:message.group_at_msg:readonly",
    "im:message.p2p_msg:readonly",
    "im:resource",
    "contact:contact.base:readonly",
    "docx:document:readonly"
  ]
}

各权限的作用：

请以下面的规则为准：权限项以开发者后台为准，飞书会随版本调整权限点命名与粒度。上面的清单是当前常用组合的起点，缺哪个权限报错了，再补哪个。不要一次申请一大堆无关权限——那是给后续的安全管理埋雷。

第 4 步：事件订阅配置

左侧「事件订阅」→ 配置订阅方式（回调地址或长连接，按你所在组织可提供的条件选择）→ 添加要订阅的事件，至少要包含群消息中的 @ 机器人消息与单聊消息两类。

这一步决定了"能不能收到别人的指令"，填不对后面全靠猜。

第 5 步：把凭据填回 WorkBuddy

在第 1 步的应用里拿到 App ID 与 App Secret（应用详情页的「凭证与基础信息」区域），再到 WorkBuddy 的助理设置 → 集成(BETA) → 飞书集成 → 配置中，把两个值填进去。

同时，把 WorkBuddy 生成/提供的 Webhook 地址复制出来，填回飞书开放平台的对应配置项里。两边是互相填的：飞书给 WorkBuddy 身份凭据，WorkBuddy 给飞书一个可以投递消息的地址。

填完保存，两边状态都变成「已连接/已启用」才算数。

第 6 步：发布应用（最容易被忘的一步）

应用详情页 → 「版本管理与发布」→ 创建新版本 → 填写版本描述 → 申请发布。

不发布，前面五步全部不生效——草稿态的能力对群成员不可见，@ 了也只会提示"机器人不存在"。飞书侧还需要管理员审核，审核通过后机器人才会真正出现在可选机器人列表里。

验证是否成功 #

发布审核通过后依次测：

1. 在群里发一句普通消息——机器人不应该乱回（确认它没有过度响应）。
2. @机器人 + 一段文字指令——应收到回复。
3. 单聊机器人发一条指令——应收到回复。
4. 让它读一份飞书文档（标题或链接给它）——能读出内容，说明 docx 权限配置正确。

第 4 步过不了，回第 3 步补 docx:document:readonly 并重发版本。

常见坑与 FAQ #

Q1：群里 @ 机器人，提示"该机器人已移除"或找不到。
八成是第 6 步没发布，或者发布还在管理员审核中。让管理员看一下审核状态。

Q2：权限怎么粘不进去？
批量导入的输入框必须先清空再粘贴，老内容没删干净会导致解析失败。粘贴后逐条核对，确认"确定新增权限"点了。

Q3：加了权限还是报"无权限"。
权限是按版本生效的，新增权限后必须发一个新版本并审核通过才生效，光点"确定新增"没用。

Q4：docx:document:readonly 是必须的吗？
如果你的机器人只需要收发群消息，可以只保留消息类权限。但只要你想让它读飞书文档内容，这条就得有。按最小权限原则，缺了再加。

Q5：事件订阅配在哪一头？
飞书开放平台配"订阅什么事件 + 消息投递到哪"，WorkBuddy 配"用哪个应用身份登录"。两边都要对上，缺一边就是静默失败。

Q6：没有创建应用的权限怎么办？
找管理员在开放平台后台给你开「创建企业自建应用」权限；自己账号建不出来的，让管理员代建后把 App ID / Secret 给你。

Q7：权限点以后改名了怎么办？
以开发者后台为准。报错信息里通常会直接给出缺失的权限名，按名补齐、发版即可。

小结 #

飞书这一条链路比微信、企微都"重"——要建应用、配权限、发版、过审。换来的是它能读写飞书文档、识别群成员、支撑完整的双向会话，这是其它通道给不了的。

如果你的诉求只是"每天早八点把日报推到群里"，别走这套重流程，直接看群机器人 Webhook 与定时推送那篇。

本系列属于「专家与连接器」模块。需要帮公司批量建应用、过审核、配角色与权限，本站提供 1v1 部署陪跑。

相关阅读：企业微信助理接入教程 · 钉钉机器人接入教程 · 群机器人 Webhook 与定时推送