登录开始免费试用
Meta Tech Provider

用实时数据回复 WhatsApp 客户:价格、库存和空位都取自您的系统

要用当前数据回复 WhatsApp 上关于价格、库存或可用情况的提问,请在消息到达的那一刻,将客户的消息交给您自己的系统,在系统中查找对应数值,然后返回回复文本。自动化中的 Webhook 步骤会完成这一过程:它以 POST 请求的形式发送消息内容和客户号码,并在 20 秒内返回一个含有 reply 字段的 JSON 响应,该响应即作为 WhatsApp 回复发出。

easyCoexistence 通过 Coexistence 将您在应用中保留的 WhatsApp Business 号码连接到 Meta 的 Cloud API,并在该号码上运行自动化。

20 s

“调用我的 Webhook 步骤”在判定失败前等待您系统响应的时长。

10

随请求一同发送的聊天近期消息,按从旧到新排列,使追问能保留上下文。

4,096

一条 WhatsApp 文本回复可容纳的字符数,超出的部分将被截断。

https only

Webhook URL 必须是公网 HTTPS 地址;http 和内网地址会被拒绝,重定向不会被跟随。

24 hours

客户最后一条消息之后,Meta 接受自由文本回复的时间窗口;客户发来新问题即重新开启窗口。

实时数据回复如何运作?

一个自动化负责接收消息,通常是针对价格或库存词汇的关键词自动化。它的“调用我的 Webhook 步骤”会将消息内容、客户号码以及近期聊天记录,以该自动化自有的密钥签名后,以 POST 方式发送到您的 URL。您的代码读取数值后,返回 HTTP 200 以及 JSON 内容,例如 {"reply": "Sourdough loaf: US$ 6.50, 14 left today."}。easyCoexistence 检查 24 小时窗口,并从您的号码发出该文本。

在调用您的系统之前,本次运行已通过内置防护:Meta 重复投递的消息绝不会启动第二次运行;如果某个聊天已由手机端回复,默认会在 4 小时内保持不动。该回复同时会显示在应用的聊天线程中,因此持有手机的人能看到客户被告知了什么。

1Customer asks"Do you have the blue one in size M?"
2Has keywordstock, available, price, preço, precio...
3Call my webhookSigned POST with the text and the customer's number
4Your systemReads stock now, answers {"reply": "..."}
5Reply sentWithin 20 seconds, also visible in the app

为什么不把价格和库存写进固定回复或 AI 指令里?

固定回复只写一次,而 AI 回复步骤只依据两个来源撰写:其指令和近期聊天记录。二者都不会因商品售罄或时段被预订而改变。AI 步骤还会按照您的指令被告知:不得编造它看不到的价格、库存、日期或政策,因此,对于“今天有没有货”之类的问题,它会礼貌地转交人工,而不是给出一个数字。

会在一天之内变化的数据,应当放在已经持有它们的系统中:店铺、电子表格、预约日历或 ERP。Webhook 步骤让该系统在那一刻直接回答客户,给出它此刻掌握的数值,而回复来自团队在应用中继续使用的 WhatsApp Business 号码。

哪些问题应该交给您的系统处理?

那些答案变化速度快于您编辑文本速度的问题。请使用“包含”模式的“含关键词”触发器进行分流,每种服务语言最多 30 个词。关键词自动化会先于“首条消息”、“非营业时间”和兜底规则被检查,而且每条消息只有一个自动化会作答,因此兜底位置上的 AI 助手会保留其他问题。“包含”会匹配词语内部的片段,所以请优先使用完整词汇,而不是短片段:

  • 价格:price、how much、price list、preço、quanto custa、precio、cuánto cuesta。
  • 库存:stock、available、in store、estoque、disponível、disponible。
  • 空位:appointment、slot、table for、horário、vaga、una cita、mesa para。
  • 配送费或按邮编划分的配送区域:delivery fee、frete、taxa de entrega、envío、código postal。
  • 今日营业状态:open today、holiday、aberto hoje、feriado、abierto hoy。

