飞书对接指南

2026-10-15 14:33| 发布者: 万红刚| 查看: 3| 评论: 0

摘要: 飞书对接指南1.适用范围本文适用于使用观远连接器读取飞书企业协同数据。连接器使用飞书开放平台企业自建应用的AppID和AppSecret创建数据账户；可读取的数据还取决于该应用已开通的API权限、数据可访问范围及发布状 ...

1. 适用范围

本文适用于使用观远连接器读取飞书企业协同数据。连接器使用飞书开放平台企业自建应用的 App ID 和 App Secret 创建数据账户；可读取的数据还取决于该应用已开通的 API 权限、数据可访问范围及发布状态。

进入飞书开放平台开发者后台，选择对应企业，点击“创建企业自建应用”，按页面要求填写应用名称、描述和图标，然后创建应用。飞书官方的应用创建与凭证获取说明展示了这一入口和后续页面。

飞书开放平台开发者后台中的创建企业自建应用入口

图：飞书官方页面中的“创建企业自建应用”入口。已有应用时，可直接在开发者后台打开该应用。

进入目标应用，在左侧“基础信息”下打开“凭证与基础信息”。右侧“应用凭证”区域展示 App ID 和 App Secret；复制这两个字段并分别填入观远连接器。App Secret 属于敏感信息，不要放入公开文档或截图。

飞书应用的凭证与基础信息页，标出 App ID 和 App Secret 位置

图：飞书官方资料中的完整应用凭证页面；示例 App ID 已遮挡，App Secret 保持隐藏。查看飞书官方 App ID 与 App Secret 获取步骤，或前往开发者后台打开自己的应用。

在应用的“权限管理”中，按实际要读取的打卡、审批、部门或员工数据，申请相应 API 权限并配置可访问的数据范围。完成权限配置后，按企业流程发布应用并等待所需审批。不同数据接口的权限要求以飞书开放平台对应接口文档为准；可参考飞书官方权限配置与应用发布说明。

在观远连接器的数据账户管理中点击“新增数据账户”，所属平台选择“飞书”。

观远连接器新增飞书数据账户表单

图：飞书数据账户表单，应用密钥已遮挡。

飞书平台字段	连接器字段	必填	获取入口／说明
无需在飞书平台获取	账户名称	是	自行填写便于识别的名称。
App ID	应用 ID `app_id`	是	查看飞书官方“凭证与基础信息”中的 App ID。
App Secret	应用密钥 `app_secret`	是	查看飞书官方“凭证与基础信息”中的 App Secret。

填写账户名称、App ID 和 App Secret，点击“测试连接”。测试成功后点击“确定”保存。如果后续数据接口提示无权限，检查应用的 API 权限、数据可访问范围以及应用发布状态。

现象	处理建议
找不到 App ID 或 App Secret	确认打开的是目标企业的自建应用，并进入“基础信息 → 凭证与基础信息”。
测试连接失败	核对 App ID 和 App Secret 是否来自同一个应用，检查复制时是否带入空格，以及应用是否可用。
连接成功但部分数据读取失败	按对应飞书接口文档核对 API 权限、数据可访问范围和发布状态。