Shopify 店铺连接 WhatsApp 指南：完成应用授权、同步商品客户订单并排查弃购数据异常

概览

Shopify 集成会把店铺的订单、商品、客户与弃购结账带进 WAthink，让你在 WhatsApp 上召回弃购、确认订单并支持买家 — 订单上下文就在聊天和你的销售管道里。把它与 WhatsApp 商品目录、自动发票和支付链接配合使用，即可在会话内完成销售、开票与收款。

位置：Integrations → Shopify。它与 WooCommerce 及通用的电商与 CRM集成并列。

集成如何工作

• WAthink 通过 Shopify 的 Admin API 与你的店铺通信，使用与一组 scopes（读取权限）绑定的访问令牌进行认证。
• 连接时会执行一次初始同步，导入最近的商品、客户与订单，使它们立即可用作商品、联系人与商机。
• 此后，Shopify 的 webhook 会把新订单、订单更新、新客户与弃购结账通知 WAthink，无需轮询即可保持数据最新。
• 连接以店铺为单位：每个店铺单独完成一次 OAuth 授权；同一工作区可以连接多个店铺，各自独立同步、独立管理。
• 所有数据都限定在你的工作区内；每个同步的客户都会成为 WAthink 联系人，可以发消息和分群。

凭据：管理员配置应用，商家只需连接

WAthink 中的 Shopify 使用 OAuth，而不是粘贴令牌。平台管理员只需注册一个 Shopify 应用并保存其凭据；之后每个商家只需输入店铺域名并在 Shopify 授权页确认即可完成连接。WAthink 中无需复制或粘贴任何 Admin API 令牌。

平台管理员 — 一次性配置

1. 创建 Shopify 应用。在 Shopify Partner Dashboard（partners.shopify.com）创建一个应用，获取 Client ID（API key）与 Client Secret（API secret key）。
2. 设置重定向（回调）URL为 WAthink 的 Shopify OAuth 回调地址（在 WAthink 管理后台中查看）。
3. 申请集成所需的 scopes — 至少包含 read_orders、read_customers、read_checkouts（弃购结账）和 read_products；如需订单状态回写，再加上 write_orders。
4. 通过 Shopify CLI 添加强制性的 GDPR 合规 webhook。见下方分步说明。Shopify 在 App Store 审核前要求这些 webhook，而新版 Dev Dashboard 没有对应 UI 字段 — 必须在应用的 shopify.app.toml 中声明，并用 CLI 推送一次。
5. 在 WAthink 管理后台填入凭据。填写 shopify_client_id、shopify_client_secret、shopify_scopes 和 shopify_redirect_uri，然后启用 Shopify（shopify_enabled）。所有工作区共用这些凭据 — 商家不会看到它们。

强制 GDPR webhook — Shopify CLI（一次性）

Shopify 要求三个 GDPR 合规 webhook，否则安装会静默失败，应用审核检查也会一直显示未通过。新版 Dev Dashboard 没有对应 UI 字段 — 它们要在应用的 shopify.app.toml 中声明，并用 Shopify CLI 推送一次。这是一次性设置，后续无需继续使用 CLI。

1. 安装 CLI：
   复制

   npm i -g @shopify/cli@latest

2. 关联应用 — 出现提示时选择这个应用；它会写入 shopify.app.toml：
   复制

   shopify app config link

3. 把下面的配置块加到该文件中，并把 URL 换成你自己的（可从 WAthink 管理后台 → Settings → Shopify 第 5 步复制）：
   复制

   [webhooks]
   api_version = "2026-07"
   
     [[webhooks.subscriptions]]
     compliance_topics = [ "customers/data_request", "customers/redact", "shop/redact" ]
     uri = "https://YOUR-DOMAIN/shopify/compliance"

4. 推送：
   复制

   shopify app deploy

三个主题都指向那一个固定 URL。与按店铺的订单 webhook 不同，它的路径中不含密钥 — 这是有意为之，好让 Shopify 的自动审核在任何店铺安装应用之前就能访问它。

每次投递都会被校验。Shopify 使用你的 Client Secret 对每个请求做 HMAC-SHA256 签名。WAthink 校验 X-Shopify-Hmac-Sha256 请求头：不匹配返回 401，成功返回 200，然后执行该请求（删除对应客户或店铺的已存数据）。这刚好满足 Shopify「Verifies webhooks with HMAC signatures」检查项。

跳过这一步，应用无法通过审核。自动检查会在「Provides mandatory compliance webhooks」与「Verifies webhooks with HMAC signatures」两项失败，安装也会静默失败且没有可见错误。

商家 — 按店铺连接

1. 在 WAthink 打开 Integrations → Shopify。
2. 输入店铺域名（your-store.myshopify.com）— 这是唯一需要填写的字段。
3. 点击 Connect — 会跳转到 Shopify 的授权页；确认请求的 scopes。
4. 完成。Shopify 重定向回 WAthink，WAthink 校验 HMAC + state，并自动把授权码换成永久访问令牌，保存在你的集成下。你无需处理任何令牌。

受保护的客户数据。订单、客户与弃购结账包含个人数据。Shopify 要求访问这些数据的应用获得受保护客户数据权限批准 — 弃购结账数据尤其需要。这由管理员在 Shopify 应用上一次配置，不需要每个商家单独设置。

API 限制与规则

连接你的店铺

1. 打开 Integrations → Shopify，输入店铺域名开始连接。
2. 在 Shopify 上确认 OAuth 授权 — 无需粘贴令牌；重定向回来后 WAthink 会自动收到访问令牌。
3. WAthink 订阅店铺 webhook — 订单创建/更新、客户创建，以及结账（弃购）。
4. 初始同步导入最近的商品、客户与订单，连接后立即可用。

内嵌应用会话说明。如果你在 Shopify 管理后台内嵌的 iframe 中打开 WAthink，浏览器要求会话 cookie 为 SameSite=None; Secure，否则会在跨站框架中被丢弃 — 表现为 419 / 登录循环。WAthink 会为内嵌场景设置该属性，确保操作无需反复登录。

同步内容

使用方式

• 订单通知与更新。用可复用的消息内容作为模板，通过 WhatsApp 发送订单/发货更新（下单、已发货、已送达、取消、退款等），按账号授权与发送条件执行。
• COD 确认。新的货到付款（COD）订单会在 WhatsApp 上请买家确认：回复 Yes 推进订单，回复 No 取消订单；两种结果都会把订单状态写回 Shopify 与 WAthink。
• 缺货提醒。售罄商品补货后，自动通知该商品等待名单上的客户。
• 弃购召回。向留下商品未结账的客户发送结账链接 — 可以手动、通过流程，或对符合条件的分群做广播；多步召回按计划依次跟进。
• 结账链接。在聊天中重发订单的结账/支付链接（例如 COD → 预付提醒），让客户直接在线完成付款。
• 状态回写。在 WhatsApp 中处理的订单确认与状态变更会同步回 Shopify 订单（需要 write_orders scope）。
• 上下文内客服。客户发来消息时，其最近订单会显示在会话中，客服无需切换标签页。
• 管道与收入。把高价值订单或回头客转成商机，并让 AI 客户管理助手基于它们生成报告。

故障排查