您的系统会收到什么,又需要返回什么?

一个携带 X-EC-Event 请求头(值为 automation.step)的 JSON POST 请求。查询所需的字段包括 message.text(其中出现产品名称或代码)和 contact.wa_id(客户的国际格式号码,不含加号),后者可用于按客户群体制定价格,或读取已保存的购物车。history 最多包含 10 条近期消息,因此“和红色的呢?”可以结合前一个问题来理解。“测试”功能发送时,dry_run 为 true,且 history 为空。

以 HTTP 200 返回一个顶层字符串字段 reply。reply 为空或缺失时不发送任何内容,运行继续进入之后的步骤。状态码不在 2xx 范围内、发生重定向,或超过 20 秒无响应,都会导致该步骤失败。完整的请求体示例见 n8n 智能体页面。

Request (trimmed) and the answer your system returns
POST https://shop.example/whatsapp/live
X-EC-Event: automation.step
X-EC-Signature: t=1762869731,v1=5f0c...

{
  "event": "automation.step",
  "dry_run": false,
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": { "id": "wamid.HBgN...", "type": "text", "text": "Is the linen shirt in size M available?", "at": "2026-11-11T14:02:11.000Z" },
  "history": [ ...up to 10 recent messages, oldest first... ]
}

HTTP 200, within 20 seconds:
{ "reply": "Linen shirt, size M: 3 left, US$ 42. Want me to hold one for you until 6 pm?" }

如何在 Node.js 中构建该端点?

以原始文本读取请求体,对其验证 X-EC-Signature,然后再解析。该请求头格式为 t=<unix seconds>,v1=<hex>,其中 v1 是以自动化完整的 whsec_ 签名密钥为密钥、对 t、一个点号和请求体拼接内容计算的 HMAC-SHA256。拒绝与您本地时钟相差超过 5 分钟的 t,并以恒定时间进行比较。

然后执行一次快速查询:数据库查询、对商店 API 的缓存调用,或读取保存在内存中的价格表。将查询与计时器竞速,这样即使数据库很慢,也会在 20 秒限制之前给出友好的回复,而不是运行失败。若没有匹配结果,请询问产品名称或代码,而不是猜测。

Express endpoint for a Call my webhook step: live price and stock
import express from "express";
import crypto from "node:crypto";

const SECRET = process.env.EC_SIGNING_SECRET; // the automation's Signing secret, from its editor page

function signed(req) {
  const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
  if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
  const mac = crypto.createHmac("sha256", SECRET).update(m[1] + "." + req.body).digest();
  return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}

const app = express();
app.post("/whatsapp/live", express.text({ type: "application/json" }), async (req, res) => {
  if (!signed(req)) return res.status(401).end();
  const { message } = JSON.parse(req.body);

  // Answer before the 20-second limit whatever happens: a slow lookup gets a fallback at 15 s.
  const late = new Promise((r) => setTimeout(() => r("late"), 15000));
  const item = await Promise.race([findProduct(message.text), late]); // your SQL, API or cache

  if (item === "late") return res.json({ reply: "Let me check that for you. A person will reply here shortly." });
  if (!item) return res.json({ reply: "Which product do you mean? Send its name or code and I will look it up." });
  const stock = item.stock > 0 ? item.stock + " in stock" : "out of stock today";
  res.json({ reply: item.name + ": " + item.price + ", " + stock + "." });
});

app.listen(3000);

模型能否根据实时数据撰写回复?

可以,放在 Webhook 后面即可。您的端点,或带有 AI Agent 节点的 n8n 工作流,先通过查询或工具获取数值,然后让您的模型用这些数值来组织回复:“客户询问 X。当前库存:Y。请用一两句话回复,并使用客户的语言。”然后,reply 字段承载模型生成的文本。单独的 AI 回复步骤没有工具,也不能浏览网页,因此,对于需要把措辞与数据结合起来的回答,应走这条路径。

请确保整个往返过程(查询加模型调用)远低于 20 秒。让模型给出简短回答,选用快速的模型,并为服务商变慢的那一天保留计时器的兜底机制。

