WooCommerce 订单通知设置指南：连接 WordPress 店铺事件、配置消息模板与 PDF 发票链接
连接已授权的 WooCommerce 店铺，接收订单与状态变化事件。按已开启的自动化选择消息模板、变量和接收对象；发票链接取决于插件与订单资料，缺少 PDF 时按实际返回的订单入口处理。
本篇内容
把你的 WooCommerce 店铺连接到 WAthink，通过已配置的 webhook 接收订单及状态变化事件。按已开启的自动化、模板与接收对象安排 WhatsApp 消息；发票链接取决于店铺插件和实际返回的订单资料。无需轮询，无需手动导出。
一句话说明工作原理：WooCommerce 触发 webhook → WAthink 将其匹配到你为该订单状态开启的自动化 → 通过 WhatsApp 发送你选择的模板，并填入 {{invoice_url}} 等实时订单变量。
第 1 步 — 连接你的店铺
使用 WooCommerce 自带的 REST API 密钥连接 — 无需编码。
- 在 WordPress 管理后台，进入 WooCommerce → Settings → Advanced → REST API，点击 Add key。
- 填写描述，把权限设为 Read/Write，点击 Generate API key。复制 Consumer key 和 Consumer secret。
- 在 WAthink 中打开 WooCommerce，点击 Connect。输入 Store URL、Consumer key 和 Consumer secret，然后 Test 并 Save。
保存时，WAthink 会自动在你的店铺上注册订单 webhook（order.created、order.updated 等），并为你的店铺生成唯一的 webhook secret，确保只有你的店铺能向你的 WAthink 端点投递。
你的 webhook 端点是 https://your-wathink-domain/woocommerce/webhook/<secret>。WAthink 会为你设置好；使用自动连接时，你无需在任何地方手动粘贴它。
第 2 步（推荐）— 安装配套插件
WooCommerce 的 REST webhook 无法发送所有内容 — 尤其是 PDF 发票链接和一些额外订单字段。可选的 WAthink 配套插件填补了这个空缺。
- 在 WAthink 的 WooCommerce 页面点击 Download plugin。ZIP 已预配置好你店铺的 webhook URL 和 secret — 无需编辑。
- 在 WordPress 中进入 Plugins → Add New → Upload Plugin，上传 ZIP 并 Activate。
当店铺已生成 PDF 发票且配套插件返回对应地址时，{{invoice_url}} 可指向该 PDF；未取得 PDF 地址时，按实际返回的订单资料核对链接。
第 3 步 — 开启你的订单自动化
在 WAthink 的 WooCommerce 页面，每个事件都有独立的一行。打开你需要的行，选择 WhatsApp 模板，映射变量，并选择发送对象。可用事件：
- 订单生命周期 —
order placed、processing、completed、on-hold、cancelled、refunded、failed。一笔订单在状态间流转时，按已开启的事件、模板与发送条件安排对应消息，并查看实际执行结果。 - 货到付款（COD） —
COD confirm（请客户确认）、COD → prepaid（提醒在线支付），以及针对可疑 COD 订单的风险评分。 - 补货提醒 — 通知加入商品等待名单的客户。
- 弃购 — 多步召回提醒。
- 赢回和评价奖励广播。
每个事件可以设置：
- Template — 选择要发送的模板消息。
- Send to —
customer、admin或both（带管理员号码）。 - Delay — 发送前等待 N 秒（例如已完成的订单 1 小时后跟进）。
- Variable map — 把模板占位符绑定到订单字段。
发送发票（{{invoice_url}}）
订单下单或完成时，可按已开启的自动化与模板，通过 WhatsApp 分享发票或订单链接。
- 每个订单自动化都会提供变量
{{invoice_url}}。把它放进模板（作为链接，或放在媒体/文档按钮上），WAthink 会按订单填充。 - 它指向什么：当店铺插件返回已生成的 PDF 发票地址时，指向对应的 PDF 发票 — 例如 WooCommerce PDF Invoices & Packing Slips、Print Invoices 或 YITH — 由 WAthink 配套插件转发。未取得 PDF 发票时，可按返回资料使用客户的订单页面；该入口不等于 PDF 发票，发送前应检查实际链接及可访问内容。
- 配套字段
{{invoice_is_pdf}}在链接是直接 PDF 时为1，为订单页面时为0— 便于你想用不同措辞发送消息时使用。
典型配置：开启 order completed → 模板 “感谢下单！这是你的订单资料：{{invoice_url}}” → 发送给 customer。先用测试订单核对消息、链接和执行记录；确认链接实际指向 PDF 发票后，再在模板中称为发票。
你可以使用的订单变量
除了 {{invoice_url}}，订单自动化还会向模板暴露常见的订单字段 — 例如客户姓名、订单号与总额、币种、状态和订单 URL。在事件的 Variable map 中把它们绑定到模板占位符。流程构建器的 WooCommerce 触发器同样可以使用这些变量，因此你可以在自动化中分支并跟进，而不只是发一条消息。
验证是否正常
- 在 WooCommerce 中下一笔测试订单（或把现有订单移到你已开启的状态）。
- 核对客户号码收到的消息与实际链接，确认它指向 PDF 发票还是订单页面；未收到消息时，结合活动日志排查发送结果。
- 查看 WAthink WooCommerce 的活动日志 — 每个收到的 webhook 及其触发的消息都有记录，你可以清楚看到触发了什么。
测试请使用你控制的真实号码 — 这些是真实的 WhatsApp 发送。
故障排查
- 订单没有消息 — 确认事件行已开启并选中了模板、店铺的 webhook 仍然有效（WooCommerce → Settings → Advanced → Webhooks），且订单上有客户手机号。
{{invoice_url}}显示订单页面而不是 PDF — 安装 PDF 发票插件和 WAthink 配套插件；没有它们，WooCommerce 没有可链接的发票文件。- 连接测试失败 — 重新检查 Store URL（必须可经 HTTPS 访问）以及 REST 密钥权限为 Read/Write。
- 消息重复 — 状态变更自动化每个状态触发一次；确认你没有为同一次流转同时开启通用模板和按状态模板。