ログイン無料トライアルを開始
Meta Tech Provider

n8n の WhatsApp AI エージェント、返信はワークフローが書く

自動化のステップが、署名付きで直近 10 件までのチャット履歴とともに顧客のメッセージを n8n の Webhook ノードへ POST します。AI Agent ノードが返信を作成し、Respond to Webhook ノードが 20 秒以内に {"reply": "..."} を返します。そのテキストは、アプリで引き続き使える WhatsApp Business 番号から送信されます。応答に時間のかかるエージェントは、Meta の Webhook を直接受け取り、Graph API で返信します。

easyCoexistence は、お使いの WhatsApp Business 番号をアプリで使い続けたまま、Coexistence 経由で Meta の Cloud API に接続し、その番号で自動化を実行します。

20 s

Call my webhook ステップがワークフローの応答を待つ時間。この時間を過ぎるとステップは失敗します。

10

履歴として送られるチャットの直近メッセージ。古い順に並び、実行を始めたメッセージで終わります。

4,096

1 通の WhatsApp テキストとして送られる返信の文字数上限。超えた分は切り捨てられます。

6 hours

Webhook ステップが失敗したとき、同じ自動化について送られる失敗メールの最短間隔。

2 modules

n8n Cloud の Code ノードで許可されるもの(crypto と moment)。セルフホスト版の n8n では NODE_FUNCTION_ALLOW_BUILTIN で crypto を有効にします。

24 hours

顧客の最後のメッセージから続く、カスタマーサービスウィンドウ。その後、Meta はテンプレートメッセージのみを受け付けます。

WhatsApp のメッセージはどのように n8n の AI エージェントへ届きますか?

番号に設定した自動化を通じて届きます。番号は easyCoexistence 経由でメッセージを受け取る設定(「Through easyCoexistence」モード)である必要があり、そのとき Meta がメッセージを easyCoexistence へ配信します。トリガーが「A message arrives」、ステップが「Call my webhook」の自動化は、メッセージを n8n の Production URL へ POST します。ワークフローは同じ HTTP レスポンスで応答し、返されたテキストがあなたの番号から WhatsApp メッセージとして顧客に届きます。

n8n が呼び出される前に、実行はすでにガードを通過しています。Meta が再送した配信では二重に実行されず、アプリで送った返信はそのチャットの自動化を一時停止し(既定は 4 時間)、返信は顧客の最後のメッセージから 24 時間以内にしか送られません。ワークフローが決めるのは、何を言うかだけです。

1Customer writesTo the number you keep in the WhatsApp Business app
2Call my webhookSigned POST with the message and recent chat
3n8n AI AgentWebhook node, signature check, AI Agent node
4Respond to Webhook{"reply": "..."} within 20 seconds
5Reply sentAlso shown in the app's chat thread

easyCoexistence は n8n の Webhook ノードへ何を送りますか?

JSON の POST を送ります。User-Agent は easyCoexistence-automations/1、X-EC-Event は automation.step に設定され、X-EC-Signature ヘッダーが付きます。message には顧客のテキストが入ります。メディアの場合は、キャプション付きの [image] などのプレースホルダーが入り、音声メッセージは、OpenAI または OpenRouter のキーが保存されていれば、[voice message] に続けてその内容の文字が入ります。history には、チャットの直近 10 件までのメッセージが古い順に入ります。各メッセージには direction があり、顧客からは in、自動化の返信には out、スマートフォンから人が送った場合は echo になります。対象は、アカウントの保持期間(30、90、365 日、既定は 90 日)に保存されているメッセージで、番号のメッセージが easyCoexistence 経由で届いている間に受信したものだけです。

テスト送信は、エディタの「Try it」パネルから、同じ POST を dry_run を true にして送ります。history は空になり、サンプル連絡先 15550000000(名前は Test customer)と、test_ で始まるメッセージ ID が使われます。どこにも送信されませんが、ワークフローは実際に動きます。dry_run が true のときは、注文の作成のような副作用を省いてください。

POST body of a Call my webhook step
{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "b7e0c3a2-5d1f-4c8e-9a6b-2f4d8e1c7a90", "name": "Send to my system" },
  "run_id": "0d9f6a41-8c2e-4b7a-a315-6e9c2b8d4f17",
  "channel": {
    "type": "whatsapp",
    "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
    "phone": "+1 631-555-0142",
    "phone_number_id": "106540352242922"
  },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": {
    "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==",
    "type": "text",
    "text": "Do you have gluten-free bread today?",
    "at": "2026-11-11T14:02:11.000Z"
  },
  "history": [
    { "direction": "in", "text": "Hi! Are you open today?", "at": "2026-11-11T13:58:40.000Z" },
    { "direction": "out", "text": "Hi Ana! Yes, until 8 pm.", "at": "2026-11-11T13:58:45.000Z" },
    { "direction": "in", "text": "Do you have gluten-free bread today?", "at": "2026-11-11T14:02:11.000Z" }
  ]
}

n8n で署名を検証するにはどうしますか?

