מילון המונחים של WhatsApp Coexistence
קל להתבלבל בין המונחים של WhatsApp Coexistence. בפועל, הבלבול נובע לרוב משני אנשים שמשתמשים באותה מילה לדברים שונים. אלה ההגדרות שבהן האתר משתמש, עם קישור לעמוד שמסביר כל מונח לעומק.
EasyCoexistence מחברת מספר דרך התהליך של Meta ואז עוקבת אחר החיבור.
- Coexistence
המצב הרשמי של Meta להפעלת אפליקציית WhatsApp Business ו-Cloud API על אותו מספר בו־זמנית. זה לא API נפרד: זה אותו Cloud API, עם חיבור שמשאיר את האפליקציה פועלת.
WhatsApp Coexistence- Cloud API
ה-API של WhatsApp Business Platform שמתארח אצל Meta. כל שליחה, תבנית ווובהוק באתר הזה עוברים דרכו.
Cloud API או Coexistence- אפליקציית WhatsApp BusinessWhatsApp Business app
האפליקציה שעסק משתמש בה בטלפון. שונה מאפליקציית WhatsApp לשימוש אישי, והמספר חייב להיות בה לפני ש-Coexistence יכול לחבר אותו.
- חשבון WhatsApp BusinessWABA
האובייקט של Meta שמחזיק מספרי טלפון ותבניות. נמצא בתוך Business Portfolio. עקיפות של וובהוק מוגדרות ברמה הזו ולא לכל מספר בנפרד.
- Business Portfolio
המכל ברמת החברה ב-Meta Business Manager. מחזיק חשבון WhatsApp Business אחד או יותר. המספר של לקוח נשאר בפורטפוליו שלו, לא בזה של הספק.
Meta Tech Provider- Phone number id
המזהה של Meta למספר מחובר אחד. שליחה מכוונת אליו ולא למספר עצמו, והוא מופיע בכל payload של וובהוק נכנס.
- Embedded Signup
החלון הקופץ של Meta עצמה לחיבור. בוחרים בו את הפורטפוליו, החשבון והמספר, וב-Coexistence הוא כולל קוד שסורקים באפליקציית WhatsApp Business.
איך מספר מתחבר- Tech Provider
סטטוס של Meta שמאפשר לחברה לחבר מספרים של עסקים אחרים דרך אפליקציה מאושרת משלה. ההשגה בחינם, ומותנית באימות עסקי וב-App Review. אין בו המלצה או אישור מצד Meta.
מה זה אומר- BSPBusiness Solution Provider
חברה שמוכרת פלטפורמת הודעות, בדרך כלל תיבת דואר נכנס משותפת. חופף ל-Tech Provider, אבל מתאר את המוצר ולא את הסטטוס אצל Meta.
Coexistence או BSP- יעד הוובהוקWebhook destination, webhook override
המקום שאליו Meta שולחת את האירועים של חשבון WhatsApp Business. מוגדר כעקיפה על המינוי של אפליקציה, ולכן הסרת חיבור מסירה אותו.
וובהוקים של WhatsApp- hub.challenge
ערך ש-Meta שולחת בבקשת ה-GET של האימות. ה-endpoint חייב להחזיר אותו כגוף התשובה הגולמי. החזרת JSON במקומו היא הסיבה הנפוצה ביותר לכך שוובהוק לא מקבל כלום.
אימות וובהוק- messages
שדה הוובהוק שמעביר את מה שלקוחות שולחים. חלק מנתיב ההודעות, וזה מה שעקיפת וובהוק מנתבת הרחק מהספק.
- smb_message_echoes
שדה הוובהוק שמעביר את מה שצוות שולח מאפליקציית WhatsApp Business. קיים רק במספרי Coexistence, וכך תוכנה רואה את התשובות של בני אדם.
- חלון שירות הלקוחותCustomer service window, חלון 24 השעות
עשרים וארבע שעות מההודעה האחרונה של הלקוח, שבמהלכן טקסט חופשי נמסר. מחוץ לחלון, רק תבנית מאושרת נמסרת.
שגיאה 131047- תבניתTemplate
הודעה שמוגשת ל-Meta לבדיקה מראש. הדבר היחיד שנמסר מחוץ לחלון שירות הלקוחות, ובמספר Coexistence אפשר לשלוח אותה רק דרך ה-API.
שגיאה 132001- דירוג איכותQuality rating
ירוק, צהוב או אדום, ש-Meta קובעת לפי התגובות של הנמענים. הוא יורד לפני שזה עולה לכם משהו, ושום דבר לא מודיע על הירידה.
שגיאה 131048- שכבת הודעותMessaging tier
כמה לקוחות ייחודיים מספר יכול לפתוח איתם שיחות ביום. זז בשני הכיוונים. שונה מתפוקה, שהיא קצב.
- תפוקהThroughput
כמה הודעות בשנייה מספר יכול לשלוח. במספר Coexistence היא קבועה על ידי Meta ולא גדלה עם האיכות והשכבה.
שגיאה 130429- מכשיר מקושרLinked device
לקוח WhatsApp לשימוש אישי שמחובר במקום אחר, כמו WhatsApp Web. זה מה שכלים לא רשמיים הופכים לאוטומטי, מה שתנאי WhatsApp אוסרים, ומה שגורם לחסימת מספרים.
הסיכונים של API לא רשמי- MCPModel Context Protocol
הדרך שבה עוזר AI מגיע לכלי שאינו שלו. בקשה ותשובה בלבד: הודעה נכנסת לא יכולה להעיר שרת MCP.
שרת MCP ל-WhatsApp
למה אוצר המילים גורם לכל כך הרבה בעיות?
כי כמה מהמונחים האלה מתארים דברים ברמות שונות, אבל כולם מרגישים כאילו הם באותה רמה.
Business Portfolio מכיל WhatsApp Business Account, שמכיל מספרי טלפון, ולכל אחד מהם יש מזהה מספר טלפון. בשיחה, כולם נקראים חשבון, ולכן משפט כמו בדקו שהחשבון עובד יכול להתייחס לארבע בדיקות שונות. אותו דבר קורה עם שני החלונות של עשרים וארבע שעות בפלטפורמה, שמודדים דברים לא קשורים ולעיתים קרובות מתחלפים זה בזה.
החצי השני של הבעיה הוא ש-Meta וספקים משתמשים במילים שונות לאותו דבר, וגם הספקים עצמם לא מסכימים זה עם זה. בעמוד הזה אנחנו משתמשים באוצר המילים של Meta כשיש כזה, ואומרים במפורש כשמדובר במונח שלנו.
אילו הבדלים באמת חשובים בפועל?
שלושה, וכל אחד מהם כבר עלה למישהו ביום עבודה.
חלון שירות הלקוחות וחלון הסנכרון נמשכים שניהם עשרים וארבע שעות, ואין ביניהם שום קשר. האחד קובע אם אפשר לשלוח טקסט חופשי, ונמדד מההודעה האחרונה של הלקוח. השני קובע אם עדיין אפשר למשוך את היסטוריית הצ'אט, ונמדד מרגע ההתחברות.
מכשיר מקושר אינו API. זהו לקוח WhatsApp לשימוש אישי שמחובר במקום אחר, וזה מה שכלים לא רשמיים הופכים לאוטומטי ומה שעלול לגרום לחסימת מספרים.
ויעד של וובהוק (Webhook) אינו הגדרה של מספר. זהו מעקף במינוי של אפליקציה לחשבון, ולכן הוא נעלם כשמסירים חיבור וצריך להגדיר אותו מחדש בחיבור חוזר.
שאלות נפוצות
האם Coexistence הוא API שונה מ-Cloud API?
לא. Coexistence הוא דרך לחבר מספר ל-Cloud API, תוך השארת אפליקציית WhatsApp Business פעילה בו. נקודות הקצה, פורמט ההודעות והכללים זהים.
מה ההבדל בין Business Portfolio לבין WABA?
Business Portfolio הוא מיכל ברמת החברה בתוך Meta Business Manager. WhatsApp Business Account נמצא בתוכו ומכיל את מספרי הטלפון. Portfolio אחד יכול להכיל כמה חשבונות WABA.
האם BSP הוא אותו דבר כמו Tech Provider?
יש חפיפה, אבל מדובר בדברים שונים. Tech Provider הוא סטטוס של Meta שמאפשר לחברה לחבר מספרים של עסקים אחרים דרך האפליקציה שלה. BSP מתאר בדרך כלל חברה שמוכרת פלטפורמת הודעות, וייתכן שיש לה את הסטטוס הזה או שלא.
מה הקשר בין MCP לבין WhatsApp?
אין קשר מובנה. MCP הוא פרוטוקול שמאפשר לעוזר AI לגשת לכלי, ושרת MCP של WhatsApp חושף מספר כאחד מהכלים האלה. הוא אינו יכול לקבל הודעות, אלא רק לפעול כשמבקשים ממנו.
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםלא תחויבו במשך 3 ימים. בטלו בכל זמן.