2. 飞书连接

更新于 2026/10/30

这一篇从建表开始，直到店智效能读到表里的字段。先建商品表，再创建读取资料的应用，最后把两者连接起来。截图使用真实页面，个人资料、文件夹名称、应用身份与凭据均已遮挡；点击图片可以放大。

1.1 新建表格

登录后进入飞书云文档。先从左侧打开“云盘”，在自己的文件夹中创建商品表。

点击“新建”，选择 “多维表格” 。菜单里的普通“表格”是另一种文档，不能当作本教程的多维表格使用。

出现模板选择页后，先核对上方“新建到”的位置，再点击“新建多维表格”，从空白表开始。不需要先购买模板，也不需要先用 AI 生成整张表。

新建位置选云盘中的“我的文件夹”或自己的普通文件夹。 从首页直接新建到“我的文档库”等知识库位置，可能得到 /wiki/ 地址；当前店智效需要 /base/ 的多维表格地址。建好后检查地址类型，不要把链接中的 wiki 手动改成 base，两种地址后面的标识不是同一个东西。

1.2 建字段填资料

打开空白表，点击顶部标题，改成便于识别的名称，例如“商品上新资料”。左侧的“数据表”是这份多维表格里面实际存记录的表，可以按商品类型命名。上方“表格”是视图，控制当前怎样展示、筛选同一张数据表，不是另一份独立商品数据。

图中①为整份多维表格名称，②为其中的数据表，③打开字段配置，④新增字段。选择数据表后，点击“字段配置 → 新增字段”，填写列名、选择字段类型并确定；表头右侧的“＋”也可新增字段。

先建立能表达商品资料的基础列。下面是建表示例，最终必填字段和映射方式按淘宝 / 天猫或 1688文档配置。

字段示例	建议类型	用途
货号	文本	同一商品的各个 SKU 使用同一货号；用文本保留前导零和横杠
标题	文本	商品标题；同款各行保持一致
类目	文本或单选	对应实际平台类目；两个平台可分别建列
颜色、尺寸	分别建文本或单选列	一行填写一种实际存在的规格组合
SKU 编码（选填）	文本	按需建立，用于自己的规格编码管理；不使用时可不建列，不能代替货号
售价	数字	填数值，不把“元”“起”“包邮”写进去
库存	数字，整数	每个 SKU 的实际库存；也可按平台文档使用店智效固定库存

一个 SKU 一行，同一货号可以有多行。 例如同款两个尺码：

货号	标题	颜色	尺寸	SKU 编码（选填）	售价	库存
SP-001	示例商品标题	黑色	小号	SP-001-01	12.90	100
SP-001	示例商品标题	黑色	大号	SP-001-02	15.90	80

这是资料结构示例，请换成自己的真实商品。**淘宝、天猫、1688 的 SKU 编码均为选填，不要求每个商品都提供编码。**不要在一格里堆多个 SKU，不要合并货号单元格；每行都填完整货号、规格和该行价格。列名可以自己定，后面在店智效里选择对应列即可。

飞书会保存表格修改。完成后确认已保存到云端；填表只是在准备资料，不会发布商品。

1.3 创建读取应用

你登录飞书后能看到表格，不代表店智效也能读取。店智效使用自建应用的身份访问飞书，所以还要准备应用凭证，并授予它读取能力和这张表的访问权。

打开飞书开发者后台，使用与商品表相同企业／组织下的账号。选择“企业自建应用 → 创建企业自建应用”，填写名称和描述，例如“商品资料读取”，选择图标后创建。已有专门用于商品表的应用可以复用，不必每张表都建一个。

进入应用的“凭证与基础信息”，找到 App ID 和 App Secret 。后面需要把这一对凭证填进店智效，不能把两个不同应用的凭证混在一起。

App ID 用来标识应用，App Secret 用来证明调用方有权使用这个应用。截图、公开教程和发给他人的排查信息中不要展示真实 Secret；不要为了截图点击显示密钥。

1.4 开通应用权限

在刚才的应用中打开“权限管理 → 开通权限”，选择 应用身份权限（tenant_access_token） ，搜索 bitable:app:readonly，勾选“查看、评论和导出多维表格”，确认开通。

这一步允许应用使用读取多维表格的功能。不要只开在“用户身份权限”下，也不需要为了普通上新把无关权限全部勾上。

