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

וובהוק שיחות WhatsApp: אירועי Calling API, ושיחות על מספר Coexistence

שדה calls בוובהוק מדווח על אירועי WhatsApp Business Calling API: חיבור עם תשובת SDP או הצעה, סטטוסי שיחה RINGING, ACCEPTED ו-REJECTED, סיום עם COMPLETED או FAILED ומשך השיחה, וכן call_recording_available או call_transcription_available. מדריך Coexistence של Meta מציין ששיחות קוליות ווידאו לא משתנות באפליקציה WhatsApp Business ואינן נתמכות ב-Cloud API, ולכן השיחות נשארות בטלפון.

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

Not supported

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

2,000

המינימום היומי של הודעות, בנמענים ייחודיים, שנדרש ממספר לפני שימוש ב-Calling API.

7 days

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

wacid

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

whatsapp_business_messaging

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

מה מדווח שדה calls בוובהוק (Webhook)?

כל מה שקורה לשיחה שנוצרה או התקבלה דרך Calling API, כשדה אחד עם אירוע לכל שלב. שיחה שהעסק יזם מייצרת אירוע חיבור, עדכוני סטטוס ואירוע סיום. שיחות שמנותבות דרך SIP מדווחות על call_created במקום connect, בלי סשן SDP. אירוע קשור אחד נמצא בשדה אחר: כשלקוח משיב לבקשת הרשאה לשיחה, התשובה מגיעה בשדה messages כהודעה אינטראקטיבית מסוג call_permission_reply.

connectThe call is ready to connect; session carries the SDP to apply to your WebRTC stack.
call_createdA SIP call was attempted, business- or user-initiated.
statuses (type call)RINGING, ACCEPTED or REJECTED for a business-initiated call.
terminateThe call ended: status COMPLETED or FAILED, with times and duration when answered.
call_recording_availableA media id for the finished audio recording.
call_transcription_availableA media id for the transcript, a JSON document.

איך נראה וובהוק של שיחה?

אותה מעטפת כמו בכל וובהוק של WhatsApp, עם מערך calls תחת value, והשדה field מוגדר לערך calls. direction מציין BUSINESS_INITIATED או USER_INITIATED. השדה from ושדה to נושאים את מספרי הטלפון, to_user_id הוא ה-BSUID של הלקוח, וכל אחד ממספרי הטלפון יכול להיעדר עבור לקוח שמשתמש בשם משתמש. metadata.phone_number_id מזהה את המספר שלכם, כמו בכל שדה אחר. זו הדוגמה של Meta ל-Call Connect, עם ערכי הדוגמה כפי ש-Meta מדפיסה אותם:

Meta's example: the Call Connect webhook
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "16315553601",
              "phone_number_id": "<PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<CALLEE_NAME>",
                  "username": "<USERNAME>"
                },
                "wa_id": "16315553602",
                "user_id": "<BSUID>",
                "parent_user_id": "<PARENT_BSUID>"
              }
            ],
            "calls": [
              {
                "id": "wacid.ABGGFjFVU2AfAgo6V-Hc5eCgK5Gh",
                "to": "16315553601",
                "to_user_id": "<BSUID>",
                "to_parent_user_id": "<PARENT_BSUID>",
                "from": "16315553602",
                "event": "connect",
                "timestamp": "1671644824",
                "direction": "BUSINESS_INITIATED",
                "session": {
                  "sdp_type": "answer",
                  "sdp": "<<RFC 8866 SDP>>"
                }
              }
            ]
          },
          "field": "calls"
        }
      ]
    }
  ]
}

אילו שדות מוסיף אירוע terminate?

terminate הוא האירוע שרוב המערכות שומרות, כי הוא סוגר את השיחה. השדות שלו, לפי מדריך העזר של Meta:

  • status: COMPLETED כשהשיחה הסתיימה בלי שגיאות בלתי צפויות, כולל שיחות שלא נענו; FAILED כשהשיחה לא התחברה או נשברה.
  • השדות start_time, end_time ו-duration בשניות, מופיעים רק כשהצד השני ענה.
  • errors: השדות code, message, href ו-error_data.details, כשהסטטוס הוא FAILED.
  • biz_opaque_callback_data: מחרוזת המעקב שלכם, כשהעברתם אחת בעת התחלת השיחה או קבלתה.

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

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

איך אירועי שיחה אחת מתחברים זה לזה?

לפי מזהה השיחה, שמתחיל ב-wacid וחוזר בכל אירוע של אותה שיחה. שיחה שהעסק יזם מדווחת על connect עם תשובת SDP, סטטוסים RINGING ואז ACCEPTED או REJECTED, ולבסוף terminate. שיחה שהמשתמש יזם מדווחת על connect עם הצעת SDP שהמערכת שלכם צריכה לענות לה, ואחר כך terminate. אירועי הקלטה ותמלול, כשהם מופעלים, מגיעים אחרי terminate. שמרו אירועים לפי מזהה יחד עם event, כי ניסיונות חוזרים שולחים אותם שוב, וסדר ההגעה אינו מובטח. רשימת הדרישות המוקדמות המלאה של Calling API נמצאת בדף על שיחות במספר Coexistence.

