飞书应用身份
填写自建飞书应用的 App ID 与 App Secret，让 ZAI 以应用身份调用飞书开放平台 API。
在连接器的 访问内容 → 添加访问 中，从 服务预设 选择 飞书，使用 推荐配置；默认名称为 飞书应用身份。
这里配置的是让 ZAI 以你们自建的飞书应用身份调用飞书开放平台 API 的凭证。它与 ZAI 所在的 Slack 应用无关，在 Slack 中使用 ZAI 的组织同样可以添加。
获取与填写凭证
- 在飞书开放平台打开需要接入的自建应用。
- 在“凭证与基础信息”获取 App ID 和 App Secret，分别填入 App ID 和 App Secret。
- 按使用的 API 为应用申请权限并发布版本。飞书中的文档、群等资源还需要另外向该应用开放访问权限。
应用身份只拥有该应用已获得的权限，不能替代个人用户授权。不要把临时 access token 填成 App Secret。
服务地址
推荐配置固定使用 https://open.feishu.cn，推荐的访问目标按开放平台的产品划分：
- 可读可写：文档、电子表格、多维表格、知识库、云空间、画板、幻灯片、日历与任务，包括新建、删除和分享（协作者、链接分享、转移所有者、知识库成员、多维表格角色与高级权限、仪表盘和表单分享、日历共享），以及文档搜索；
- 只读：通讯录、妙记、视频会议与 OKR。
推荐配置不覆盖 /open-apis 下的其余路径；其他地址或别的方法改用 自定义。平台用 App ID 和 App Secret 自动换取 Token，App Secret 和换取的 Token 都不会交给 ZAI。
这些访问目标决定这个应用身份在 ZAI 的任务里能调用哪些开放平台接口。ZAI 用应用身份新建的文档归应用所有，别人默认打不开：ZAI 会按你的要求把它分享出去，例如加你为协作者或开成组织内可编辑；也可以让它把文档建在已向这个应用开放编辑权限的文件夹或知识库里。能否分享到组织外，以飞书管理后台的对外分享设置为准。收发消息不在其中：ZAI 在聊天里的回复、处理状态与表情走它自己的消息通道，那里有回复审阅、分段、限额与收件人校验；需要读群消息、成员或附件时也让 ZAI 去读，不经应用身份直连。
App ID
App ID 填写应用“凭证与基础信息”中的 App ID，需与 App Secret 属于同一个应用。切换到 自定义 后，这一栏显示为 Client ID。
Token endpoint
推荐配置已填写 https://accounts.feishu.cn/oauth/v3/token，平台通过这个地址用 App ID 和 App Secret 换取 Token。不要把普通业务 API 的 URL 或短期 Token 值填在这里。
客户端认证
推荐配置使用 请求正文（client_secret_post）。自定义配置以目标应用支持的换取 Token 方式为准。
Scopes
推荐配置留空。飞书应用的权限仍需在开放平台申请并发布；在这里填写权限名称不会让飞书授予该权限。
验证
保存后请 ZAI 读取一次机器人信息（GET /open-apis/bot/v3/info，应用需已启用机器人能力），确认凭证可用；业务 API 能否调用，仍取决于开放平台中已发布的权限。其余排查见验证与排错。