Webhook ノードの直後に Code ノードを追加します。X-EC-Signature は t=<unix seconds>,v1=<hex> の形式で、v1 は t、ドット、本文を連結したものの HMAC-SHA256 です。鍵として、自動化の「Signing secret」を使います。コピーするには、保存済みの自動化を開き、Call my webhook ステップを選択します。自動化ごとに専用の secret があり、MCP ツールはこの値を返さないため、AI が作成した自動化でも、この 1 回のコピーはダッシュボードから行う必要があります。「New secret」ボタンで置き換えることができ、古い secret はすぐに使えなくなります。また、見られるのはアカウントのオーナーだけで、招待されたチームメンバーには見えません。

時計から 5 分以上ずれた t は拒否し、比較は定数時間で行い、失敗時には例外を投げてください。そうするとワークフローは Respond to Webhook の前でエラーになり、n8n は 500 を返して何も送信されません。n8n Cloud では Code ノードで crypto モジュールが使えます。セルフホスト版の n8n では NODE_FUNCTION_ALLOW_BUILTIN=crypto が必要です。IF ノードと組み合わせた Crypto ノードの Hmac アクションも動作しますが、IF による比較は定数時間ではありません。

n8n Code node: verify X-EC-Signature
// n8n Code node, mode "Run Once for Each Item", placed right after the Webhook node.
// n8n Cloud allows require('crypto'); self-hosted needs NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the automation's Signing secret, from its editor page

const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec($json.headers['x-ec-signature'] || '');
if (!m) throw new Error('Missing X-EC-Signature');
if (Math.abs(Date.now() / 1000 - Number(m[1])) > 300) throw new Error('Stale signature');

// The body was signed as compact JSON, which JSON.stringify rebuilds from the parsed body.
const mac = crypto.createHmac('sha256', SECRET).update(`${m[1]}.${JSON.stringify($json.body)}`).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(m[2], 'hex'))) throw new Error('Bad signature');

return { json: $json.body }; // event, dry_run, contact, message, history...

AI Agent ノードと返信はどのように設定しますか?

AI Agent ノードの user message には顧客のテキストを入れ、それ以外はすべて system message に入れます。事業者の概要、引用してよい事実、トーン、そして history の直近の会話を入れてください。こうすると、フォローアップの質問も文脈に沿って答えられます。使用するチャットモデルと、注文を検索する HTTP Request ツールなどのツールを接続してください。

最後に、JSON で応答し、エージェントのテキストを reply という名前のフィールドに入れる Respond to Webhook ノードを置きます。easyCoexistence は値の前後の空白を取り除き、空の値や文字列でない値は無視します。残りは 1 通の WhatsApp テキストとして、最大 4,096 文字まで送られます。そのため、モデルには Markdown ではなく平文で答えるよう指示してください。

AI Agent and Respond to Webhook settings
AI Agent node
  Prompt: Define below
  Prompt (User Message): {{ $json.message.text }}
  Options > System Message:
    You answer WhatsApp messages for Bloom Café, 12 Baker St, open Tue to Sun 8:00 to 20:00.
    Reply in 1 to 3 short sentences, in the customer's language, as plain text.
    Never invent prices or stock. If unsure, say a person will reply here soon.
    Recent chat, oldest first:
    {{ $json.history.map(h => (h.direction === 'in' ? 'Customer: ' : 'Business: ') + h.text).join('\n') }}
  Chat Model: your OpenAI, Anthropic or OpenRouter model
  Tools (optional): an HTTP Request tool that looks up orders

Respond to Webhook node
  Respond With: JSON
  Response Body: { "reply": {{ $json.output.toJsonString() }} }

ワークフローが遅い、失敗する、または何も返さないときはどうなりますか?

すべての結果は、自動化の「Runs」タブにステップの出力またはエラーとともに記録されるため、次のどれが起きたか確認できます。

  • 20 秒以内に応答がない場合は、ステップが Webhook did not answer で失敗し、何も送信されず、実行には Failed と表示されます。
  • リダイレクトを含め 2xx 以外のステータスの場合は、ステップが Webhook answered HTTP とコードで失敗します。
  • 返信の文字列がない 2xx の場合、実行は Done となり、ステップには HTTP 200 と no reply が表示され、顧客には自動の返信は届きません。
  • 失敗した実行は、その顧客に自分で返信できるようメールで通知されます。通知は自動化ごとに 6 時間に 1 回までです。
  • 一時停止中(既定は 4 時間、Advanced で設定)にスマートフォンから返信したチャットは、n8n が呼ばれる前に human_active としてスキップされます。
  • 短時間に複数のメッセージが届くと、複数の実行が開始されます。Call my webhook の前に 1 分の「Wait」を置くと、同じ自動化を選ぶ新しいメッセージが待機中の実行を置き換えるため、応答は 1 回になります。

代わりに Meta の Webhook を n8n で直接受け取るべきなのはどんなときですか?

エージェントの処理が 20 秒を超える場合、ワークフローがすべてのイベント(ステータス、スマートフォンでの返信、メディア ID)を見る必要がある場合、Flow やカタログメッセージなど、どのステップにもない種類のものを送る場合、または 6 か月分の履歴インポートを望む場合です。履歴インポートは、接続から 24 時間以内に保存された直接の送信先にのみ送られます。直接モードでは、この番号の自動化はオフになります。Meta が独自のペイロードを n8n へ直接 POST し、easyCoexistence はメッセージを見ることがありません。

