התחברותהתחילו תקופת ניסיון
Meta Tech Provider

מדריך האוטומציות ב-WhatsApp: טריגרים, שלבים, משתנים ומגבלות

לאוטומציות של easyCoexistence על מספר WhatsApp יש התחלה מהודעה שמגיעה, מאיש קשר שמקבל תג, או מקריאה מהמערכת שלכם. להודעה יש ארבע התאמות: כל הודעה, יש מילת מפתח, הודעה ראשונה ומחוץ לשעות הפעילות. אחר כך באים שלבים, עד 30 בשורה ו-60 בסך הכול, עם ענפים, שאלות וסוכני AI. כל הודעה מקבלת לכל היותר אוטומציה אחת, וכללי מילות המפתח נבדקים קודם.

30 steps

שלבים בשורה אחת, 60 בסך הכול, ענפים מקוננים לעומק 4; עצירה וחזרה לשלב יכולות רק לסיים שורה.

30 keywords

לכל אוטומציה, עד 100 תווים לכל אחד; מספיק אחד מהם, ואותיות גדולות וקטנות אינן משנות.

20,000

התווים המותרים בהוראות של שלב "השב עם AI", ותשובותיו מוגבלות ל-50 עד 2,000 טוקנים.

1,380 min

השהיית ההמתנה הארוכה ביותר לשלב בודד היא 23 שעות, כך שהודעת הטקסט הבאה עדיין נופלת בתוך חלון 24 השעות של Meta.

20 seconds

זמן התשובה שיש לוובהוק לענות בו לפני שהשלב "קרא לוובהוק שלי" נכשל; שדה reply בתשובה נשלח ללקוח.

30 days

תקופת שמירת ריצות, עם כל הודעת התחלה ותשובה; טקסט ההודעות נמחק אחרי תקופת השמירה שבחרתם (30, 90 או 365 ימים, 90 כברירת מחדל).

אילו טריגרים והתאמות יכולים להפעיל אוטומציה ב-WhatsApp?

הטריגר הראשי, "מגיעה הודעה" (message_received), פועל כשלקוח כותב למספר: טקסט, תמונות, וידאו, מסמכים, קול, מדבקות, מיקומים, כרטיסי איש קשר, תשובות של כפתור ורשימה, והזמנות. הודעה קולית נכתבת כטקסט באמצעות מפתח OpenAI או OpenRouter שלכם ונשמרת כ-"[voice message]" ואחריה המילים, שמילת מפתח יכולה להתאים להן; בלי מפתח כזה היא נשארת "[voice message]". ריאקציות, סטטוסים והודעות מערכת לעולם לא מפעילים ריצה, וצ'אטים קבוצתיים לא מגיעים ל-API במספר Coexistence. שני טריגרים נוספים לא מתחילים מהודעה. "איש קשר מקבל תג" (tag_added) פועל בכל פעם שאיש קשר שאפשר להגיע אליו במספר מקבל את התג שציינתם, מתוך זרימה, סוכן AI, מכם ב-Conversations או מ-update_contact. "המערכת שלכם קוראת לכתובת" (webhook_received) פועל כשהמערכת שלכם שולחת בקשת POST עם JSON ומספר טלפון לכתובת של האוטומציה, עם הסוד של האוטומציה כאסימון Bearer, עבור הזמנה חדשה או תור; הגוף, עד 20 KB, זמין כ-{{vars.webhook.*}}. בשניהם {{message}} ריק, ואדם שלא כתב ב-24 השעות האחרונות יכול לקבל רק send_template. אין טריגר מתוזמן. בטריגר ההודעה, "מחוץ לשעות הפעילות" בודק את הימים שסומנו תחת "פתוח ב-" כפתוחים בין "מ-" ל-"עד", באזור זמן של IANA כמו America/Sao_Paulo; שעת הסיום מוקדמת משעת ההתחלה היא משמרת לילה (22:00 עד 06:00), ויום שלא סומן נחשב סגור כל היום. ב-API, hours מקבל timezone, days (1 = יום שני עד 7 = יום ראשון, הימים שבהם אתם פתוחים) ו-start ו-end. "הודעה ראשונה" מופעלת כש-easyCoexistence פותחת רשומה לצ'אט: ההודעה הראשונה של לקוח מאז שהופעלה אוטומציה למספר, כולל לקוחות ותיקים, או ההודעה הראשונה אחרי 30 ימים של שקט. צ'אט שפתחתם מהטלפון נחשב כבר כנקרא.

