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

מספר אחד.האפליקציה וה-API, בו-זמנית.

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

EasyCoexistence מחבר את המספר ואז משגיח על החיבור.

להתחיל תקופת ניסיון3 ימים בחינם. שום חיוב לא מתבצע עד סוף תקופת הניסיון.
+1 415 555 0188
אפליקציית WhatsApp Businessהצוות עונה מהטלפון, כמו קודם
Cloud APIהמערכות שלכם, או עוזר AI, על אותו קו
שני הממשקים רואים את אותה שיחה. מה שה-API שולח מופיע באפליקציה, ומה שהצוות מקליד באפליקציה מגיע כאירוע smb_message_echoes, כך שהתוכנה אף פעם לא עונה מעל אדם שכבר ענה.
בלי שמירת הודעות כברירת מחדלאפליקציה עסקית + Cloud APIMCP ל-Claude ול-ChatGPTמתחברים תוך 2 דקות

הבחירה שהייתה פעם, וכבר לא קיימת

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

לפנימספר אחד, בחירה אחת
להישאר באפליקציה

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

בלי API
לעבור ל-API

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

בלי אפליקציה
היוםמספר אחד, שניהם
מספר אחד
אפליקציית WhatsApp BusinessCloud API

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

מי מפעיל מספר בצורה הזאת

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

הטלפון נשארעסק עם מספר אחד

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

הרבה מספרים, חשבון אחדסוכנות, חברת ייעוץ או מפתח

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

איך מספר מגיע לשני הממשקים, ולאן הולכים אירועי ההודעות

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

  1. מכינים את נקודת הקצה לפני שההצטרפות מתחילה

    Meta מאמתת יעד לפני שהיא מוסרת אליו משהו. היא פונה לכתובת ה-URL שלכם בבקשת GET שמכילה את hub.mode=subscribe, את אסימון האימות שלכם בשדה hub.verify_token ואת הערך בשדה hub.challenge, ונקודת הקצה צריכה להחזיר את הערך הזה בדיוק כפי שהוא.

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

    נדרש
    נקודת קצה ב-HTTPS שמחזירה את hub.challenge בבקשת ה-GET של Meta
    זמן
    כדקה
    מה תקבלו
    יעד ש-Meta יכולה לאמת ברגע שהמספר מתחבר
    עדיין שום דבר לא מחובר. השלב הזה קובע לאן ההודעות יגיעו.
    ספק באמצע המסלולנשמרות בשרתים שלו
    Meta
    הפלטפורמה שלומקבלת ושומרת את ההודעות
    אתםעותק, לפי לוח הזמנים שלו
    EasyCoexistenceהגדרות בלבד
    Meta
    נקודת הקצה שלכםעדיין לא אומתה
    אנחנוקובעים את המסלול, לא נמצאים עליו
  2. מריצים את ה-Embedded Signup של Meta וסורקים באפליקציה

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

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

    נדרש
    גישה ל-Business Portfolio, והטלפון שעליו נמצא המספר
    זמן
    שתיים עד שלוש דקות
    מה תקבלו
    ה-Cloud API מחובר למספר שהאפליקציה עדיין משתמשת בו
    הממשק השני מופיע. הראשון לא מוסר.
    אחרי העברהממשק אחד
    המספר
    Cloud API בלבדאפליקציית Business מתה על המספר הזה
    אחרי Coexistenceשני ממשקים
    המספר
    אפליקציית WhatsApp Businessאותם צ'אטים ואותה היסטוריה
    Cloud APIעל אותו קו
  3. מפנים את אירועי ההודעות למערכת שלכם

    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. כך לוח הבקרה נשאר שימושי, ותוכן השיחות אף פעם לא עובר דרכנו.

    נדרש
    נקודת הקצה מהשלב הראשון, אחרי ש-Meta אימתה אותה
    זמן
    מוחל ברגע שההצטרפות מסתיימת
    מה תקבלו
    הודעות שנמסרות מ-Meta אליכם, ואנחנו מחוץ למסלול ההודעות
    אילו אירועים הולכים לאן, ברגע שהעקיפה פעילה.
    אירועים תפעולייםנמסרים אלינו
    account_updateשינויים במצב החיבור
    phone_number_quality_updateאיכות וקצב העברה
    account_review_updateתוצאות בדיקה
    מסלול ההודעותנמסרים אליכם
    messagesכל מה שלקוח שולח
    smb_message_echoesמה שהצוות שולח מהאפליקציה
    השרת שלכםישירות, אף פעם לא דרכנו
  4. שומרים על החיבור פעיל, ושורדים חיבור מחדש

    Meta מנתקת מספר Coexistence אחרי כארבעה עשר ימים ללא פעילות במכשיר הראשי. אפשר לחבר אותו מחדש, ואנחנו רושמים את הניתוק כמצב נפרד ולא מתייחסים אליו כלקוח שעזב.

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

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