n8n では、独自の Meta アプリとその secret を前提とする WhatsApp Trigger ノードではなく、通常の Webhook ノードを使ってください。「Allow Multiple HTTP Methods」を有効にすると、1 つの長いランダムなパスで Meta の GET ハンドシェイクと POST の両方を受け取れます。GET には生の hub.challenge をテキストとして返し、その Production URL を検証トークンとともに set_webhook_destination で保存します。その後、返信は送信用エンドポイントへ HTTP Request ノードから送られ、重複排除、電話での一時停止、24 時間チェックはあなたの側で行うことになります。

Call my webhook (Automations on)Direct webhook (automations off)
Who calls n8neasyCoexistence, when the automation matchesMeta, for every event on the number
Time to answer20 seconds, reply in the responseNo limit: send later through the Graph API
AuthenticationX-EC-Signature with the automation's secretA long random secret in the URL path
GuardsDedupe, phone pause and 24-hour check built inYours to write
What n8n can sendText in the reply; the other steps of the automation can send buttons, files and templatesAny Cloud API message type, templates included
History importNot availableIf saved within 24 hours of connecting
Kept by easyCoexistenceMessage text for your retention period (90 days by default), run logs 30 daysNothing

設定方法

  1. Turn on automations for the numberOn the number's page, the Automations and incoming messages card shows Automations on or Direct to your server. Click Turn on automations if needed; numbers connected without a webhook URL start with automations on.
  2. Build and publish the workflowWebhook node (POST, Respond: Using 'Respond to Webhook' Node), Code node, AI Agent node, Respond to Webhook node. Publish or activate it and copy the Production URL.
  3. Create the automation, switched OffIn Automations, click New automation and pick Send to my system under Start from an example. Paste the Production URL into Webhook URL, set the switch to Off so it does not answer customers yet, and click Save.
  4. Copy the Signing secret into n8nSelect the Call my webhook step of the saved automation, copy Signing secret and paste it into the Code node.
  5. Test, then switch it OnClick Test, type a sample message in Try it and press Run test: n8n runs with dry_run true and the result shows the reply. When it reads right, switch the automation On and save.

よくある間違い

  • Webhook ノードの Respond オプションを Immediately のままにすること。n8n はすぐに Workflow got started と返し、実行は HTTP 200、返信なしと記録され、顧客には何も届きません。「Using 'Respond to Webhook' Node」を選んでください。
  • /webhook-test/ を含むテスト URL を貼り付けること。これはエディタがテストイベントを待っている間だけ受信するもので、自動化には公開済みワークフローの Production URL が必要です。
  • 番号の forward secret で検証すること。Call my webhook は自動化専用の Signing secret で署名されています。forward secret は転送されたイベントにだけ署名するため、本物のステップが検証に失敗します。
  • 本文の形式を変えて返すこと。トップレベルに reply という文字列のフィールドを持つ JSON 本文だけが送られ、{"output": "..."} や text/plain の本文は no reply として記録されます。
EasyCoexistence で実現する

Call my webhook ステップは顧客のメッセージを n8n に渡し、返信を送り返します。重複排除、スマートフォンで返信したときの一時停止、24 時間チェックが組み込まれており、実行ごとの追加料金はありません。料金は番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。

よくある質問

ChatGPT や Claude が、この自動化を代わりに作成できますか?

はい。easyCoexistence のコネクターを追加した状態で、受信メッセージを n8n の URL に送る自動化を番号に作るよう依頼してください。AI は call_webhook ステップを使って create_automation を呼び出し、その後 test_automation を実行します。テストに合格するまで自動化を無効にしたまま作成するよう依頼してください。Signing secret は MCP 経由では返されないため、自動化のページからコピーしてください。

ワークフローは画像、ボタン、テンプレートを送れますか?

返信フィールドは経由できません。そのフィールドはテキストしか運びません。代わりに自動化に任せてください。「Send a picture or file」「Ask a question with buttons」「Send a template」などのステップは、「Call my webhook」の前にも後にも置けます。それ以外の種類のメッセージは、HTTP Request ノードから、get_api_credentials が返す送信用エンドポイントとトークンを使って Cloud API に送信してください。顧客が二重に返信を受け取らないよう、reply は返さないでください。

1 つのワークフローで複数の番号に返信できますか?

はい。番号ごとに 1 つの自動化を作り、すべて同じ Production URL に向けて、channel.phone_number_id または automation.id で分岐してください。自動化ごとに Signing secret が異なるため、署名を検証する前に automation.id で secret を選んでください。

セルフホスト版の n8n でも動きますか?

はい、Production URL が公開の HTTPS であれば動きます。easyCoexistence は、URL を保存するときと呼び出しのたびに、http、localhost、プライベートおよび内部アドレスを拒否し、リダイレクトには従いません。

続きを読む

始める準備はできましたか?

WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日