BaoPush 设置教程

BaoPush 通过飞书开放平台将内容写入你的多维表格。配置分三步：创建飞书应用 → 绑定目标多维表 → 配置字段映射。

第一步：创建飞书应用，获取 App ID 和 App Secret

BaoPush 需要一个飞书企业自建应用来调用多维表格 API。

1. 打开飞书开放平台，点击右上角开发者后台。
2. 点击创建企业自建应用，填写应用名称和描述（名称自定义，不影响功能）。
3. 进入应用后，点击添加应用能力 → 选择机器人。
4. 点击左侧权限管理 → 开通权限，搜索并开通以下权限：
   • bitable:app — 读取和写入多维表格
5. 点击上方创建版本，填写版本号后保存 → 申请线上发布。
6. 前往飞书管理后台（网页版右上角九宫格图标）审批该应用，通过后回到开发者后台确认发布状态。
7. 点击左侧凭证与基础信息，复制 App ID 和 App Secret。

第二步：在 BaoPush 添加飞书凭证

1. 打开 BaoPush 设置页，切换到飞书凭证 Tab。
2. 点击添加凭证，输入上一步获取的 App ID（格式如 cli_xxxxxxxxxx）和 App Secret。
3. 点击添加，凭证创建后默认处于启用状态。

App Secret 不会以明文存储。如需停止使用某组凭证，可随时将其禁用或删除。

第三步：准备飞书多维表，获取 Base App Token 和表格 ID

在飞书中打开你想要写入的多维表格（或新建一张），查看浏览器地址栏，根据链接格式选择对应方式。

方式一：旧版链接（/base/ 格式）

https://your-company.feishu.cn/base/{baseAppToken}?table={tableId}&view={viewId}

• Base App Token：URL 中 /base/ 后面的字符串，直接复制即可。
• 表格 ID：URL 中 table= 后面的参数值。

方式二：新版 Wiki 链接（/wiki/ 格式）

https://my.feishu.cn/wiki/{wikiNodeToken}?table={tableId}&view={viewId}

• 表格 ID：URL 中 table= 后面的参数值，直接复制即可。
• Base App Token：/wiki/ 后面的是节点 Token，需通过飞书 API 换取，步骤如下：
  1. 打开飞书开放平台的在线 API 调试页面。
  2. 在页面右侧在线调试区域，找到 token 参数，填入 /wiki/ 后面的字符串（如 Jv33wfTUqiPqWDkw0A2cpDKlnlh）。
  3. 选择你的应用凭证后点击发送请求。
  4. 在返回结果中找到 obj_token 字段的值，这就是 Base App Token。

第四步：将多维表共享给机器人

飞书应用（机器人）默认无法访问你的多维表格，需要通过群聊将文档权限授予机器人。

1. 在飞书中创建一个群聊（群成员可以只有你自己）。
2. 将你要写入的多维表格分享到该群聊，并将群内权限设为可编辑。
3. 打开飞书手机 App，进入该群聊 → 点击右上角群设置 → 群机器人 → 添加机器人，选择你在第一步创建的飞书应用。

添加机器人后，该应用即拥有群内共享文档的编辑权限，BaoPush 才能正常写入多维表格。

第五步：在 BaoPush 添加目标多维表

1. 切换到目标多维表 Tab，点击添加目标多维表。
2. 填写以下信息：

3. 点击添加完成绑定。

第六步：配置字段映射

字段映射决定推送内容的哪些数据写入多维表格的哪个字段。

1. 在目标多维表列表中，点击某条目标的字段映射按钮。
2. 点击添加映射，配置每条映射：

3. 添加完成后映射立即生效，之后的每次推送都会按照映射写入对应字段。

字段名称必须与飞书多维表格中的列名完全一致，否则写入会失败。建议直接从飞书复制列名粘贴过来。

下一步

配置完成后，选择你的设备开始使用：

• Android 使用教程 — 通过系统分享、悬浮窗或快捷磁贴推送内容
• iOS 快捷指令教程 — 通过快捷指令将内容一键推送到飞书多维表