Every message (any)Runs on whatever the customer writes, when no more specific automation matched.
Has keyword (keyword)Runs when the message holds one of up to 30 keywords, in one of three modes.
First message (first_message)Runs on a chat easyCoexistence has not seen, or after 30 days without a message from that customer.
After hours (outside_hours)Runs while you are closed: Timezone, Open on days, and From and To in 24-hour HH:MM.

אילו מצבי התאמה קיימים למילות מפתח?

תחת "היכן המילה צריכה להופיע", "מכיל" ("בכל מקום בהודעה") הוא ברירת המחדל, "מתחיל ב-" הוא "בתחילה", ו"זהה בדיוק" הוא "כל ההודעה". ב-API, keywordMode הוא contains, starts_with או exact. ההתאמה מתעלמת מרווחים בקצוות ההודעה ומאותיות גדולות וקטנות, אבל לא מתעלמת מדיאקריטים (כמו é או ç) או מסימני פיסוק, ו"מכיל" מתאים גם בתוך מילים ארוכות יותר. תיבת "בדוק את זה" שמתחת למילות המפתח עונה "רצה: יש התאמה" עם מילת המפתח, או "לא רצה: אף מילת מפתח לא תואמת", לכל דוגמה שתקלידו.

MatchesDoes not match
Contains "price"What is the price? · PRICES pleaseHow much is it?
Contains "oi"Oi! · Boa noite (inside noite)Olá
Starts with "menu"Menu pleaseCan I see the menu?
Is exactly "menu"Menu · menu with spaces around itmenu? · the menu
Contains "preço"Qual o preço?Qual o preco?

מה עושה כל שלב, ואילו שדות הוא מקבל?

השלבים רצים מלמעלה למטה, עד 30 בשורה אחת ו-60 באוטומציה, כולל ענפים, ולפחות אחד מהם חייב לעשות משהו מלבד המתנה, עצירה, "פיצול למסלולים", "AI בוחר את המסלול" ו"חזרה לשלב". שלב מסתעף מחזיק שורת שלבים לכל מסלול ועוד שורת "אחרת", וענפים מקוננים עד 4 רמות. בתפריט "בחירת שלב" לכל אחד יש שם ושורה קצרה, שמצוטטים להלן לשישה השלבים הבסיסיים. "שאל שאלה" (ask) שולח את ההודעה שלו עם עד 10 כפתורים, ש-3 מהם מוצגים ככפתורים לחיצים ושאר הכפתורים מופיעים ברשימה ונענים לפי מספר, ממתין עד 1,380 דקות לתשובה ושומר אותה בשדה של איש קשר כטקסט, אימייל, מספר, טלפון או אחד הכפתורים; תשובה שגויה גוררת שאילת השאלה שוב עד 3 פעמים. "תשובות סוכן" (agent) מעביר את ההודעה לאחד מסוכני ה-AI שלכם, "שליחת תמונה או קובץ" (send_file) שולח תמונה או PDF מהקבצים שלכם, ו"העברה לאדם" (handoff) משהה את הבוט בצ'אט הזה למשך 1 עד 168 שעות, 24 כברירת מחדל, ושולח לכם אימייל. "פיצול למסלולים" (condition) ו"AI בוחר את המסלול" (ai_decide) מסתעפים לפי כללים או לפי משמעות. "AI שומר פרטים" (ai_extract), "שמירה באיש קשר" (set_field) ו"תיוג" (tag) כותבים שדות ותגים של איש קשר, ו"קריאה ל-API" (http_request) קורא לכל API ב-HTTPS ושומר את תשובת ה-JSON שלו כ-{{vars.<name>...}}. "הפעלת אוטומציה" (start_automation) מריץ אוטומציה אחרת לאותו אדם, עד 3 רמות עומק, "חזרה לשלב" (goto) קופץ למזהה שלב כדי לחזור בלולאה, ו"עדכנו אותי" (notify_owner) שולח לכם אימייל, לכל היותר 20 בשעה לכל אוטומציה. אם שלב נכשל, השלבים שאחריו מדולגים והריצה מסתיימת כ"נכשלה". "קרא לוובהוק שלי" שולח בקשת POST עם JSON, עם event "automation.step", dry_run, run_id, המספר, איש הקשר (wa_id, name), ההודעה (id, type, text, at) ועד 10 הודעות אחרונות מהצ'אט, וחתום ב-X-EC-Signature כ-t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> עם "סוד חתימה" של השלב. הכתובת חייבת להיות HTTPS ציבורית, והפניות לא נעקבות.