למה צוותים מפעילים מספר בצורה הזאת

  • לשמור את המספר שכבר מודפס על רכבים, קבלות ואתר, ואת שגרת העבודה בנייד שסביבו.
  • להוסיף שליחה דרך API, עיבוד וובהוקים ותבניות בלי להעביר אף אחד לכלי חדש.
  • להשאיר את תעבורת ההודעות מחוץ לתיבת הדואר המשותפת של ספק, כך שהשיחות לא יושבות בפלטפורמה של מישהו אחר.
  • לתת לסוכנות דרך להחזיק מספרים של הרבה לקוחות בחשבון אחד, כל אחד מחובר ב-Business Portfolio של הלקוח עצמו.

זכאות ומגבלות מעשיות

  • המספר חייב כבר להיות פעיל באפליקציית WhatsApp Business. מספר שנמצא באפליקציית WhatsApp הרגילה צריך לעבור לשם קודם.
  • שיתוף היסטוריית הצ'אטים הקיימת הוא החלטה חד-פעמית בזמן ההצטרפות, ואי אפשר לשנות אותה אחר כך.
  • צ'אטים קבוצתיים לא נכללים ב-API במספרי Coexistence, אצל כל ספק.
  • המכשיר הראשי צריך פעילות תקופתית. Meta מנתקת את החיבור אחרי כארבעה עשר ימים בלעדיה.
  • מסלולי האימות והתג של Meta שונים במספרי Coexistence, והזמינות לפי אזור משתנה עם המדיניות של Meta.
טקסט חופשי0 עד 24 שעות מההודעה האחרונה של הלקוחתבנית בלבדאחרי זה, עד שהלקוח כותב שוב
השעון מתאפס בכל פעם שהלקוח שולח משהו. זה הכלל ששובר אינטגרציות בסביבת הייצור, כי בדיקות תמיד קורות שניות אחרי הודעה, כשטקסט חופשי עדיין עובד.

מה אנחנו מנתבים אליכם, ומה נשאר אצלנו

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

נמסרים ישירות לנקודת הקצה שלכםמסלול ההודעות. כברירת מחדל הוא אף פעם לא עובר דרכנו.
  • messagesכל מה שלקוח שולח למספר
  • smb_message_echoesמה שהצוות שלכם שולח מאפליקציית WhatsApp Business
נמסרים אלינוהמסלול התפעולי. מזה הניטור עשוי.
  • account_updateמצב החיבור: הוסר, נותק מהשותף, חובר מחדש, הוגבל
  • phone_number_quality_updateשינויים בדירוג האיכות ובקצב ההעברה
  • account_alertsהתראות ש-Meta מעלה נגד החשבון
  • account_review_updateתוצאות של בדיקה של Meta
  • business_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 מסמן את החיבור כפגוע, והאיכות, שכבת ההודעות ורמת קצב ההעברה נשמרים בכל בדיקה, כך שירידה נראית לפני שהיא עולה בשליחה.

לחבר מספר ולשמור על מספר הם מוצרים שונים. השני הוא הסיבה שהמוצר הזה קיים.

2 minutes

הזמן האופייני לחיבור מספר, באמצעות סריקת קוד מאפליקציית WhatsApp Business.

24 hours

כמה זמן תשובת לקוח משאירה את החלון פתוח לתשובות בטקסט חופשי.

20 msg/s

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

6 months

כמה היסטוריית שיחות Meta מסנכרנת ל-API כשהמספר מתחבר לראשונה.

שאלות נפוצות

האם הצוות שלי צריך להפסיק להשתמש בטלפון?

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

האם אאבד את השיחות הקיימות?

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

האם אפשר לבטל את זה?

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

האם זה אותו דבר כמו ממשקי WhatsApp לא רשמיים?

לא, וההבדל קובע אם המספר יישאר פעיל. Coexistence הוא פיצ'ר רשמי של Meta ב-Cloud API. שערים לא רשמיים מפעילים את WhatsApp Web כמכשיר מקושר, מפרים את התנאים ועלולים לגרום לחסימת מספרים.

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

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

להתחיל תקופת ניסיון3 ימים בחינם. שום חיוב לא מתבצע עד סוף תקופת הניסיון.

להמשיך לקרוא