WhatsApp 订单状态自动化
WhatsApp 订单状态自动化会用店铺自身系统中的实时数据回答“我的订单在哪里?”。关键词步骤识别这个问题,Webhook 把消息和客户的电话号码发送到店铺后端,后端再把状态作为回复返回。店铺主动发出的发货更新,则以已获批准的实用类消息模板发送。
easyCoexistence 通过 Coexistence,把您店铺已在应用中使用的 WhatsApp Business 号码连接到 Meta 的 Cloud API。
店铺后端须在此时限内返回回复,超时后 Webhook 步骤失败,您会收到邮件通知。
客户的 WhatsApp 号码以国际格式的数字发送,随消息一同传给后端,便于按电话号码查找订单。
最长的回复以一条 WhatsApp 文本消息发送,超出部分会被截断。
Meta 对订单确认和发货通知的分类:非推广性质,且针对客户的具体订单。
Meta 将把订单更新与推广内容配对的模板视为营销消息。
Coexistence 号码的 Meta 固定吞吐量,是一批发货更新集中发送时的上限。
自动化的订单状态回复如何运作?
状态信息保存在您的店铺系统中,因此自动化的任务是把问题送到那里,再把答案送回来。关键词自动化会识别订单相关问题,其“Call my webhook”步骤把问题发送到您的后端,后端的答复则通过您的 WhatsApp Business 号码发出。easyCoexistence 不保存订单数据:运行日志保留消息和回复 30 天,您的店铺仍是权威数据来源。同样的查询也可以使用“Call an API”步骤,它会直接调用您店铺的 API,并为后续步骤保留其 JSON 答复。
哪些消息应当触发查询?
订单相关问题很容易通过用词识别,因此适合使用关键词自动化。可以从“Send to my system”开始,将其触发器改为“Has keyword”并选择“Contains”,或从“Keyword reply”开始,并将其步骤替换为“Call my webhook”。请用您经营的每种语言添加关键词,最多 30 个。其他问题会交由您的其他自动化处理,例如在“Every message”上设置的 AI 智能体,因为关键词自动化会优先检查,且每条消息只由一个自动化回复。
- 英语:order、tracking、delivery、shipped、where is my。
- 葡萄牙语:pedido、rastreio、rastreamento、entrega、encomenda。
- 西班牙语:envío、envio、seguimiento、paquete(pedido 和 entrega 已列出)。
- 符号:# 可识别以 #1042 形式书写的订单号。
店铺后端会收到什么,又需要返回什么?
后端会收到一个 JSON POST 请求,其 X-EC-Signature 使用自动化的签名密钥(Signing secret)签名。查询时的关键字段有:contact.wa_id,即客户的 WhatsApp 号码,采用国际格式的数字,不带加号;以及 message.text,其中可能包含订单号。请按该电话号码查找最近的订单,或从文本中解析号码,然后返回 HTTP 200 响应,其 JSON 正文的 reply 字段包含要发送的文本。内容要简洁明了:最多 4,096 个字符会作为一条消息发出,Markdown 标题或链接会显示为原始符号。
Request (trimmed):
{
"event": "automation.step",
"dry_run": false,
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "type": "text", "text": "Hi, where is my order #1042?" },
"history": [ … up to 10 recent messages, oldest first … ]
}
Response, HTTP 200, within 20 seconds:
{ "reply": "Hi Ana! Order #1042 left our warehouse today and should arrive by Friday. Tracking: https://track.example/1042" }后端找不到订单时应该说什么?
每种情况都应给出有用的回复。每条消息只由一个自动化回复;放在 Webhook 之后的步骤即使在成功回复后也会运行,因此后端同样负责备用文本(若改用 Call an API 步骤,可以用 Split into paths 步骤根据答复进行分支):
- 找到订单:返回状态、预计日期和物流跟踪链接。
- 此电话没有订单:请客户提供订单号,或结账时使用的电子邮件地址。
- 有多笔未完成订单:简要列出并询问客户是哪一笔。
- 包裹丢失或损坏:告知会有人在此聊天中回复,并通知您的团队。
- 测试(
dry_run为 true):返回示例回复,且不做任何更改。 - 后端无响应或超过 20 秒:该步骤失败,不发送任何内容,并会发邮件通知您,以便您亲自回复。
如何在客户询问之前发送发货更新?
主动更新是由您的企业主动发起的消息,因此需以已获批准的模板发送。订单状态变化时,店铺系统通过 Cloud API 发送这些模板。请将模板创建在实用类别中,这也是 Meta 用于订单确认和发货通知的类别;若同一模板中含有折扣或产品推荐,则会被归为营销类模板。您的 AI 可以用 create_template 起草并提交模板,其中 {{1}} 代表姓名,{{2}} 代表订单号,并附示例值;用 get_template_status 检查审批状态。随后,店铺在自身的订单事件中调用 get_api_credentials 提供的发送端点,或向触发器为“Your system calls a URL”的自动化的 URL 发送请求(即“Updates from your system”示例),该自动化会用 {{vars.webhook.*}} 中的订单详情发送模板;Shopify 和 WooCommerce 页面展示了相关对接方式。Meta 按每条消息计费,费用取决于类别和国家/地区,并计入您自己的 WhatsApp Business 账户。
客户回复发货更新后会怎样?
客户的回复会开启一个新的 24 小时会话窗口,您的自动化会像处理其他入站消息一样处理它:关键词回复、订单查询或 AI 助手。有一点很重要:若客户的聊天没有近期记录,则被视为首次发消息,因此“First message”自动化可能会向只是回复您发货通知的客户发送欢迎语。请措辞欢迎语,使其在发货更新之后读来也合适。在 Coexistence 号码上,您的店铺发出的模板会显示在应用内的聊天记录中,因此团队在介入前能看到上下文。
设置方法
- Expose an order lookupAdd an HTTPS endpoint, or an n8n workflow, that verifies X-EC-Signature, finds orders by contact.wa_id or the number in message.text and returns {"reply": "..."}.
- Create the automation, switched OffStart from Send to my system, change the trigger to Has keyword, add your order words, paste the URL into Webhook URL, set the switch to Off and click Save.
- Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's configuration.
- Test with Run testClick Test and send "where is my order #1042?" in Try it. Your endpoint receives dry_run true and the sample contact 15550000000.
- Switch it On, then add shipping templatesSwitch the automation On and save, then create utility templates for confirmed, shipped and delivered orders, sent by your store.
常见错误
- 将状态放在其他字段名下返回。只有顶层名为 reply 的字符串会被发送;其他任何内容都会被记录为无回复,客户将收不到消息。
- 直接将 contact.wa_id 与结账时输入的电话号码进行比对。wa_id 包含国家代码,且不含加号、空格或连字符;请仅比对数字。
- 在 Webhook 之后添加 Reply with text 步骤作为备用。它在成功回复后也会运行,因此客户会收到两条消息;请由后端返回备用文本。
- 将优惠券放入发货模板。Meta 会把混合内容视为营销,并可能重新分类或拒绝该模板;请将优惠放在单独的营销模板中。
其 Call my webhook 步骤把订单问题转交给您的后端,并回传答复,同时附有签名、20 秒时限和失败邮件通知;get_api_credentials 则为您的店铺提供发送发货模板所需的一切。自动化不额外收费。每个已连接号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
能否用 AI 步骤代替关键词来回答订单问题?
可以。带有自定义工具的 AI 智能体(即带有订单号等参数及可选标头的 URL)可以自行查询订单,或者让模型位于 Webhook 之后,例如使用带有订单查询工具的 n8n AI Agent 节点,并将其文本作为 reply 返回。单独的 Reply with AI 步骤只读取其指令和聊天内容,因此无法获取实时订单数据。
如果客户发送的是订单照片或语音消息呢?
照片会以 [image] 加上其说明文字的形式到达,因此关键词只有在说明文字中包含该词时才会匹配,不过 AI 智能体可以用您的密钥查看图片。语音消息会通过您的 OpenAI 或 OpenRouter 密钥转写,并保存为 [voice message] 加上转写出的文字,关键词可以匹配这些文字;没有此类密钥时,它仍为 [voice message]。请让 AI 或固定回复要求客户以文字形式提供订单号。
自动化能否以 PDF 形式发送发票或发货标签?
可以,由您的后端负责:在客户最后一条消息后 24 小时内,使用该号码的凭证通过 Cloud API 发送文件,并返回一句简短回复,说明文件正在发送。Webhook 的回复本身只包含文本。固定文件,例如价目表,可以通过 Send a picture or file 步骤发送。
它能同时处理多少个订单问题?
每次运行彼此独立,因此多位客户可以同时提问。easyCoexistence 对每个号码的发送速率最多为每秒 10 条,低于 Meta 对 Coexistence 设定的每秒 20 条上限,您的后端只需在 20 秒内响应 POST 请求即可。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间