Reply with text (reply_text)"Send a fixed message": a Message of up to 4,096 characters, with variables.
Send a template (send_template)"Send an approved template": Template name, Language code, up to 20 body variables by position.
Reply with AI (ai_reply)"Your AI writes the reply": Provider, Model, Instructions, Earlier messages it reads, Longest reply (tokens).
Call my webhook (call_webhook)"Hand off to n8n or your backend": a Webhook URL; {"reply": "..."} returned within 20 seconds is sent.
Wait (wait)"Pause before the next step": 1 to 1,380 Minutes; your reply from the phone skips the rest.
Stop (stop)"End the automation": allowed only as the last step of its line.

אילו משתנים שלבים יכולים למלא?

ארבעה מתמלאים מההודעה שהפעילה את הריצה, כתובים בסוגריים מסולסלים כפולים; {{contact.<field>}} מוסיף שדה של איש קשר (וגם contact.name ו-contact.phone) ו-{{vars.<path>}} את מה ששלבים קודמים שמרו, כמו התשובה של שלב "קריאה ל-API". הם פועלים בשדה ההודעה של "השב בטקסט", במשתני הגוף של תבנית, בהוראות של "השב עם AI" ובטקסט של שלבים אחרים כמו "שאל שאלה"; במשתני תבנית, השבבים "הוספה:" מוסיפים אותם. ערך לא ידוע, כמו פרופיל ללא שם, הופך לריק. שליחת תבנית נושאת רק משתני גוף לפי מיקום, ולכן תבנית עם משתנים בשם, תמונת כותרת או משתנה כותרת, או כפתור עם משתנה, לא ניתנת לבחירה עדיין, ומשתנה שנשאר ריק גורם ל-Meta לדחות את השליחה.

  • {{first_name}}: המילה הראשונה בשם הפרופיל של הלקוח ב-WhatsApp ("שם פרטי").
  • {{name}}: שם הפרופיל המלא ("שם מלא").
  • {{message}}: טקסט ההודעה, או הסימון שלה כמו "[image]" יחד עם הכיתוב ("ההודעה שלהם").
  • {{phone}}: מספר הלקוח בספרות בינלאומיות בלי פלוס, כמו 5511999998888 ("הטלפון שלהם").
  • בבדיקה, הלקוח הוא "לקוח לבדיקה" והטלפון הוא 15550000000.

אילו הגדרות קיימות, וכמה ברירות מחדל יש להן?

שתי הגדרות נמצאות תחת "מתקדם", הכפתור שליד מתג ההפעלה בעורך, ושלב ה-AI מוסיף לו שתיים משלו. שדה שהושמט לוקח את ברירת המחדל שלו, בעורך וגם דרך create_automation. הזמנים קבועים ולא ניתנים להגדרה: תשובת AI מקבלת 45 שניות, וובהוק מקבל 20 שניות. שם אוטומציה יכול להכיל עד 120 תווים. לסוכן AI יש הגדרות משלו: הודעות קודמות שהוא קורא, 0 עד 40 (ברירת מחדל 20), התשובה הארוכה ביותר 100 עד 4,000 אסימונים (ברירת מחדל 800), עד 10 קריאות לכלים בכל תשובה (ברירת מחדל 5) ושעות העברה לאדם, 1 עד 168 (ברירת מחדל 24).