מה ה-AI שלכם יכול לעשות לגבי שיחות במספר Coexistence?

לעבוד בצ'אט, בזמן שהשיחות נשארות אצל האדם בטלפון. easyCoexistence לא נרשם לשדה calls ואין לו כלי שיחות; החיבור והאוטומציות שלו מכסים הודעות ותבניות. בפועל זה אומר שתשובת AI יכולה לומר ללקוח מתי מישהו זמין לדבר ובאיזה מספר להתקשר, אוטומציה לפי מילת מפתח יכולה להשיב למילים "שיחה" או "טלפון" במידע הזה, והבעלים עונה לשיחה באפליקציה WhatsApp Business כרגיל.

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

  • הרשמה לשדה calls של מספר Coexistence והמתנה לאירועים. Meta מציינת ששיחות אינן נתמכות ב-Cloud API עבור המספרים האלה.
  • לצפות ש-start_time ו-duration יופיעו בכל terminate. הם מופיעים רק כשהשיחה נענתה; שיחה שלא נענתה עדיין מסתיימת ב-COMPLETED.
  • לחפש תשובות הרשאה בשדה calls. הן מגיעות בשדה messages, כהודעה אינטראקטיבית מסוג call_permission_reply.
  • להשאיר הקלטות ותמלולים אצל Meta. אפשר להורידם במשך 7 ימים מרגע הוובהוק, ואחר כך הם נעלמים.
עושים את זה עם EasyCoexistence

כל מספר מנוטר 24/7, כולל הכלל של 14 הימים שמנתק מספר שהאפליקציה שלו לא נפתחת. מ-US$ 9 ועד US$ 0.75 למספר בחודש, ויורד ככל שמוסיפים מספרים, עם 3 ימים ראשונים בחינם.

שאלות נפוצות

האם לקוחות מאבדים את כפתור השיחה כשמספר מתחבר ל-API דרך Coexistence?

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

האם תמחור Calling API דומה לתמחור ההודעות?

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

האם אפשר להקליט או לתמלל שיחת Calling API?

כן, כשההקלטה או התמלול מופעלים. אחרי השיחה Meta שולחת call_recording_available עם מזהה מדיה של האודיו, או call_transcription_available עם מזהה של מסמך JSON, בדרך כלל תוך דקה.

האם וובהוק שיחה יכול להישלח לנקודת קצה אחרת מזו של האפליקציה?

כן. calls הוא אחד השדות ש-Meta מאפשרת לחשבון WhatsApp Business או למספר טלפון להפנות לכתובת URL חלופית של callback, לצד messages ולשדות שקשורים למסלול החיבור.

המשיכו לקרוא

שיחות WhatsApp Business במספר Coexistenceשיחות קוליות ווידאו ממשיכות לעבוד באפליקציית WhatsApp Business אחרי Coexistence, אבל Calling API של Meta אינו תומך במספרים האלה. מה זה אומר לכם.סטטוסי וובהוק (Webhook) של WhatsApp: נשלחה, נמסרה, נקראה ונכשלהאיך WhatsApp מדווחת מה קרה להודעה ששלחתם: מערך statuses, כל ערך סטטוס, כל שדה, והתאמה לשדה wamid ולפורמט האמיתי של Meta.אילו תכונות WhatsApp מפסיקות לעבוד אחרי Coexistenceהודעות נעלמות, צפייה חד-פעמית, מיקום בזמן אמת ורשימות תפוצה מושבתים במספר מחובר. מה זה אומר בפועל.מה מסתנכרן עם ה-API ומה לאאנשי קשר והיסטוריה אישית עוברות. קבוצות, קטלוג, תוויות, תשובות מהירות והודעות היעדרות לא. הרשימה המלאה במקום אחד.העברת מספר מ-Coexistence ל-Cloud API בלבדהוצאת מספר מאפליקציית WhatsApp Business והפעלתו רק ב-Cloud API: סדר הצעדים, ההיסטוריה שלפי Meta הולכת לאיבוד, ומה משתנה.ניסיונות חוזרים, כפילויות וסדר בוובהוקים (Webhook) של WhatsApp: איך לטפל בהםMeta מנסה שוב לשלוח וובהוקים של WhatsApp עד 7 ימים, לכן כפילויות הן רגילות והסדר אינו מובטח. מפתחות לסינון, מטפל בטוח ומה להחזיר.

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

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

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

נבדק ב-