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

מחברים מספר Coexistence לתיבת הודעות WhatsApp Cloud ב-Chatwoot

תיבת WhatsApp Cloud של Chatwoot מבקשת שלושה ערכים: מזהה חשבון WhatsApp Business, מזהה מספר הטלפון ואסימון גישה (Access Token). מספר Coexistence חושף את שלושתם. יוצרים איתם את התיבה, ואז מגדירים כיעד הוובהוק (Webhook) של המספר את כתובת ה-URL של Chatwoot, עם אותו אסימון אימות. מכאן הצוות עונה גם מ-Chatwoot וגם מהטלפון.

3 values

מזהה WABA, מזהה מספר הטלפון ואסימון גישה: זה מה שההגדרה הידנית של WhatsApp Cloud ב-Chatwoot מבקשת.

smb_message_echoes

Chatwoot מטפל באירוע Coexistence הזה, ולכן תשובות שנשלחו מאפליקציית WhatsApp Business מופיעות בשיחה.

Per number

Meta מאפשרת לכל מספר עסקי לשאת כתובת callback משלו לוובהוק, שגוברת על ברירת המחדל של האפליקציה.

איך מחברים מספר Coexistence ל-Chatwoot?

בשני מקומות, לפי הסדר.

ב-Chatwoot מוסיפים תיבה, בוחרים WhatsApp, ובוחרים בספק WhatsApp Cloud עם ההגדרה הידנית. מזינים את המספר, את מזהה מספר הטלפון, את מזהה חשבון WhatsApp Business ואת אסימון הגישה. את כולם מציג לוח הבקרה של EasyCoexistence עבור החיבור, והכלי get_api_credentials מחזיר אותם לעוזר. אחר כך Chatwoot מציג לתיבה כתובת URL של וובהוק ואסימון אימות.

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

1Copy credentialsWABA id, phone number id, token
2Create Chatwoot inboxWhatsApp Cloud, manual setup
3Copy webhook + tokenShown by Chatwoot
4Set destinationSame URL and verify token

האם תשובות שנשלחו מהטלפון מופיעות ב-Chatwoot?

כן. במספר Coexistence, תשובה שהוקלדה באפליקציית WhatsApp Business מדווחת על ידי Meta כאירוע smb_message_echoes. משימת הוובהוק של Chatwoot מזהה את השדה הזה ורושמת את ההודעה כהודעה יוצאת בשיחה הנכונה. קוד המקור שלו מתאר את המקרה במפורש: עסקים שעונים גם מ-Chatwoot וגם מהאפליקציה, כשההודעות מסתנכרנות ל-Chatwoot.

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

הודעות שנשלחות מ-Chatwoot יוצאות דרך Cloud API באותו מספר, ולכן הן מופיעות גם בטלפון.

למה בתיבת Chatwoot לא ממלאים סוד אפליקציה?

כי המשלוחים חתומים בסוד שאין לכם. Meta חותמת כל וובהוק בסוד האפליקציה של האפליקציה שמחזיקה במינוי, וזו האפליקציה של EasyCoexistence, והסוד הזה אינו משותף לאף אחד.

בקוד המקור הנוכחי של Chatwoot, הכותרת X-Hub-Signature-256 נבדקת בערוץ WhatsApp Cloud שהוגדר ידנית רק כשנשמר בו סוד אפליקציה, או כשהערוץ נוצר דרך Embedded Signup של Chatwoot עצמו. תיבה ידנית בלי סוד אפליקציה מקבלת את המשלוחים. תיבה שמולא בה סוד כלשהו דוחה את כולם כלא מורשים.

ההגנה שחלה כאן היא אסימון האימות. בוחרים ערך אקראי וארוך, כי הוא מה שמאפשר ל-Chatwoot להבדיל בין בקשת האימות של Meta לבין בקשה של מישהו אחר.

מה Chatwoot לא יכול לעשות במספר הזה?

לקבל וובהוקים בשני מקומות בו זמנית. Meta מנתבת את הוובהוקים של מספר ליעד אחד, ולכן כל עוד Chatwoot מחזיק בו, תהליך אוטומטי ב-n8n לא יקבל את אותם אירועים. אם צריך את שניהם, מפנים את היעד למתווך קטן משלכם, שמעביר כל משלוח גם ל-Chatwoot וגם לתהליך.

מגבלות Coexistence חלות כמו בכל מקום: ה-API שולח עד 20 הודעות בשנייה, טקסט חופשי יוצא רק בתוך 24 שעות מההודעה האחרונה של הלקוח, ותבניות מכסות את כל מה שאחרי זה.

את אפליקציית WhatsApp Business עדיין צריך לפתוח לפחות פעם ב-14 ימים, ו-EasyCoexistence עוקבת אחרי זה.

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

  • למלא סוד אפליקציה בתיבת Chatwoot. המשלוחים חתומים בסוד של האפליקציה של EasyCoexistence, ולכן Chatwoot דוחה כל אחד מהם כלא מורשה.
  • להשתמש ב-EasyCoexistence באסימון אימות שונה מזה ש-Chatwoot מציג. האימות של Meta נכשל והתיבה לא מקבלת אף הודעה.
  • לבחור ב-Embedded Signup של Chatwoot במקום בהגדרה הידנית. כך המספר מתחבר דרך אפליקציית Meta של Chatwoot עצמו, וזה חיבור נפרד.
עושים את זה עם EasyCoexistence

מחברים את המספר ב-easycoexistence.com, מעתיקים את הפרטים שלו לתיבת WhatsApp Cloud ב-Chatwoot, ומגדירים את יעד הוובהוק ל-Chatwoot. מ-US$ 9 למספר בחודש, ויורד עד US$ 1 ככל שמוסיפים מספרים, עם תקופת ניסיון של 3 ימים.

שאלות נפוצות

האם זה עובד עם Chatwoot באירוח עצמי?

כן. כתובת ה-URL של הוובהוק משתמשת בדומיין של Chatwoot שלכם במקום app.chatwoot.com, ושאר ההגדרה זהה.

צריך אפליקציית Meta משלי בשביל Chatwoot?

לא. המספר מחובר דרך EasyCoexistence, שמספקת את הפרטים ומנתבת את הוובהוקים. המדריך של Chatwoot מתאר יצירת אפליקציית Meta רק כי הוא מניח שאין לכם אחת.

אפשר לחבר כמה מספרים ל-Chatwoot?

כן. יוצרים תיבת WhatsApp Cloud אחת לכל מספר, ומגדירים ליעד הוובהוק של כל מספר את כתובת ה-URL ואת אסימון האימות של התיבה שלו.

האם EasyCoexistence רואה את השיחות?

לא. Meta מעבירה את הוובהוקים ישירות ל-Chatwoot, ו-EasyCoexistence אינה שומרת תוכן של שיחות.

המשיכו לקרוא

Verifying a WhatsApp webhook endpointMeta calls your endpoint with a GET challenge before delivering anything. What it sends, what to return, and why a wrong answer fails silently.The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.Connect WhatsApp to Activepieces on a Coexistence numberUse Activepieces' WhatsApp Business piece on a Coexistence number: paste the token and WABA id, point the webhook at the trigger, and leave the app secret empty.Receive WhatsApp webhooks in a Supabase Edge FunctionMake a Supabase Edge Function the webhook destination of a Coexistence number: answer Meta's verification, store messages in Postgres, reply through the Cloud API.MCP or a webhook: which one you actually needMCP acts when asked. A webhook reacts when something happens. Why an assistant cannot answer customers on its own, and why most systems need both.

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

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

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

נבדק ב-

תיבת WhatsApp Cloud ב-Chatwoot עם Coexistence