Pause on a chat after I answer it (hours)takeoverHours, 0 to 168, default 4. 0 turns the pause off; a reply still ends a waiting step.
AI replies per chat per hour, at mostaiMaxPerHour, 1 to 60, default 10, counted per chat in a one-hour window.
Earlier messages it readshistory, 0 to 20, default 10, from the messages kept for that chat.
Longest reply (tokens)maxTokens, 50 to 2,000, default 600. An answer that reaches it stops there.
The On and Off switchenabled, default true: a new automation saves On, in the editor and through create_automation.
Try itSamples of up to 2,000 characters, 60 tests per hour in the dashboard.

איזו אוטומציה עונה כשכמה מתאימות?

לכל היותר אחת, לפי סדר קבוע: קודם "יש מילת מפתח", אחר כך "הודעה ראשונה", אחר כך "מחוץ לשעות הפעילות", ואחר כך "כל הודעה", ובאותו סוג הישנה ביותר קודמת. רק אוטומציות פעילות ולא מושהות מתחרות, כך שכשכלל מילת המפתח כבוי, או מושהה בגלל מפתח AI שנדחה, האוטומציה הכללית עונה במקומו. שתי תוצאות מפתיעות אנשים. לקוח חדש שכותב בלילה מקבל את אוטומציית "הודעה ראשונה", לא את "מחוץ לשעות הפעילות", כי "הודעה ראשונה" מדורגת גבוה יותר. והודעה שאוטומציית מילת מפתח עונה לה לעולם לא מגיעה לסוכן AI או לשלב "השב עם AI" ב"כל הודעה", לכן שימו את הסוכן או את שלב ה-AI בתוך אוטומציית מילת המפתח כשרוצים את שניהם. הודעה שעונה על שלב "שאל שאלה" פתוח שייכת לשאלה הזו, ואף אוטומציה אחרת לא מתחילה ממנה. אוטומציות של תג ושל וובהוק מתחילות מהאירועים שלהן ואינן לוקחות חלק בסדר הזה.

אילו מנגנוני הגנה מובנים?

הרצה מפעילה אותם ללא הגדרה, וסיבות הדילוג בלשונית הריצות מציינות אותם כשהם עוצרים ריצה:

  • הודעה ש-Meta מעבירה פעמיים מפעילה ריצה אחת: כפילויות נזרקות לפי מזהה ההודעה.
  • ריאקציות, סטטוסים, השליחות של האוטומציה עצמה והעתקים שלכם מהאפליקציה לעולם לא מפעילים ריצה.
  • השב בטקסט, שאל שאלה, שליחת תמונה או קובץ, השב עם AI, תשובת סוכן ותשובת וובהוק דורשים שההודעה האחרונה של הלקוח תהיה מתחת ל-24 שעות; שליחת תבנית לא.
  • תשובה שאתם מקלידים באפליקציית WhatsApp Business משהה את האוטומציה בצ'אט הזה, וריצה שממתינה שם מדלגת על שאר השלבים שלה.
  • הודעה חדשה יותר שמפעילה את אותה אוטומציה בצ'אט מחליפה את הריצה שעדיין ממתינה בשלב "המתנה"; הודעה שעונה על שאלה פתוחה הולכת במקום זאת לשאלה הזו.
  • שליחות ממספר מרוחקות לפחות 100 ms זו מזו, מתחת למגבלה של Meta, 20 בשנייה למספרי Coexistence.
  • שלב שנכשל שולח אליכם אימייל, לכל היותר פעם אחת לכל אוטומציה כל 6 שעות; מפתח AI שנדחה משהה את האוטומציות שמשתמשות בספק הזה ושולח אימייל אחד.

מה לוקח כלי create_automation?