Webhook 回复有哪些限制?

Webhook 回复是只发送一次的纯文本,足以应付大多数价格、库存和空位的问答。更丰富的内容需通过 Meta 的 Cloud API 发送,由您自己的系统完成。需要提前规划的要点如下:

  • 仅限文本,最多 4,096 个字符,不支持 Markdown。图片、按钮或模板:请用您系统中的发送端点(来自 get_api_credentials)发送,并且不返回回复。
  • 只尝试一次,不重试。超时或错误会将运行标记为失败,并向您发送邮件,每个自动化每 6 小时最多一封。
  • 放在 Webhook 之后的回复步骤同样会发送,因此客户会收到两条消息。
  • 自由文本回复只能在客户最后一条消息后的 24 小时内发出;放在 Webhook 之前的等待步骤可能使其超出该时间窗口。

设置方法

  1. Expose the lookupPublish an HTTPS endpoint or an n8n workflow that verifies X-EC-Signature, reads message.text and contact.wa_id, and returns {"reply": "..."}.
  2. Create the automation, switched OffIn Automations, click New automation, pick Send to my system under Start from an example, change the trigger to Has keyword with your price or stock words, paste the URL into Webhook URL, set the switch to Off and click Save.
  3. Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's settings.
  4. Try a real questionClick Test, type a question such as "Is the linen shirt in size M available?" in Try it and press Run test. Your system really runs with dry_run true; the result shows the reply.
  5. Switch it OnWhen the reply reads right, set the switch to On and save. Send a question from another phone and open the run under Runs to see the timing.

常见错误

  • 把价格粘贴进 AI 指令后就忘了它们。模型会自信地报出上个月的数字;请把会变动的数字保存在您的系统中,让 Webhook 去读取。
  • 在请求中运行一个慢报表。超过 20 秒,步骤失败,什么也不会发出;请查询索引或缓存,并在 15 秒时返回兜底文本。
  • 在 Webhook 之后添加“文本回复”步骤作为安全网。即使回复已成功,它也会运行,因此客户会收到两条消息;请把兜底文本放在您的端点中。
  • 使用“tem”或“cost”这类简短的关键词片段。“包含”会匹配词内部,因此 item、temperature 或 costume 都会触发查询;请使用完整词汇,并在“测试”中验证。
使用 EasyCoexistence 完成这些操作

“调用我的 Webhook 步骤”将您自己的系统引入聊天:它以签名方式发送问题,并送回您的系统返回的答案,同时内置去重、您从手机回复时的暂停机制以及 24 小时检查,每次运行不额外收费。每个号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

常见问题

可以用 Google 表格作为价格表吗?

可以。n8n 工作流可以通过 Google Sheets 节点在表格中查找产品,然后将该行的价格和库存作为回复返回。Google 对每位用户每分钟的读取次数有限制,因此对于高流量号码,请在工作流或后端中缓存该表格,并每隔几分钟刷新一次。

我的系统需要全天候在线吗?

对于此自动化,需要:请求失败或超时会将运行标记为失败,不发送任何内容,并向您发送邮件。可将第二个优先级较低的自动化(例如兜底位置上的 AI 助手)用于处理其他问题,并在慢速时段保留端点自身的兜底文本。

ChatGPT 或 Claude 能帮我设置这个自动化吗?

可以。使用 easyCoexistence 连接器,请它为您的号码创建一个调用您 URL 的关键词自动化;AI 会使用 create_automation 搭配 call_webhook 步骤,然后使用 test_automation。签名密钥不会通过 MCP 返回,因此请从控制台中该自动化的页面复制。

实时数据回复需要额外付费吗?

easyCoexistence 不收取额外费用:自动化没有按运行计费,也没有运行次数上限。Meta 按消息、类别和国家/地区,直接向该企业自己的 WhatsApp Business 账户计费,easyCoexistence 从不加价。您的服务器或工作流工具的费用维持现状。

继续阅读

准备开始了吗?

几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间