随后进入“版本管理与发布”。如果当前改动还未发布，点击“创建版本”，填写版本号和更新说明，按页面完成保存、提交发布；需要企业管理员审批时，等审批通过。免审与否以当前页面提示为准，不能把“已创建版本”当成已经生效。

最终检查权限已经生效、应用可用、需要发布的改动已经发布。截图中的现有版本和应用能力只是界面示例；读取商品表不要求照搬其他应用的机器人能力或权限。

如果以后要使用店智效中“给飞书新增字段”的功能，再按该功能提示开通新增字段所需的写入权限，并给表格相应编辑权限。 单纯读取商品资料，先完成读取权限即可。

1.5 给表格授权

回到刚创建的商品表，给 同一个自建应用 添加文档访问权。开通 API 权限只解决“能使用读取功能”；添加文档应用才解决“允许读取这张表”。两步缺一不可。

当前页面可从右上角“⋯ → 更多 → 添加文档应用”进入。若你的版本在“文档权限 → 管理协作者”中提供应用入口，也可以从那里添加，最终要确认添加的对象是自建应用。

在“文档应用”窗口搜索自己刚创建的应用名称，核对所属组织并选择。 应用名称只是帮助查找，最终必须与店智效使用的 App ID 属于同一应用。 搜不到时，先检查是否选错企业、应用是否已经可用，以及自己是否有管理当前文档的权限。

选择应用后检查权限。普通读取商品资料使用“可阅读”；页面默认给了更高权限时，点权限下拉框改为“可阅读”，再点击窗口底部“添加”完成授权。随后重新打开“已添加应用”，确认应用和权限都已保存。需要实际写入字段时再调整为对应权限，不要把表格设置成互联网公开可编辑。

如果表格还启用了高级权限，继续核对应用对目标数据表、记录与字段的可见范围。应用能进入这份多维表格，但看不到目标数据表或部分记录，也会影响店智效取数。

1.6 获取表格链接

在多维表格左侧选中存商品资料的那张数据表，再复制浏览器地址栏的完整链接。右上角“分享 → 复制链接”可以获取文档链接，但仍要检查它是否指向需要的数据表。

店智效需要的结构类似下面这样，示例中的占位文字不要直接填入店智效：

https://你的企业.feishu.cn/base/多维表格标识?table=数据表标识&view=视图标识

base 后面对应整份多维表格，table 对应其中的一张数据表，view 对应视图。普通文档链接、收集表分享链接、首页链接以及 /wiki/ 链接不能直接替代当前店智效需要的地址。

新手按第 1 步从云盘普通文件夹创建，即可得到 /base/ 类型地址。已经在知识库里存了真实资料时，不要随意移动、删除原表，也不要手改标识；先确认能提供正确的独立多维表格地址后再接入。

1.7 连接店智效

打开店智效，进入要使用的平台 →“自动上新 → 配置”。

按图中顺序完成：

在①“多维表格链接”粘贴刚才的完整链接。
在②、③填写同一应用的 App ID、App Secret。
点击④“读取飞书字段”，等待读取结果；失败时先按提示处理，不跳过。
核对⑤“选择多维表／数据表”显示的表名是否正确，确认基础字段的下拉框能看到自己建的货号、标题、类目等列。
点击⑥“保存配置”。随后进入对应平台文档，完成基础字段映射与类目配置。

店智效读取字段，是取得这张表的列名和字段信息，供你选择映射；不是把表里全部商品立刻发布。切换到另一张数据表后，重新核对字段映射，不能只看表名已经换了。

1.8 连接排查

现象	先检查什么
链接无效或缺少表标识	是否为 `/base/` 链接，是否选中正确数据表并保留 `table` 参数；不要用首页或 `/wiki/` 地址
应用凭证错误	App ID 与 Secret 是否来自同一应用；复制时有没有空格、漏字符，Secret 是否已被重置
提示缺少应用权限	权限是否开在“应用身份”下；当前所需权限与版本是否已经生效
没有文档访问权	是否把同一个应用添加到这份表，是否有可阅读权限；高级权限是否允许目标表和记录可见
字段下拉没有需要的列	是否选错数据表；飞书新建或修改字段后，重新读取字段并核对映射
后续上新找不到某个货号	连接成功之后，再查目标数据表是否真的包含该货号的全部 SKU，货号写法是否完全一致

到这里，应当能看到正确的数据表和字段。继续阅读3. 淘宝 / 天猫或 4. 1688，在各自平台中完成商品准备、类目配置与发布。