סוכן AI ל-WhatsApp ב-n8n, והתשובה נכתבת בזרימת העבודה שלכם
תהליך אוטומציה שולח ב-POST אל צומת Webhook בתוך n8n את הודעת הלקוח, חתומה ועם עד 10 הודעות אחרונות מהשיחה. צומת AI Agent כותב את התשובה, צומת Respond to Webhook מחזיר {"reply": "..."} תוך 20 שניות, והטקסט נשלח ממספר ה-WhatsApp Business, שממשיך לעבוד באפליקציה. סוכנים איטיים יותר מקבלים ישירות את הוובהוק של Meta ומשיבים דרך Graph API, בלי שכבת הביניים.
easyCoexistence מחברת את מספר WhatsApp Business שכבר אתם משתמשים בו באפליקציה ל-Cloud API של Meta דרך Coexistence, ומריצה עליו אוטומציות.
כמה זמן שלב הקריאה לוובהוק ממתין לתשובה של זרימת העבודה לפני שהשלב נכשל.
ההודעות האחרונות של השיחה שנשלחות בהיסטוריה, מהישנה לחדשה, ומסתיימות בהודעה שהפעילה את הריצה.
מספר התווים של תשובה שנשלחת כהודעת WhatsApp טקסטואלית אחת; כל מה שארוך יותר נחתך.
הפער הקצר ביותר בין שני מיילים על כשל לאותה אוטומציה, כשנכשל שלב הוובהוק.
מה n8n Cloud מאפשר בצומת Code, כלומר crypto ו-moment. בשרת עצמי של n8n, crypto מופעל דרך המשתנה NODE_FUNCTION_ALLOW_BUILTIN, שנקבע בשרת.
חלון שירות הלקוח אחרי ההודעה האחרונה של הלקוח; אחריו Meta מקבלת רק הודעות מסוג תבנית.
איך הודעת WhatsApp מגיעה לסוכן AI ב-n8n?
דרך אוטומציה על המספר. המספר צריך לקבל את הודעותיו דרך easyCoexistence (המצב "Through easyCoexistence"), כדי ש-Meta תעביר אותן אליה. אוטומציה שהטריגר שלה הוא 'הגיעה הודעה' והשלב שלה הוא הקריאה לוובהוק שולחת ב-POST את ההודעה אל כתובת ה-Production URL של הזרימה ב-n8n. הזרימה עונה באותה תגובת HTTP, והטקסט שהיא מחזירה נשלח ללקוח כהודעת WhatsApp מהמספר שלכם.
לפני שנקרא ל-n8n, הריצה כבר עברה את הבדיקות. שליחה חוזרת של Meta לא מתחילה ריצה שנייה, תשובה שהקלדתם באפליקציה משהה את האוטומציה בשיחה ההיא (4 שעות כברירת מחדל), והתשובה יוצאת רק עד 24 שעות מההודעה האחרונה של הלקוח. הזרימה שלכם מחליטה רק מה לומר.
מה easyCoexistence שולחת לצומת Webhook ב-n8n?
בקשת JSON ב-POST עם User-Agent easyCoexistence-automations/1, X-EC-Event שמוגדר ל-automation.step וכותרת X-EC-Signature. השדה message מכיל את הטקסט של הלקוח, או מציין מקום כמו [image] עם הכיתוב במדיה; הודעה קולית מגיעה כ-[voice message] ואחריה תוכנה, כשמפתח OpenAI או OpenRouter שמור. השדה history מכיל עד 10 הודעות אחרונות של השיחה, מהישנה לחדשה, וכל אחת עם direction: in ללקוח, out לתשובה של אוטומציה ו-echo לאדם שכתב מהטלפון. זה מכסה את ההודעות שנשמרות לפי תקופת השמירה של החשבון (30, 90 או 365 ימים, 90 כברירת מחדל), ורק הודעות שהגיעו בזמן שהודעות המספר עברו דרך easyCoexistence.
הבדיקה מהחלונית Try it בעורך שולחת את אותה בקשת POST, עם dry_run שמוגדר ל-true, היסטוריה ריקה, איש קשר לדוגמה 15550000000 בשם לקוח בדיקה ומזהה הודעה שמתחיל ב-test_. איש לא מקבל כלום, אבל זרימת העבודה באמת רצה, לכן כשהערך של dry_run הוא true, דלגו על יצירת הזמנות ועל פעולות צד אחרות.
{
"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?
הוסיפו צומת Code מיד אחרי צומת Webhook. X-EC-Signature נראה כך: t=<unix seconds>,v1=<hex>, כאשר v1 הוא HMAC-SHA256 של t, נקודה והגוף, עם סוד החתימה (Signing secret) של האוטומציה כמפתח. כדי להעתיק אותו, פתחו את האוטומציה השמורה ובחרו בשלב הקריאה לוובהוק שלה. לכל אוטומציה יש סוד משלה, וכלי MCP לעולם לא מחזירים אותו, לכן אוטומציה שה-AI יצר עדיין צריכה את ההעתקה הזו מלוח הבקרה. כפתור New secret מחליף אותו, והסוד הישן מפסיק לעבוד מיד, ורק בעל החשבון יכול לראות אותו, לא חבר צוות שהוזמן.
דחו t שרחוק מהשעון שלכם ביותר מ-5 דקות, השוו בזמן קבוע, וזרקו שגיאה בכשל: אז הזרימה נכשלת לפני Respond to Webhook, n8n עונה 500, ולא נשלח דבר. n8n Cloud מאפשר את מודול crypto בצמתי Code; n8n בשרת עצמי צריך את NODE_FUNCTION_ALLOW_BUILTIN=crypto. גם הפעולה Hmac של צומת Crypto עם צומת IF עובדת, אם כי השוואה ב-IF אינה בזמן קבוע, ולכן פחות מומלצת.
// 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 את הטקסט של הלקוח כהודעת המשתמש, וכל השאר בהודעת המערכת: מי העסק, העובדות שמותר לו לצטט, הטון, והשיחה האחרונה מההיסטוריה כדי ששאלת המשך תהיה מובנת. חברו את מודל השפה שתרצו, ובנוסף כלים כמו כלי HTTP Request שבודק הזמנה.
סיימו בצומת Respond to Webhook שמגיב ב-JSON ומכניס את הטקסט של הסוכן לשדה בשם reply. easyCoexistence מקצצת רווחים, מתעלמת מתשובה ריקה או שאינה מחרוזת, ושולחת את השאר כהודעת WhatsApp אחת של עד 4,096 תווים, לכן עדיף לבקש מהמודל משפטים פשוטים, ללא סימוני עיצוב.
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, בלי reply, והלקוח לא מקבל שום מענה אוטומטי.
- ריצה שנכשלה שולחת לכם מייל כדי שתוכלו לענות לאותו לקוח בעצמכם, לכל היותר פעם אחת לאוטומציה כל 6 שעות.
- שיחה שעניתם לה מהטלפון בתוך ההשהיה (4 שעות כברירת מחדל, מוגדר תחת Advanced) מדולגת כ-
human_activeלפני שקוראים ל-n8n. - כמה הודעות מהירות מתחילות כמה ריצות. צומת Wait של דקה אחת לפני שלב הקריאה לוובהוק עונה פעם אחת, כי הודעה חדשה יותר שמפעילה את אותה אוטומציה מחליפה את הריצה הממתינה.
מתי כדאי ש-n8n יקבל ישירות את הוובהוק של Meta?
כשהסוכן צריך יותר מ-20 שניות, כשהזרימה חייבת לראות כל אירוע (סטטוסים, תשובות מהטלפון, מזהי מדיה), כשהיא שולחת משהו שאף צעד לא מכסה, כמו Flow או הודעת קטלוג, או כשהעסק רוצה את ייבוא ההיסטוריה של 6 החודשים, שהולך רק ליעד ישיר שנשמר תוך 24 שעות מהחיבור. במצב ישיר האוטומציות כבויות למספר: Meta שולחת את ה-payload שלה ישירות ל-n8n, ו-easyCoexistence לא רואה את ההודעות כלל.
ב-n8n השתמשו בצומת Webhook רגיל, לא בצומת WhatsApp Trigger, שמצפה לאפליקציית Meta משלכם ולסוד שלה. הפעילו את Allow Multiple HTTP Methods, כך שנתיב ארוך ואקראי אחד מקבל גם את לחיצת היד של 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 n8n | easyCoexistence, when the automation matches | Meta, for every event on the number |
| Time to answer | 20 seconds, reply in the response | No limit: send later through the Graph API |
| Authentication | X-EC-Signature with the automation's secret | A long random secret in the URL path |
| Guards | Dedupe, phone pause and 24-hour check built in | Yours to write |
| What n8n can send | Text in the reply; the other steps of the automation can send buttons, files and templates | Any Cloud API message type, templates included |
| History import | Not available | If saved within 24 hours of connecting |
| Kept by easyCoexistence | Message text for your retention period (90 days by default), run logs 30 days | Nothing |
איך מגדירים
- 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.
- 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.
- 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.
- 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.
- 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.
טעויות נפוצות
- השארת האפשרות Respond של צומת Webhook על Immediately. n8n עונה מיד Workflow got started, הריצה רושמת HTTP 200, בלי תשובה, והלקוח לא מקבל כלום. בחרו Using 'Respond to Webhook' Node.
- הדבקת כתובת ה-Test URL, זו עם /webhook-test/. היא מאזינה רק כשהעורך ממתין לאירוע בדיקה; אוטומציות צריכות את כתובת ה-Production URL של זרימה שפורסמה.
- אימות עם סוד ההעברה של המספר. שלב הקריאה לוובהוק חתום עם סוד החתימה של האוטומציה עצמה; סוד ההעברה חותם רק אירועים שהועברו, ולכן שלבים אמיתיים נכשלים בבדיקה.
- החזרת הטקסט בצורה אחרת. נשלח רק גוף JSON ובו מחרוזת ברמה העליונה בשם reply. צורה כמו {"output": "..."} או גוף מסוג text/plain נרשמים כ-no reply, כלומר בלי תשובה.
צעד הקריאה לוובהוק שלה מעביר את הטקסט של הלקוח ל-n8n ומחזיר את התשובה, עם סינון כפילויות, השהיה כשעונים מהטלפון ובדיקת 24 השעות מובנים, ללא תשלום נוסף לכל ריצה. החל מ-US$ 9 לכל מספר מחובר בחודש, ויורד ל-US$ 0.75 ככל שמוסיפים מספרים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם ChatGPT או Claude יכולים ליצור לי את האוטומציה הזו?
כן. אחרי שמוסיפים את המחבר של easyCoexistence, מבקשים אוטומציה על המספר שלכם שמעבירה הודעות נכנסות לכתובת ה-n8n שלכם. ה-AI קורא ל-create_automation עם שלב call_webhook, ואז ל-test_automation. בקשו ממנו ליצור את האוטומציה כבויה עד שהבדיקה עוברת. מפתח החתימה לא מוחזר דרך MCP, ולכן העתיקו אותו מדף האוטומציה.
האם הזרימה יכולה לשלוח תמונות, כפתורים או תבניות?
לא דרך שדה התשובה, שנושא טקסט בלבד. תנו לאוטומציה לעשות זאת במקום: צעדים כמו "Send a picture or file", "Ask a question with buttons" ו-"Send a template" יכולים לבוא לפני "Call my webhook" או אחריו. לסוגי הודעות אחרים, שלחו אותם מצומת HTTP Request אל Cloud API, עם נקודת השליחה והאסימון ש-get_api_credentials מחזיר, והחזירו בלי reply כדי שהלקוח לא יקבל שתי תשובות.
האם זרימה אחת יכולה לענות למספרים רבים?
כן. הצביעו אוטומציה אחת לכל מספר על אותה כתובת Production URL, והסתעפו לפי channel.phone_number_id או automation.id. לכל אוטומציה יש סוד חתימה משלה, לכן בחרו את הסוד לפי automation.id לפני בדיקת החתימה.
האם n8n בשרת עצמי עובד?
כן, אם כתובת ה-Production URL שלו היא HTTPS ציבורי. easyCoexistence דוחה כתובות http, localhost וכתובות פרטיות ופנימיות בשמירת הכתובת, ושוב לפני כל קריאה, ואינה עוקבת אחרי הפניות.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-