飞书快速接入

适合谁：能创建企业自建应用的用户

预计时间：约 5–10 分钟

是否写代码：不需要

需要的权限：可以创建企业自建应用

完成结果：在飞书中私聊或群聊分身

快速创建会自动完成什么

• 创建企业自建应用并开启机器人能力。
• 自动预填当前分身的名称、简介和公开可访问头像。
• 申请接收消息所需的最小权限。
• 配置事件接收和快速创建所需设置。

企业策略要求审批时，仍需要管理员在飞书后台审核和发布。

创建步骤

1. 在灵谐 PC 端打开“更多 → 开放平台 → 办公平台”，选择“飞书”。
2. 点击“开始快捷创建”，用飞书扫描二维码或打开确认页。
3. 检查应用名称、简介、头像和目标企业。
4. 确认权限并创建应用；出现管理员审批时按企业流程提交。
5. 回到灵谐，等待页面自动显示“已连接”。

开放平台办公平台飞书确认预填资料授权创建自动检查

验证成功

1. 在飞书中搜索应用或机器人并打开私聊。
2. 发送一条文字消息，应收到分身回复。
3. 加入测试群后 @机器人 发送文字，应收到一次回复。
4. 可发送一张不超过 10 MB 的图片，确认返回文字回复。

常见问题

私聊页面没有输入框

检查机器人能力是否开启、应用是否创建版本并发布、当前用户是否在可用范围内。配置发生变化后通常需要重新发布版本并经过管理员审批。

为什么不需要公网回调地址

灵谐使用飞书“长连接”接收事件。它只要求运行服务可以访问公网，不需要你准备公网 IP、域名或服务器回调地址。该方式仅适用于企业自建应用。

头像没有自动预填

只有 HTTPS 且属于灵谐允许公开访问域名的头像才会传给飞书；不符合条件时使用产品默认头像，避免把内网或不可信地址提交给平台。

最后核验：2026-07-22。详细限制参见飞书官方的使用长连接接收事件和机器人概述。