填写已有的用户访问令牌
确认飞书令牌类型,填写已有的 user_access_token;只有 App ID 和 App Secret 时使用账号授权流程。
飞书通常通过一键授权连接账号。如果当前环境也提供“使用访问令牌”入口,本页说明应填写什么,以及没有令牌时怎么继续。
此处填写 user_access_token。只有 App ID 和 App Secret 时,请使用“一键授权”。
没有令牌时
查看管理员配置步骤关闭弹窗,在“连接账号”中选择“一键授权”。
没有此选项时,请工作空间管理员先配置授权应用。
核对令牌
请应用负责人确认令牌属于目标账号,且尚未过期。
App Secret、app_access_token 和 tenant_access_token 不能填在这里。
粘贴令牌并连接
填入完整令牌,点击“连接”。
令牌过期后,通过“重新连接”更新。
还没有令牌时怎么做
关闭当前弹窗,重新点击“连接账号”,选择一键授权或前往授权,在飞书页面确认账号并允许访问。EasyXAI 会处理凭证保存,无需自己复制令牌。
如果看不到授权入口,请联系 EasyXAI 工作空间管理员,按自建应用配置指南登记团队的飞书应用。
如果应用负责人已经通过飞书的用户授权流程取得用户访问令牌,可以按下面两节手动填写。不要仅为了连接账号,要求普通成员编写代码或自行调用接口。
先确认手里的凭证
请应用负责人确认凭证类型、对应账号和有效期。名字里都有 “token”,并不代表可以互换。
| 拿到的信息 | 填到哪里 |
|---|---|
user_access_token(用户访问令牌) | 当前“访问令牌”字段;必须属于预期账号且尚未过期 |
| App ID 和 App Secret | 由工作空间管理员填入“自带授权应用”的 Client ID 和 Client Secret;保存后成员仍需授权账号 |
app_access_token / tenant_access_token | 不能代替本页所需的用户访问令牌 |
只填写 App Secret 不能完成账号连接。这里不会自动把 App ID / App Secret 换成用户访问令牌。
在 EasyXAI 填写并连接
- 在当前工作空间打开应用中心 → 飞书 → 连接账号。
- 点击连接账号 → 使用访问令牌。没有此入口时,请使用普通账号授权,不需要另行打开令牌接入开关。
- 将完整
user_access_token粘贴到访问令牌,不用添加Bearer前缀、引号或其他内容。 - 备注可以不填。点击连接后,核对显示的账号。
- 点击配置应用能力继续选择用途,或点击完成返回原来的页面。
手动填写的令牌到期后,需要从原连接的重新连接入口更新;这种填写方式不会为令牌自动续期。账号连接成功后,也只能使用该账号和应用已获得的文档权限。
如果提示凭证无效,先请应用负责人检查令牌类型、有效期与复制内容,再查看常见问题。不要改填 App Secret,也不要将真实凭证发到聊天消息或截图中。