# 同步飞书和钉钉表格

把飞书多维表格或钉钉 AI 表格单向同步到工作簿，供智能体分析。

使用指南 · 模块: data · 管理人员 · 部署形态：资料未说明 · 已确认产品版本：资料未说明 · 来源：编辑整理 · 按产品 4.2.76-1110（CLI 0.0.18）核对；私有部署的旧版本可能不包含近期变化。

表格连接器把飞书多维表格或钉钉 AI 表格单向同步到 AskTable 的[工作簿](https://docs.asktable.com/data/connect#%E5%B7%A5%E4%BD%9C%E7%B0%BF)。同步后的工作表可以像其他数据一样被智能体查询，内容仍在飞书或钉钉中维护。

需要项目负责人或项目管理员。入口：「更多」→「数据接入」→「连接器」。

## 准备

- **飞书**：在飞书开放平台创建「企业自建应用」，记下 App ID 和 App Secret，并给应用开通目标多维表格的读取权限。
- **钉钉**：准备有源表读取权限的企业内部应用和操作人 ID。
- 表格的分享链接。

页面上的「如何创建应用并开通权限？」和「如何给应用授予表格访问权限？」提供具体指引。应用密钥只在服务端加密保存。

## 创建同步

**选择来源**

点「接入飞书多维表格」或「接入钉钉 AI 表格」。

**配置应用授权**

填写应用授权名称和应用凭证。已保存过的应用可以直接复用，无需再次输入 Secret。

**读取表格并选择子表**

粘贴表格分享链接，点「读取表格」，勾选要同步的子表，可以多选。

**选择目标工作簿和频率**

选择已有工作簿，或新建工作簿。同步频率可选「仅手动」「每小时」「每天 08:00（北京时间）」。点「保存并同步」。

## 日常管理

- 点「立即同步」手动同步；「暂停计划」和「恢复计划」控制定时同步。
- 列表显示每个同步任务的状态、最近同步时间和行数。
- 同步的工作表在工作簿中标为「来源同步 · 只读」，不能在 AskTable 中编辑。需要修改数据时，在飞书或钉钉中修改，再同步。同一工作簿中手动创建的工作表不受影响。
- 删除不再使用的应用授权：「移除未使用授权」。

从旧版「从飞书多维表格同步」创建的工作簿，升级后自动保留原有配置、子表绑定和数据，统一在连接器中管理。直接调用旧飞书同步 API 的集成方需改用统一连接器接口。

## 常见问题

| 提示          | 原因                   | 处理             |
| ----------- | -------------------- | -------------- |
| 应用或操作人无读取权限 | 应用没有开通表格的读取权限        | 在飞书或钉钉中给应用授权   |
| 应用凭证无效      | App Secret 等凭证错误或已更换 | 在「设置」中更新凭证     |
| 来源已删除或不可访问  | 原表格被删除或分享链接失效        | 重新选择来源         |
| 来源响应不完整     | 来源服务返回异常；原有数据已保留     | 稍后重试           |
| 同步超时        | 数据量大或网络慢             | 重新同步           |
| 同步失败        | 来源权限或字段数据有问题         | 检查来源权限和字段内容后重试 |