登入開始免費試用
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 網址必須是公開的 HTTPS;http 與私有位址會被拒絕,重新導向亦不會跟隨。

24 hours

客戶最後一則訊息之後,Meta 接受自由格式回覆的時段;新的提問會重新開啟此時段。

即時數據回覆如何運作?

通常由一個自動化負責接收訊息,多為針對價格或庫存用字的關鍵字自動化。其「呼叫我的 Webhook」步驟會以 POST 將訊息、客戶號碼及近期聊天記錄傳送至您的網址,並以該自動化專屬的 Signing secret 簽署。您的程式讀取數值後,以 HTTP 200 回應 JSON 內容,例如 {"reply": "酸種麵包:US$ 6.50,今日尚餘 14 個。"}。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 號碼,則是團隊在應用程式中一直使用的那個。

哪些問題應交由您的系統處理?

答案變化速度快於您編輯文字的那類問題。以「含有關鍵字」觸發器的「Contains」模式路由,每種服務語言最多 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。

您的系統收到與回傳什麼?

一個 JSON POST,標頭 X-EC-Event 設為 automation.step。查詢所需的欄位包括 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_ Signing secret 為金鑰,對 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 提供的發送端點由您的系統發送,並且不回傳 reply。
  • 只嘗試一次,不重試。逾時或錯誤會將執行標示為「失敗」,並每個自動化每 6 小時最多向您發一封電郵通知。
  • 置於 Webhook 之後的「Reply with text」步驟同樣會發送,客戶因此會收到兩則訊息。
  • 自由格式回覆只會在客戶最後一則訊息後 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 之後加入「Reply with text」步驟作為保險。即使 Webhook 已成功回覆,它也會執行,客戶因此收到兩則訊息;應把後備文字放在您的端點之內。
  • 使用「tem」或「cost」之類的短關鍵字片段。包含比對會在字詞之內配對,因此 item、temperature 或 costume 都會觸發查詢;應使用完整詞語,並於「試一試」中測試。
使用 EasyCoexistence 完成這項設定

「呼叫我的 Webhook」步驟讓您自己的系統進入對話:它以已簽署的方式傳送問題,並送回您的系統所回傳的答案,去重、您以手機回覆時的暫停,以及 24 小時檢查均已內建,每次執行不另收費。每個號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。

常見問題

Google 試算表能否作為價目表?

可以。n8n 工作流程可用 Google Sheets 節點在試算表中查找產品,然後把該列的價格與庫存作為回覆發回。Google 對每位使用者每分鐘的讀取次數有限,因此對繁忙的號碼,應在工作流程或後端快取試算表,並每隔幾分鐘刷新一次。

我的系統是否需要全天候在線?

就此自動化而言,需要:請求失敗或逾時會將執行標示為「失敗」,不發送任何內容,並向您發出電郵通知。可將 AI 助理等優先度較低的第二個自動化設於萬用回應,以處理其他問題,並為端點保留其自身的後備訊息,以應付緩慢的時刻。

ChatGPT 或 Claude 能否替我設定此自動化?

可以。使用 easyCoexistence 連接器,要求在您的號碼上建立一個呼叫您網址的關鍵字自動化;AI 會以含 call_webhook 步驟的 create_automation 建立,然後以 test_automation 測試。Signing secret 不會透過 MCP 回傳,因此請從控制台中該自動化的頁面複製。

即時數據回覆需要額外收費嗎?

easyCoexistence 不收費:自動化沒有每次執行的費用,亦無執行次數上限。Meta 按商家自身 WhatsApp Business 帳戶的訊息計費,依類別與國家逐則收取,easyCoexistence 從不加價。您的伺服器或工作流程工具仍按現時的收費計算。

繼續閱讀

準備開始嗎?

幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期