שרת ה-MCP כולל תשעה עשר כלים לאוטומציות ולמה שהן משתמשות בו. שמונה הם לאוטומציות: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs ו-get_automation_run. שמונה הם לסוכנים ולקבצים: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge ו-test_agent. שלושה הם לאנשים: list_conversations, get_conversation ו-update_contact. create_automation מקבל connection_id (מ-list_numbers), name, enabled, trigger, steps ו-settings, ב-snake_case כמו keyword_mode ו-max_tokens; גם camelCase מתקבל. אובייקטי השלבים הם reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} ו-wait {minutes}, ואז ask {text, buttons, save_to, expect, retry_text, wait_minutes}, agent {agent_id, wait_seconds}, send_file {file_id, caption}, condition {paths, otherwise}, ai_decide {provider, model, instructions, paths, otherwise}, ai_extract {provider, model, fields}, set_field {key, value}, tag {action, tag}, http_request {method, url, headers, body, save_as}, start_automation {automation_id}, handoff {hours, note}, notify_owner {text}, goto {to} ו-stop. update_automation משאיר את השדות שלא נתתם, ו-steps, כשניתן, מחליף את כל הרשימה. שגיאות מציינות את השדה, כמו "trigger.keywords: Add at least one keyword", "steps.2: Stop must be the last step of its line" או "steps.0: save your openai API key on the Automations page first". מפתחות AI לעולם לא עוברים דרך MCP. בדוגמה, ההמתנה של דקה מאפשרת ללקוח ששולח כמה שורות בבת אחת לקבל תשובה אחת.

