מספר אחד.האפליקציה וה-API, בו-זמנית.
Coexistence הוא המצב הרשמי של Meta להפעלת אפליקציית WhatsApp Business ושל ה-Cloud API על אותו מספר בו-זמנית. הצוות ממשיך לענות מהטלפון, עם אותן שיחות ואותה היסטוריה, בזמן שהתוכנה שולחת ומקבלת הודעות באותו קו.
EasyCoexistence מחבר את המספר ואז משגיח על החיבור.
הבחירה שהייתה פעם, וכבר לא קיימת
Coexistence הוא לא API חדש. הוא ביטול של פיצול דרכים שמנע כמעט מכל עסק קטן לעשות אוטומציה למשהו.
הצוות עונה מהטלפון. אי אפשר לעשות אוטומציה, לחבר מערכות או למדוד שום דבר.
בלי APIתוכנה יכולה לגשת למספר. אפליקציית Business מפסיקה לעבוד עליו והצוות עובר לכלים אחרים.
בלי אפליקציהMeta מחברת את ה-Cloud API למספר שאפליקציית WhatsApp Business עדיין משתמשת בו. שני הממשקים פעילים על אותו קו, וכל אחד רואה מה השני שולח.
מי מפעיל מספר בצורה הזאת
שתי קבוצות שרוצות דברים הפוכים מאותה יכולת, ולכן החיבור עצמו חשוב יותר מכל לוח בקרה שנבנה מעליו.
צוות קטן, מספר שמודפס על רכב מסחרי או על חלון ראווה, וערבים שעוברים בתשובות על אותן ארבע שאלות. הם לא מחליפים אף אחד. הם רוצים שאישורים, תזכורות והתשובה הראשונה אחרי שעות הפעילות יקרו בלי אדם, בזמן שהטלפון ממשיך לשמש לכל השאר.
הרבה לקוחות, לכל אחד מספר שאסור להעביר או לגעת בו. הם צריכים שהמערכות שהם בונים יוכלו להגיע למספרים האלה, והם צריכים להוסיף את המספר הבא בלי שיחת מכירה. Coexistence היא הדרך הרשמית היחידה למספר שהצוות של הלקוח עדיין עונה בו ידנית.
איך מספר מגיע לשני הממשקים, ולאן הולכים אירועי ההודעות
ארבעה שלבים. השלב היחיד שנוגע בטלפון הוא סריקה, והשלב שקובע את הארכיטקטורה שלכם הוא הראשון.
מכינים את נקודת הקצה לפני שההצטרפות מתחילה
Meta מאמתת יעד לפני שהיא מוסרת אליו משהו. היא פונה לכתובת ה-URL שלכם בבקשת GET שמכילה את hub.mode=subscribe, את אסימון האימות שלכם בשדה hub.verify_token ואת הערך בשדה hub.challenge, ונקודת הקצה צריכה להחזיר את הערך הזה בדיוק כפי שהוא.
היעד חייב לעבוד ב-HTTPS, ואסימון אימות הוא חובה. אנחנו בודקים את שניהם לפני שהקריאה יוצאת, כך שכתובת URL פגומה נכשלת אצלנו ולא נראית מחוברת בזמן שהיא לא מוסרת כלום.
עדיין שום דבר לא מחובר. השלב הזה קובע לאן ההודעות יגיעו. ספק באמצע המסלולנשמרות בשרתים שלוהפלטפורמה שלומקבלת ושומרת את ההודעותאתםעותק, לפי לוח הזמנים שלוEasyCoexistenceהגדרות בלבדנקודת הקצה שלכםעדיין לא אומתהאנחנוקובעים את המסלול, לא נמצאים עליומריצים את ה-Embedded Signup של Meta וסורקים באפליקציה
נפתח החלון הקופץ של Meta עצמה. בוחרים את ה-Business Portfolio, את חשבון WhatsApp Business ואת המספר שכבר רשום באפליקציית WhatsApp Business, ואז מאשרים את החיבור בטלפון באמצעות סריקת קוד.
כאן גם בוחרים אם לשתף את היסטוריית הצ'אטים הקיימת. זו החלטה חד-פעמית בזמן ההצטרפות, ואי אפשר לשנות אותה אחר כך. אפליקציית Business ממשיכה לעבוד ברגע שהסריקה מסתיימת.
הממשק השני מופיע. הראשון לא מוסר. אחרי העברהממשק אחדCloud API בלבדאפליקציית Business מתה על המספר הזהאחרי Coexistenceשני ממשקיםאפליקציית WhatsApp Businessאותם צ'אטים ואותה היסטוריהCloud APIעל אותו קומפנים את אירועי ההודעות למערכת שלכם
Meta מאפשרת לאפליקציה לעקוף את היעד שאליו נמסרים הוובהוקים (Webhooks) של חשבון WhatsApp Business מסוים. אנחנו מגדירים את העקיפה הזאת לכתובת ה-URL שלכם, וכך שני השדות של מסלול ההודעות, messages וגם smb_message_echoes, עוברים ישירות מ-Meta אליכם.
את השדות התפעוליים אנחנו שומרים אצלנו, כי מהם הניטור עשוי: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update וגם phone_number_name_update. כך לוח הבקרה נשאר שימושי, ותוכן השיחות אף פעם לא עובר דרכנו.
אילו אירועים הולכים לאן, ברגע שהעקיפה פעילה. אירועים תפעולייםנמסרים אלינומסלול ההודעותנמסרים אליכםmessagesכל מה שלקוח שולחsmb_message_echoesמה שהצוות שולח מהאפליקציההשרת שלכםישירות, אף פעם לא דרכנושומרים על החיבור פעיל, ושורדים חיבור מחדש
Meta מנתקת מספר Coexistence אחרי כארבעה עשר ימים ללא פעילות במכשיר הראשי. אפשר לחבר אותו מחדש, ואנחנו רושמים את הניתוק כמצב נפרד ולא מתייחסים אליו כלקוח שעזב.
מה שתופס אנשים לא מוכנים הוא מה שניתוק עושה למסלול. Meta שומרת את היעד כעקיפה במינוי של האפליקציה שלנו לחשבון, ולכן אירוע PARTNER_REMOVED מסיר את התקנת האפליקציה ולוקח איתו את העקיפה. חיבור מחדש מחזיר את השליחה ואת הניטור, אבל לא את היעד שלכם. אנחנו מחזירים אותו אוטומטית, כי המספר הראשון שנתקל בכלל הזה התחבר מחדש בלי בעיה והפסיק בשקט למסור הודעות לשרת של הלקוח.
מה חיבור מחדש מחזיר מעצמו, ומה צריך להחזיר. מוחזר על ידי Metaאוטומטישליחהה-Cloud API עובד שובאירועים תפעולייםהניטור מתחדשנעלם עם האפליקציהצריך להחיל מחדשעקיפת הוובהוק שלכםהוסרה יחד עם האפליקציהמסירת ההודעות אליכםנפסקת בשקטאנחנו מחילים אותה מחדשבכל חיבור מחדש
למה צוותים מפעילים מספר בצורה הזאת
- לשמור את המספר שכבר מודפס על רכבים, קבלות ואתר, ואת שגרת העבודה בנייד שסביבו.
- להוסיף שליחה דרך API, עיבוד וובהוקים ותבניות בלי להעביר אף אחד לכלי חדש.
- להשאיר את תעבורת ההודעות מחוץ לתיבת הדואר המשותפת של ספק, כך שהשיחות לא יושבות בפלטפורמה של מישהו אחר.
- לתת לסוכנות דרך להחזיק מספרים של הרבה לקוחות בחשבון אחד, כל אחד מחובר ב-Business Portfolio של הלקוח עצמו.
זכאות ומגבלות מעשיות
- המספר חייב כבר להיות פעיל באפליקציית WhatsApp Business. מספר שנמצא באפליקציית WhatsApp הרגילה צריך לעבור לשם קודם.
- שיתוף היסטוריית הצ'אטים הקיימת הוא החלטה חד-פעמית בזמן ההצטרפות, ואי אפשר לשנות אותה אחר כך.
- צ'אטים קבוצתיים לא נכללים ב-API במספרי Coexistence, אצל כל ספק.
- המכשיר הראשי צריך פעילות תקופתית. Meta מנתקת את החיבור אחרי כארבעה עשר ימים בלעדיה.
- מסלולי האימות והתג של Meta שונים במספרי Coexistence, והזמינות לפי אזור משתנה עם המדיניות של Meta.
מה אנחנו מנתבים אליכם, ומה נשאר אצלנו
Meta מאפשרת לאפליקציה לעקוף את היעד שאליו חשבון WhatsApp Business מוסר את הוובהוקים שלו. אנחנו מגדירים את העקיפה הזאת לכתובת ה-URL שלכם, וכך האירועים מתפצלים לשניים.
messagesכל מה שלקוח שולח למספרsmb_message_echoesמה שהצוות שלכם שולח מאפליקציית WhatsApp Business
account_updateמצב החיבור: הוסר, נותק מהשותף, חובר מחדש, הוגבלphone_number_quality_updateשינויים בדירוג האיכות ובקצב ההעברהaccount_alertsהתראות ש-Meta מעלה נגד החשבוןaccount_review_updateתוצאות של בדיקה של Metabusiness_capability_updateשינויים במגבלת ההודעות וביכולותphone_number_name_updateאישורים ודחיות של שם התצוגה
אם למספר לא הוגדרה עקיפה, אירועי ההודעות שלו נופלים לכתובת ברירת המחדל שלנו, שם המטפל משליך אותם בלי לשמור. זה נאכף בקוד ולא מובטח במדיניות: אין לתוכן השיחות שום מסלול לאחסון.
כלל ארבעה עשר הימים, ומה שהוא שובר ואף אחד לא מזכיר
Meta מנתקת חיבור Coexistence אחרי כארבעה עשר ימים ללא פעילות במכשיר הראשי. אפשר לחבר אותו מחדש, ולכן אנחנו שומרים את זה כמצב נפרד ולא סופרים את זה כלקוח שעזב.
ההשלכה היקרה מגיעה אחר כך. יעד ההודעות שלכם הוא לא הגדרה של המספר, אלא עקיפה (override) במינוי של האפליקציה שלנו לחשבון WhatsApp Business. ניתוק מסיר את התקנת האפליקציה, והעקיפה נעלמת יחד איתה. מחברים מחדש, השליחה עובדת, הניטור עובד, וההודעות מפסיקות להגיע לשרת שלכם בלי ששום דבר מדווח על שגיאה.
אנחנו מחילים מחדש את העקיפה בכל חיבור מחדש. ההתנהגות הזאת קיימת כי זה קרה: מספר נתקל בכלל הזה, התחבר מחדש בלי בעיה, והפסיק בשקט למסור הודעות.
לחיצת יד שנכשלת באותו רגע, כי השרת שלכם היה למטה או שהאסימון השתנה, נרשמת בציר הזמן של החיבור והיעד נשמר במקום להימחק, כך שמספיק לשמור אותו שוב כדי לתקן.
מה נשבר בשקט, ואיך אנחנו מגלים
אפליקציית WhatsApp Business ממשיכה לעבוד כמעט בכל אחת מהתקלות שלמטה, ולכן אף אחד לא שם לב. אלה התקלות שאנחנו בודקים, וכך אנחנו בודקים אותן.
מזוהה מהוובהוק account_update של Meta, ובמיוחד PARTNER_REMOVED, ולא מוסק משדה שהופך ל-false. אנחנו בכוונה לא קוראים את is_on_biz_app לצורך הזה, כי הוא false באופן לגיטימי במספרים שאינם Coexistence וגרם לניתוקים שגויים.
כלל חוסר הפעילות של המכשיר הראשי של Meta. אפשר לחבר אותו מחדש, ולכן הוא נרשם כמצב נפרד ולא כלקוח שעזב, וחיבור מחדש מחזיר את השליחה ואת הניטור.
היעד שמור כעקיפה במינוי של האפליקציה שלנו לחשבון, ולכן ניתוק מסיר אותו. השליחה חוזרת בחיבור מחדש, והמסירה לשרת שלכם לא. אנחנו מחילים מחדש את העקיפה בכל פעם, כי מספר שזה קרה לו התחבר מחדש בלי בעיה והפסיק בשקט למסור הודעות.
אנחנו מחזיקים את האסימון של הלקוח ואת ה-System User token שלנו מול אותו חשבון. כשאחד נדחה, השני קורא את החשבון וקובע מי מהשניים באמת נשבר, כך שאסימון שבוטל כבר לא נראה כמו מספר שאבד.
נבדקת מול Meta לפי לוח זמנים. דירוג RED מסמן את החיבור כפגוע, והאיכות, שכבת ההודעות ורמת קצב ההעברה נשמרים בכל בדיקה, כך שירידה נראית לפני שהיא עולה בשליחה.
לחבר מספר ולשמור על מספר הם מוצרים שונים. השני הוא הסיבה שהמוצר הזה קיים.
הזמן האופייני לחיבור מספר, באמצעות סריקת קוד מאפליקציית WhatsApp Business.
כמה זמן תשובת לקוח משאירה את החלון פתוח לתשובות בטקסט חופשי.
קצב השליחה של מספר Coexistence, שנקבע על ידי Meta ואי אפשר להגדיל אותו.
כמה היסטוריית שיחות Meta מסנכרנת ל-API כשהמספר מתחבר לראשונה.
שאלות נפוצות
האם הצוות שלי צריך להפסיק להשתמש בטלפון?
לא. זו כל המטרה של Coexistence. WhatsApp Business ממשיך לעבוד על אותו מספר, עם אותן שיחות, וה-API פועל במקביל אליו.
האם אאבד את השיחות הקיימות?
לא. הן נשארות באפליקציה, ו-Meta מסנכרנת בערך שישה חודשי היסטוריה ל-API כשהמספר מתחבר, כך שלתוכנה יש הקשר במקום להתחיל מאפס.
האם אפשר לבטל את זה?
כן. אפשר לנתק מספר, והאפליקציה ממשיכה לפעול כפי שפעלה תמיד. החיבור לא משנה לצמיתות שום דבר במספר עצמו.
האם זה אותו דבר כמו ממשקי WhatsApp לא רשמיים?
לא, וההבדל קובע אם המספר יישאר פעיל. Coexistence הוא פיצ'ר רשמי של Meta ב-Cloud API. שערים לא רשמיים מפעילים את WhatsApp Web כמכשיר מקושר, מפרים את התנאים ועלולים לגרום לחסימת מספרים.
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
להתחיל תקופת ניסיון3 ימים בחינם. שום חיוב לא מתבצע עד סוף תקופת הניסיון.