WhatsApp 商品目录配置指南：添加本地商品价格库存、建立商品集合并在聊天中发送卡片
商品目录让工作区管理自己的商品，并把商品直接发送到 WhatsApp 聊天中 — 可以是单个商品卡片、多商品列表、轮播，或一条普通的目录链接。入口在 More → WhatsApp Catalog（Integrations 页面也有入口）；该页面仅限管理员访问。
本篇内容
概览
商品目录让工作区管理自己的商品，并把商品直接发送到 WhatsApp 聊天中 — 可以是单个商品卡片、多商品列表、轮播，或一条普通的目录链接。入口在 More → WhatsApp Catalog（Integrations 页面也有入口）；该页面仅限管理员访问。
商品目录是独立区域 — 有意不放在品牌商店里面。它包含四个标签页：
| 标签页 | 用途 |
|---|---|
| 设置（Setup） | 查看目录就绪状态、已连接设备摘要与快捷统计（商品、店铺、最近发送），并进入商品管理。 |
| 发送（Send） | 向任意手机号发送商品（无需已有会话）。 |
| 集合（Collections） | 保存可复用的商品分组，一键把任意一组作为多商品消息发送。 |
| 动态（Activity） | 最近的目录发送日志。 |
WhatsApp 协议连接的本地目录：商品保存在你的工作区中，通过 WhatsApp 协议连接直接发送 — 单商品卡片、多商品列表/轮播或目录链接，商品资料由工作区管理，发送仍需遵守相应平台规则。
套餐限制：商品目录属于 品牌商店（Storefront）套餐功能。套餐不含该项时，页面会显示升级提示，且无法添加或编辑商品。平台管理员不受此限制。
应用账号、本地目录与结账
当前仅支持 WhatsApp 应用账号（Business App / 个人版）。使用工作区商品资料与本地集合，按支持的格式分享商品卡片、轮播或目录链接。
商品目录负责展示；品牌商店承接结账；自有商户网关提供托管付款页，并通过回调确认支付结果。商品管理、订单与付款分别保留状态。见商品目录与品牌商店。
前置条件
需要哪些条件取决于你的发送方式：
| 目标 | 要求 |
|---|---|
| 发送目录本身 | 至少一个已连接的 WhatsApp 设备。在 Devices 页面连接一个 WhatsApp 协议连接号码（扫码或配对码，免费）。 |
| 轮播 / 列表 / 单商品发送 | 仅需已连接设备。轮播等商品消息通过 WhatsApp 协议连接 发出，无需任何外部账号。 |
| 可发送的商品 | 状态为 Active 的商品（进入发送选择器还需有库存）。商品在品牌商店中管理。 |
设置标签会根据情况自动切换：
| 情况 | 看到什么 |
|---|---|
| 没有设备 | 显示「请先连接设备」的提示，链接到 Devices 页面。 |
| 已连接 WhatsApp 协议连接设备 | 显示「就绪，可发送」卡片 — 轮播发送立即可用；卡片下方是已连接设备摘要与快捷统计（商品、店铺、最近发送）。 |
添加与管理商品
商品在品牌商店中管理（设置标签通过 Manage products 链接过去）。打开 Add product 即可创建商品。同一个商品会出现在本地目录、品牌商店与发送选择器中。
字段参考
| 字段 | 必填 | 限制 / 规则 | 含义 |
|---|---|---|---|
| 名称 | 是 | 最长 191 | 商品标题，也会生成商品的网页链接。 |
| SKU | 否 | 最长 96 | 你自己的商品编码，用于在内部系统之间对照同一商品。 |
| 简短描述 | 否 | 最长 2000 | 显示在目录卡片与 WhatsApp 分享链接中。 |
| 完整描述 | 否 | 最长 65535 | 商品详情页正文（支持基础格式）。 |
| 价格 | 是 | 0–1,000,000 | 销售价。 |
| 划线价 | 否 | 0–1,000,000 | 可选的「原价」，高于售价时以删除线显示。 |
| 币种 | 是 | 21 个代码之一 | INR、USD、EUR、GBP、AED、KES、NGN、ZAR、BRL、MXN、CRC、PHP、IDR、SGD、MYR、THB、VND、EGP、PKR、BDT、LKR。 |
| 图片（上传） | 否 | 图片，最大 4 MB | 主图。 |
| 图片 URL | 否 | 链接，最长 1024 | 也可以不上传，直接粘贴图片直链。建议使用 1024×1024 px 或更大的正方形（1:1）图片。 |
| 相册 URL | 否 | 最多 12 个链接 | 商品详情页的附加图片（自动去重，最多 12 张）。 |
| 可售（有库存） | 否 | 开 / 关（默认开） | 库存开关。关闭后商品会从品牌商店与发送选择器中隐藏。 |
| 库存数量 | 否 | 0–1,000,000 | 库存计数（留空 = 不限）。 |
| 重量（克） | 否 | 0–1,000,000 | 用于运费计算。 |
| 分类 | 否 | 最长 96 | 自由文本分类（带建议）。用于发送选择器分组与商店筛选。 |
| 标签 | 否 | 最长 1024 | 逗号分隔；会整理为去重列表。 |
| 状态 | 否 | Active / Draft / Archived（默认 Active） | Active = 上架；Draft = 隐藏但可编辑；Archived = 隐藏但保留记录。 |
| 排序 | 否 | 0–9999 | 数字越小越靠前。 |
可用性与库存
「可售（有库存）」开关关闭或库存数量为 0 时，商品会从品牌商店与发送选择器中隐藏；状态为非 Active 的商品同样不会出现在发送选择器里。库存数量留空表示不限库存。
商品导购（自动回复）
设置标签中有一张 Automation 卡片，可让商品目录自动回应商品咨询。这里的设置保存后立即生效，无需任何审核。
商品导购
当客户输入商品相关的问题 — 例如 「2000 元以下的红色鞋子」 — 商品导购会解析其意图（关键词加价格范围），搜索你的商品，并自动回复一条匹配的多商品消息（WhatsApp 协议连接轮播 / 多商品列表）。它默认关闭，只在真正的商品问题上触发，对同一个人两次回复之间间隔 30 秒以防轰炸；没有匹配结果时默认保持安静，除非你主动开启回复。
| 设置 | 效果 |
|---|---|
| 商品导购 | 开 / 关（默认关）。 |
| 回复标题 | 自动回复的标题（例如「为你找到以下商品」）。 |
| 最大商品数 | 最多显示多少个匹配结果（1–30）。 |
| 无匹配时回复 | 默认关闭；开启后会发送一条「没有找到匹配商品」的提示。 |
商品导购会搜索名称、分类、品牌与描述，优先展示最相关的匹配，并遵循价格范围（「以下」「以上」「X 到 Y 之间」）。发送多商品消息需要至少一个已连接的设备。
商品集合（商品分组）
集合标签让你把一组商品保存为命名且可复用的分组 — 例如夏季特惠或热销榜 — 之后随时作为多商品消息发送，不必每次重新挑选。
- 用可搜索的商品选择器创建 / 编辑 / 删除集合（最多 30 个商品，即 WhatsApp 多商品消息的上限）。
- 每个集合显示其商品缩略图与数量。
- 直接在卡片上把集合发送给任意手机号 — 与发送标签的商品列表格式相同。
- 发送时会拉取最新的商品详情，因此之后被编辑或移除的商品也能保持一致。
集合属于你的工作区，商品按你添加的顺序发送。
向客户发送商品
发送标签是一个四步表单，用于向未必先给你发过消息的人发送商品（请遵守 WhatsApp 的使用规则）。它的操作与营销活动构建器类似，各步骤会很容易上手。
- 收件人 — 从联系人分组、单个联系人或手动号码中选择（每行一个、逗号或分号分隔粘贴；仅数字，至少 8 位）。实时计数器显示去重后的总数。每次发送上限为 500 个收件人。
- 格式与发送方 — 选择发送格式（见下）以及从哪台已连接设备发送（或让 WAthink 自动选择在线设备）。也可以选择一个店铺作为上下文。
- 商品 — 商品按所选店铺的分类分组显示。搜索并勾选要发送的商品。切换店铺会立即刷新选择器。
- 消息与发送 — 添加可选的消息（最长 1024 字符）、可选的页眉与页脚（各最长 60），然后发送。侧边面板会汇总收件人、商品与格式。
发送格式
| 格式 | 客户看到什么 | 商品数 |
|---|---|---|
| 单个商品 | 一张富商品卡片。 | 1 个商品 |
| 商品列表 / 轮播 | 可滚动的多商品列表或轮播。 | 最多 30 个商品 |
| 目录链接 | 一条带目录链接的纯文本消息 — 无需选择商品。 | — |
工作原理
对每个收件人，WAthink 会查找或新建会话，因此发送完成后会出现在团队收件箱对应聊天中，并记录在动态标签。发送通过已连接的 WhatsApp 协议连接完成。之后你可以看到成功数、失败数与前几条失败原因。
发送规则与号码安全：单商品与商品列表格式会向对方发送富消息，请确保对方已订阅（opt-in），并配合发送规则（节奏、每日上限、活跃时段）保护号码。目录链接格式为纯文本，随时可用。发送前至少需要一个已连接设备，两种商品格式还至少需要选择一个商品。
活动日志
动态标签列出工作区最近的目录发送，显示目标号码与发送时间（距今多久），方便快速回看。发送标签的侧边面板会显示同一列表的精简版。
故障排查
| 症状 | 原因与解决 |
|---|---|
| 设置页提示「请先连接设备」 | 没有已连接设备。在 Devices 页面扫码或输入配对码，免费连接一个 WhatsApp 协议连接号码。 |
| 发送返回「没有收件人」 | 所有来源都没有给出有效号码。号码必须仅含数字且至少 8 位；请选择分组/联系人或粘贴带国家代码的号码。 |
| 发送返回「数量过多」 | 超过 500 个收件人的上限。请拆分为更小的批次。 |
| 发送返回「没有商品」 | 单商品与商品列表格式至少需要一个已选的 Active 商品；目录链接格式不需要。 |
| 商品消息没有送达 | 设备可能掉线或触及发送限制。请检查设备是否在线、辅助服务是否运行，并放慢发送节奏后重试。 |