create_automation arguments: an after-hours AI assistant, saved Off to test first
{
  "connection_id": "<connection_id from list_numbers>",
  "name": "After-hours assistant",
  "enabled": false,
  "trigger": {
    "type": "message_received",
    "match": "outside_hours",
    "hours": {
      "timezone": "America/Sao_Paulo",
      "days": [1, 2, 3, 4, 5, 6],
      "start": "08:00",
      "end": "18:00"
    }
  },
  "steps": [
    { "type": "wait", "minutes": 1 },
    {
      "type": "ai_reply",
      "provider": "openrouter",
      "model": "google/gemini-omni-1.2-flash",
      "prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
      "history": 10,
      "max_tokens": 600
    }
  ],
  "settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}

טעויות נפוצות

  • שימוש במילת מפתח של שתי אותיות עם "מכיל". "oi" מתאים גם ל-"noite" ו-"boi", כך שהאוטומציה עונה להודעות שלא נועדה להן; השתמשו ב"זהה בדיוק", או במילת מפתח ארוכה יותר.
  • כתיבה של הגרסה עם הדיאקריטים בלבד. ההתאמה מתעלמת מאותיות גדולות וקטנות אבל לא מדיאקריטים, כך ש-"preço" מפספס לקוחות שמקלידים "preco"; הוסיפו את שתי הגרסאות.
  • ציפייה ש"הודעה ראשונה" תדלג על לקוחות קבועים. היא מופעלת לכל לקוח שהצ'אט שלו לא נראה ב-easyCoexistence במשך 30 ימים, כך שלקוחות ותיקים מקבלים את ברכת ברוכים הבאים בהודעה הראשונה שלהם אחרי שהפעלתם אותה.
  • בחירת תבנית שדורשת תמונת כותרת או כפתור העתקת קוד. אוטומציות ממלאות רק משתני גוף, ולכן העורך מציג אותה אך לא נותן לבחור בה, ואם הגדרתם דרך MCP, השליחה נדחית על ידי Meta והריצה נכשלת.
עושים את זה עם EasyCoexistence

easyCoexistence מריצה את האוטומציות האלה על מספר WhatsApp Business שאתם ממשיכים להשתמש בו באפליקציה, דרך Cloud API של Meta ו-Coexistence. בנו אותן בעורך, תחת "אוטומציות" ו"אוטומציה חדשה", או תנו ל-ChatGPT או ל-Claude לקרוא ל-create_automation ול-test_automation דרך שרת ה-MCP, שיש לו יותר מ-30 כלים. מ-US$ 9 לכל מספר מחובר בחודש, יורד ל-US$ 0.75 ככל שמוסיפים מספרים, כולל תקופת ניסיון של 3 ימים.

שאלות נפוצות

האם אוטומציה יכולה להתפצל לפי מה שהלקוח אומר?

כן. "פיצול למסלולים" (condition) מסתעף לפי טקסט ההודעה, שדה של איש קשר, תג, תשובת API קודמת או שעות הפעילות שלכם, ו"AI בוחר את המסלול" (ai_decide) בוחר לפי משמעות, בכל שפה, על המודל שלכם. כל מסלול מחזיק שורת שלבים משלו, ושורת "אחרת" תופסת את השאר. אפשר גם להעביר את ההחלטה ל-n8n או לשרת שלכם דרך "קרא לוובהוק שלי", שיכול להחזיר {"reply": "..."} שונה לכל מקרה.

האם יש הגבלה על אוטומציות או ריצות?

אין תקרה לריצות ואין חיוב נוסף עליהן, וגם אין הגבלה על מספר האוטומציות שיש למספר. המגבלות שחלות הן לכל צ'אט: תשובות AI לשעה, כלל 24 השעות של Meta לטקסט, וההשהיה אחרי שאתם עונים מהטלפון.

האם אפשר להעביר או להעתיק אוטומציה למספר אחר?

להעביר אותה, משנים את החיבור בעורך, או עם update_automation וכ-connection_id חדש; ריצות שעדיין ממתינות במספר הישן מסתיימות כ"הוחלפה". כדי להעתיק, בקשו מה-AI לקרוא אותה עם list_automations וליצור את אותו טריגר ואותם שלבים במספר האחר.

מה קורה לריצות ממתינות כשאני עורך אוטומציה?

הן ממשיכות. ריצה שמונחת על "המתן" ממשיכה בשלב המספר הבא של האוטומציה כפי שהיא שמורה ברגע שהריצה מתעוררת, כך שעריכה יכולה לשנות מה שנשלח. כדי לעצור אותן, כבו את האוטומציה: אז הן מסתיימות כ"דולגה" עם "האוטומציה כבויה".

המשיכו לקרוא

האוטומציה לא עונה ב-WhatsApp? סטטוסים של הרצות וסיבות דילוגלמה אוטומציה ב-WhatsApp לא ענתה: כל סטטוס הרצה וכל סיבת דילוג, עם התווית המדויקת והתיקון, ורשימת בדיקה להודעות שלא מפעילות הרצה.הודעות המשך אוטומטיות ב-WhatsApp: שלב ההמתנה ותזכורות בתבניתאיך לשלוח הודעות המשך אוטומטיות ב-WhatsApp: המתנה של עד 23 שעות בתוך חלון ה-24 שעות, תבניות מאושרות אחריו, והפסקה כשהלקוח משיב.צ'אטבוט ב-WhatsApp או AI משלכם? חברו את ה-AI שאתם כבר משתמשים בו למספר ה-WhatsApp Business שלכםבמקום בונה צ'אטבוטים, חברו את ה-AI שכבר יש לכם, Claude, GPT או Gemini, עם המפתח שלכם, למספר ה-WhatsApp Business שלכם.כתבו את הפרומפט ל-WhatsApp AI: טון, כללים ומה שאסור לו להבטיחאיך לכתוב פרומפט ל-WhatsApp AI: עובדות עסקיות, טון, תשובות קצרות, העברה לאדם, מה אסור להבטיח, ודוגמה מלאה.סוכן AI ל-WhatsApp ב-n8n, והתשובה נכתבת בזרימת העבודה שלכםהפעילו סוכן AI ל-WhatsApp ב-n8n: POST חתום מביא את ההודעה והשיחה, והתשובה חוזרת תוך 20 שניות.מדריך לכלי MCPהכלים של מחבר EasyCoexistence, יותר מ-30 בסך הכול, מה כל כלי מקבל, ואילו מהם נחסמים כשהחיוב פג.

מוכנים להתחיל?

מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.

התחילו תקופת ניסיון בחינם

נבדק ב-