最新データで WhatsApp のお客様に回答する:自社システムの料金、在庫、空き状況
WhatsApp の料金、在庫、空き状況について最新の数値で答えるには、お客様のメッセージが届いた時点で自社システムに渡し、そこで値を調べて、返信のテキストを返します。自動化の「Call my webhook」ステップがこれを行います。メッセージとお客様の電話番号を POST し、reply フィールドを含む JSON の回答を 20 秒以内に返すと、それが WhatsApp の返信として送信されます。
easyCoexistence は、アプリで管理している WhatsApp Business の番号を、Coexistence を通じて Meta の Cloud API に接続し、その番号で自動化を実行します。
「Call my webhook」ステップが自社システムの回答を待つ時間。この時間を過ぎるとステップは失敗します。
リクエストと一緒に送られる、チャットの最近のメッセージ(古い順)。フォローアップの質問も文脈を保てます。
1 通の WhatsApp テキストで送れる返信の文字数。超えた部分は切り捨てられます。
Webhook の URL は公開された HTTPS である必要があります。http やプライベートアドレスは拒否され、リダイレクトは追跡されません。
お客様の最後のメッセージから、Meta がフリーテキストの返信を受け付ける時間の枠。新しい質問が来ると、枠が新たに開きます。
ライブデータによる返信は、どのように動きますか?
一つの自動化がメッセージを受け取ります。通常は、料金や在庫の語に反応するキーワード自動化です。「Call my webhook」ステップは、メッセージ、お客様の電話番号、最近のチャットを、御社の URL に POST します。リクエストは、その自動化専用の Signing secret で署名されます。自社のコードが値を読み取り、{"reply": "Sourdough loaf: US$ 6.50, 14 left today."} のような JSON 本文で HTTP 200 を返します。easyCoexistence は 24 時間ウィンドウを確認し、そのテキストを御社の番号から送信します。
御社のシステムが呼び出される前に、実行は組み込みのガードを通過しています。Meta の再送では二重に実行されず、スマートフォンから返信したチャットは既定で 4 時間、自動返信の対象外になります。返信はアプリのチャットスレッドにも表示されるため、スマートフォンを持つ人は、お客様に何が伝えられたかを確認できます。
固定の返信や AI の「Instructions」に料金と在庫を書かないのはなぜですか?
固定の返信は一度書かれたままです。また「Reply with AI」ステップは、2 つの情報源からしか文章を作りません。「Instructions」と、最近のチャットです。どちらも、商品が売り切れたときや、枠が予約されたときには変わりません。AI ステップには、御社の指示により、見ることができない料金、在庫、日付、ポリシーを作らないよう指示されています。そのため、今日の在庫を尋ねられると、数字の代わりに丁寧な引き継ぎの案内が返ります。
一日のうちに変わる数字は、すでにそれを保持しているシステムに置くべきです。ストア、スプレッドシート、予約カレンダー、ERP などです。「Call my webhook」ステップを使うと、そのシステムが、その瞬間に持っている値を使ってお客様に直接答えられます。チームがアプリで使い続けている WhatsApp Business の番号から送信されます。
どの質問をシステムに回すべきですか?
答えが、テキストを編集するより速く変わる質問です。各言語で、Contains モードの「Has keyword」トリガーを使い、最大 30 語まで指定して振り分けてください。キーワード自動化は、「First message」「After hours」「catch-all」より先に確認され、1 つのメッセージに答えるのは 1 つの自動化だけです。そのため、catch-all の AI アシスタントは他の質問を引き続き担当します。Contains は語の内側にも一致するため、短い断片よりも、語全体を指定することを優先してください。
- 料金: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 件入るため、「赤いものは?」のような質問も、直前の質問と照らして読めます。「Try it」からのテストでは、dry_run が true、history は空で送られます。
トップレベルに reply という文字列を含めた JSON を、HTTP 200 で返します。reply が空または欠けている場合は何も送信されず、後続のステップがあればそこに進みます。2xx 以外のステータス、リダイレクト、または 20 秒を超える無応答は、ステップを失敗させます。n8n エージェントのページに、完全な本文が示されています。
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 は、t、ドット、本文を連結したものの HMAC-SHA256 で、自動化の whsec_ で始まる Signing secret 全体を鍵とします。時計から 5 分以上離れた t は拒否し、定数時間で比較します。
そのあと、高速な検索を 1 回行います。データベースへのクエリ、ストアの API へのキャッシュされた呼び出し、またはメモリ上に保持された価格表からの読み取りです。遅いデータベースでも 20 秒の制限を超えて失敗させないよう、タイマーと競争させ、その前に丁寧な一言を返せるようにします。一致しない場合は、推測せず、商品名またはコードを尋ねてください。
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 です。お客様の言語で 1〜2 文で答えてください。」のように指示します。reply フィールドには、モデルのテキストが入ります。単独の「Reply with AI」ステップにはツールもブラウジングもないため、言い回しとデータを組み合わせる回答には、この経路を使います。
検索とモデル呼び出しを合わせた全往復は、20 秒を十分に下回るようにしてください。モデルには短い回答を求め、速いモデルを選び、プロバイダーが遅い日に備えて、タイマーによるフォールバックを残しておきます。
Webhook の返信の制限は何ですか?
Webhook の返信は、一度だけ送られる平文テキストです。これで、料金、在庫、空き状況の回答のほとんどは足ります。それ以上に豊かな内容は、御社のシステムから、Meta の Cloud API を通じて送信します。計画すべき点は次のとおりです:
- テキストのみで、最大 4,096 文字、Markdown は不可です。画像、ボタン、テンプレートは、
get_api_credentialsの送信エンドポイントを使って御社のシステムから送り、返信は何も返さないでください。 - 1 回の試行で、再試行はありません。タイムアウトまたはエラーは実行を「Failed」とし、自動化ごとに 6 時間に最大 1 回、メールでお知らせします。
- Webhook の後に置いた返信ステップも送信されるため、お客様は 2 通のメッセージを受け取ります。
- フリーテキストの返信は、お客様の最後のメッセージから 24 時間以内にのみ送信されます。Webhook の前に置いた「Wait」ステップが、その期限を超えることがあります。
設定方法
- 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": "..."}.
- 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.
- Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's settings.
- 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.
- 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 の「Instructions」に料金を貼り付けて、そのままにしてしまうこと。モデルは先月の数字を自信を持って答えてしまいます。動く数値は御社のシステムに保持し、Webhook に読み取らせてください。
- リクエストの中で重いレポートを実行すること。20 秒を超えるとステップは失敗し、何も送信されません。インデックスやキャッシュに問い合わせ、15 秒の時点でフォールバックの一言を返してください。
- 安全策として、Webhook の後に「Reply with text」ステップを置くこと。成功した返信の後にも実行されるため、お客様は 2 通のメッセージを受け取ります。フォールバックの文章は、エンドポイント側に置いてください。
- 「tem」や「cost」のような短いキーワードの断片を使うこと。Contains は語の内側にも一致するため、item、temperature、costume でも検索が始まります。語全体を使い、「Try it」で試してください。
「Call my webhook」ステップは、御社のシステムをチャットに組み込みます。質問に署名を付けて送り、御社のシステムが返した回答を届けます。重複排除、スマートフォンから返信したときの一時停止、24 時間ウィンドウの確認が組み込まれており、実行ごとの追加料金はかかりません。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 までです。最初の 3 日間は無料トライアルです。
よくある質問
Google スプレッドシートを価格表にできますか?
はい。n8n ワークフローは、Google Sheets ノードでシートから商品を検索し、その行の料金と在庫を返信として返せます。Google は 1 ユーザーあたりの 1 分間の読み取り数を制限しているため、メッセージの多い番号では、ワークフロー内か御社のバックエンドにシートをキャッシュし、数分おきに更新してください。
私のシステムは 24 時間稼働している必要がありますか?
この自動化については、はい。リクエストが失敗するかタイムアウトすると、実行は「Failed」になり、何も送信されず、メールでお知らせします。他の質問は、catch-all の AI アシスタントなど、優先度の低い 2 つ目の自動化に任せ、遅い時間帯のためにエンドポイント自身のフォールバックの一言を残してください。
ChatGPT や Claude がこの自動化を設定できますか?
はい。easyCoexistence のコネクタを使い、御社の URL を呼び出す、番号上のキーワード自動化を依頼できます。AI は call_webhook ステップを持つ create_automation を使い、次に test_automation を実行します。Signing secret は MCP 経由では返されないため、ダッシュボードの自動化のページからコピーしてください。
ライブデータの返信には追加料金がかかりますか?
easyCoexistence からは、かかりません。自動化には実行ごとの料金も、実行数の上限もありません。Meta は、メッセージを事業者自身の WhatsApp Business アカウントに対して、カテゴリと国ごとに、メッセージ単位で請求します。easyCoexistence は、その金額に上乗せしません。御社のサーバーやワークフローツールの費用は、現在と同じです。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日