חיבור בוט Botpress ל-WhatsApp עם Coexistence
משתמשים באינטגרציית ה-WhatsApp של Botpress במצב Manual Configuration. מדביקים את אסימון הגישה (Access Token) ואת מזהה המספר של המספר המחובר, בוחרים Verify Token ומשאירים את App ID ואת Client Secret ריקים. אחר כך מגדירים את כתובת ה-URL של הוובהוק (Webhook) ב-Botpress ואת ה-Verify Token כיעד הוובהוק של המספר, ו-Meta תעביר כל הודעה לבוט.
שדה Client Secret ב-Botpress: אם משאירים אותו ריק, אימות החתימה של הוובהוק מדולג.
שדות הוובהוק שהמדריך של Botpress נרשם אליהם, ביניהם הודעות ועדכוני סטטוס של תבניות.
חלון שירות הלקוחות שהודעה מלקוח פותחת, ובתוכו אפשר לשלוח כל הודעת שירות.
איזו הגדרה ב-Botpress עובדת עם מספר Coexistence?
Manual Configuration. שאר האפשרויות מחברות מספר דרך אפליקציית Meta של Botpress, וזה הצטרפות נפרדת של המספר ולא דרך להשתמש במספר שכבר מחובר.
באינטגרציית ה-WhatsApp פותחים את הרשימה הנפתחת Configuration ובוחרים Manual Configuration. מתבקשים למלא Verify Token, Access Token, Default Bot Phone Number ID, ולא חובה גם App ID, Client Secret ו-WABA ID.
אסימון הגישה, מזהה המספר ומזהה ה-WABA מגיעים מהחיבור: לוח הבקרה מציג אותם, והפקודה get_api_credentials מחזירה אותם לעוזר AI. ה-Verify Token הוא כל מחרוזת שתבחרו. את App ID ואת Client Secret משאירים ריקים. המדריך של Botpress מציג את הסוד כשדה למילוי, אבל בהגדרת האינטגרציה הוא מסומן כאופציונלי, ובלעדיו אימות החתימה מדולג. וזה משנה, כי Meta חותמת כל משלוח בסוד האפליקציה של ה-Tech Provider, ואף לקוח לא מחזיק בו.
איך הוובהוק של Botpress מקבל את ההודעות מ-Meta?
דרך יעד הוובהוק של המספר. לפי המדריך של Botpress, מדביקים את כתובת ה-URL של הוובהוק שלו ואת ה-Verify Token שלכם בהגדרות ה-WhatsApp של אפליקציית Meta. כאן אין אפליקציית Meta משלכם: Meta מנתבת את אירועי המספר ליעד שהחיבור קובע. לכן מעתיקים את כתובת ה-URL של הוובהוק ש-Botpress מציג לאינטגרציה, ומגדירים אותה, עם אותו Verify Token, כיעד בלוח הבקרה או באמצעות set_webhook_destination.
Meta שולחת בקשת GET לאימות, Botpress עונה לה, והמשלוח מתחיל. כש-Botpress שומר הגדרה ידנית הוא גם בודק את האסימון: הוא שואל את Graph איזו אפליקציה הנפיקה אותו, כך שאסימון לא תקין או שבוטל נכשל בשמירה ולא בהודעה הראשונה.
הטיפול של Botpress מעבד גם את smb_message_echoes, האירוע ש-Meta שולחת כשמישהו עונה מאפליקציית WhatsApp Business. כך תשובה מהטלפון נראית לבוט ולא נשארת מוסתרת ממנו.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
מה הבוט צריך לדעת על Coexistence?
שאולי כבר מדבר איתם בן אדם. אפליקציית WhatsApp Business ממשיכה לעבוד על המספר, ולכן לקוח יכול לקבל תשובה מהטלפון ומהבוט באותה דקה. כדאי להחליט בתוך הזרימה מה קורה כשמגיע הד: רוב הצוותים משהים את הבוט לאותו איש קשר לזמן מה, כדי לא לדבר מעל מי שנכנס לשיחה.
הדבר השני הוא תזמון. בוט שעונה להודעות נכנסות פועל בתוך חלון שירות הלקוחות של 24 שעות, שבו מותר טקסט חופשי. זרימה ששולחת משהו יום אחר כך, מעקב או תזכורת, צריכה תבנית מאושרת, וטקסט חופשי שם מחזיר קוד שגיאה 131047. המדריך של Botpress נרשם לשדות הסטטוס של תבניות בדיוק בשביל הודעות יזומות כאלה.
וקצב השליחה קבוע על 20 הודעות בשנייה למספר Coexistence, הרבה מעל מה שבוט שיחה שולח.
טעויות נפוצות
- למלא את Client Secret בסוד של אפליקציית Meta משלכם. החתימה אף פעם לא תתאים, ו-Botpress יענה על כל משלוח בשגיאה 401.
- לבחור באפשרות OAuth או בארגז החול במקום ב-Manual Configuration. הן מחברות מספר דרך האפליקציה של Botpress ולא דרך המספר שכבר מחובר.
- להתעלם מהדים. בלי כלל לתשובות שנשלחות מהטלפון, הבוט עונה מעל אדם שכבר נכנס לשיחה.
מחברים את המספר ב-easycoexistence.com, מדביקים את האסימון ואת מזהה המספר ב-Manual Configuration של Botpress, ומגדירים את כתובת ה-URL של הוובהוק של Botpress כיעד. מ-US$ 9 למספר בחודש, ויורד עד US$ 1 ככל שמוסיפים מספרים, ו-3 הימים הראשונים בחינם.
שאלות נפוצות
האם בטוח לדלג על בדיקת החתימה?
ההגנה עוברת לכתובת ה-URL. Botpress יוצר כתובת וובהוק נפרדת לכל אינטגרציה, ולכן חשוב לשמור אותה פרטית. מדיה עדיין צריך להביא מ-Meta באמצעות האסימון, ואירוע מזויף לא יכול לזייף אותו.
האם אותו מספר יכול גם להזין את n8n?
למספר יש יעד וובהוק אחד. מפנים אותו למערכת אחת ומעבירים משם הלאה, אם מערכת שנייה צריכה את האירועים.
האם Botpress צריך את מזהה ה-WABA שלי?
בהגדרה שלו הוא מסומן כאופציונלי כרגע, ונאמר שיהיה חובה בגרסה ראשית עתידית, לכן כדאי למלא אותו מתוך החיבור.
האם ההודעות עוברות דרך EasyCoexistence?
לא. Meta מוסרת ישירות לכתובת ה-URL של הוובהוק ב-Botpress, והתוכן אף פעם לא נשמר אצלנו.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-