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

הפעלת תהליך Typebot ב-WhatsApp עם Coexistence

ערוץ ה-WhatsApp של Typebot מבקש אסימון גישה (Access Token), מזהה של WhatsApp Business Account ומזהה מספר הטלפון, ובתמורה נותן כתובת Callback URL ואסימון אימות. ממלאים את שלושת הראשונים מהמספר המחובר, משאירים ריק את הסוד האופציונלי של האפליקציה ב-Typebot, וקובעים את הכתובת ואת אסימון האימות שלו כיעד הוובהוק (Webhook) של המספר.

Pro

Typebot מציג את האינטגרציה עם WhatsApp כחלק ממסלול Pro, ולא במסלולים Free או Starter.

Optional

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

Never

האשף של Typebot דוחה אסימון שתוקפו לא הוגדר כ-never.

20 msg/s

למספר שפועל גם באפליקציית WhatsApp Business וגם עם ה-Cloud API, התפוקה קבועה.

אילו שדות ב-Typebot מקבלים ערכים מהמספר המחובר?

האשף של Typebot ל-WhatsApp, תחת לשונית Share של הבוט, מבקש ארבעה דברים: סוד אפליקציה, אסימון של System User, מזהה WhatsApp Business Account ומזהה מספר הטלפון.

שלושה מהם מגיעים ישירות מהחיבור. לוח הבקרה מציג את מזהה ה-WABA, את מזהה מספר הטלפון ואת אסימון הגישה של המספר, והכלי get_api_credentials מחזיר את אותם ערכים אם עוזר חכם מביא אותם בשבילכם. מדביקים אותם בשדות המתאימים.

את סוד האפליקציה משאירים ריק. Typebot משתמש בו לדבר אחד בתעבורה נכנסת: בדיקת הכותרת X-Hub-Signature-256 ש-Meta מוסיפה לכל משלוח. במספר שמחובר דרך Tech Provider, Meta חותמת עם הסוד של הספק, והוא אף פעם לא משותף, ולכן כל ערך שתקלידו שם יגרום ל-Typebot לדחות כל הודעה אמיתית. כשהשדה ריק, Typebot מדלג על הבדיקה ומקבל את המשלוח.

לאן נכנסים ה-Callback URL והאסימון של Typebot?

ליעד הוובהוק של המספר, ולא ללוח הבקרה של אפליקציה ב-Meta.

האשף של Typebot אומר להדביק את ה-Callback URL ואת אסימון האימות בהגדרות ה-WhatsApp של אפליקציית Meta שלכם. עם Coexistence דרך EasyCoexistence אין אפליקציה שלכם בתמונה: Meta מנתבת את האירועים של המספר ליעד שהוגדר בחיבור. לכן מעתיקים את שני הערכים מהשלב האחרון ב-Typebot וקובעים אותם כיעד, בלוח הבקרה או באמצעות set_webhook_destination.

אחר כך Meta שולחת בקשת אימות מסוג GET אל Typebot, Typebot עונה עם ה-challenge, ומאותו רגע כל הודעה למספר מגיעה לבוט. אסימון האימות של Typebot הוא חד-פעמי: הוא נמחק ממסד הנתונים של Typebot ברגע שאימות מצליח. אם תגדירו את היעד שוב בהמשך, מריצים קודם את האשף מחדש כדי ליצור אסימון חדש.

1Typebot wizardToken, WABA id and phone number id; app secret empty
2Callback URL + verify tokenCopied from Typebot's last step
3Webhook destinationSet on the connected number
4Meta verifiesTypebot echoes the challenge, delivery starts

מה הבוט עושה עם חלון ה-24 שעות?

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

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

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

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

  • מדביקים ב-Typebot סוד אפליקציה של Meta. המשלוחים חתומים עם הסוד של ה-Tech Provider, ולכן Typebot דוחה כל הודעה בטענה שהחתימה לא תקינה.
  • משתמשים שוב באסימון אימות ישן של Typebot. הוא נמחק אחרי אימות מוצלח אחד, ולכן קביעה חוזרת של היעד דורשת אסימון חדש מהאשף.
  • משתפים את כתובת ה-callback. כשבדיקת החתימה כבויה, הכתובת עצמה היא מה שמאפשר לבקשה להיכנס, ולכן מתייחסים אליה כמו אל סיסמה.
עושים את זה עם EasyCoexistence

מחברים את המספר ב-easycoexistence.com, מעתיקים ל-Typebot את האסימון, את מזהה ה-WABA ואת מזהה מספר הטלפון, וקובעים את כתובת ה-callback של Typebot כיעד הוובהוק. המחיר מתחיל ב-US$ 9 למספר בחודש ויורד עד US$ 1 ככל שמוסיפים מספרים, ו-3 הימים הראשונים הם תקופת ניסיון.

שאלות נפוצות

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

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

הצוות עדיין יראה בטלפון את ההודעות של הבוט?

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

אפשר ש-Typebot ו-n8n יקבלו שניהם את ההודעות של אותו מספר?

לא. למספר יש יעד וובהוק אחד. אם שניהם צריכים את האירועים, מכוונים את היעד אל n8n, והתהליך שם מעביר את ה-payload הגולמי אל כתובת ה-callback של Typebot.

Typebot שומר את השיחות?

Typebot שומר נתוני סשן ותוצאות משלו, כמו בכל ערוץ. EasyCoexistence אף פעם לא שומרת תוכן של הודעות: Meta מוסרת ישירות ליעד שקבעתם.

המשיכו לקרוא

Connect a Botpress bot to WhatsApp with CoexistenceRun a Botpress agent on Meta's official Cloud API, on a number the team still answers from the WhatsApp Business app, using Manual Configuration.Answer WhatsApp messages with a Dify appPut a Dify chat app or agent behind a WhatsApp number on Meta's official Cloud API, with the team still answering from the WhatsApp Business app.Connect WhatsApp to n8n on the official Cloud APIRoute WhatsApp messages into an n8n workflow over Meta's official Cloud API, on a number the business still answers from the phone. No linked device.WhatsApp webhooks: routing messages straight to your serverHow WhatsApp webhooks work, what Meta sends, and how to route incoming messages directly to your own endpoint instead of through a provider's platform.The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.

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

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

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

נבדק ב-

Typebot ב-WhatsApp עם Coexistence