וובהוק שיחות 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 והאוטומציות שלכם עונים להודעות ושולחים תבניות, בזמן שהשיחות ממשיכות לצלצל באפליקציה בטלפון.
שיחות קוליות ווידאו ב-Cloud API עבור מספר שנרשם עם אפליקציית WhatsApp Business; באפליקציה הן לא משתנות.
המינימום היומי של הודעות, בנמענים ייחודיים, שנדרש ממספר לפני שימוש ב-Calling API.
כמה זמן אפשר להוריד הקלטות שיחות ותמלולים לאחר שנשלח הוובהוק שלהם.
הקידומת של מזהי השיחות, הערך שמקשר בין אירועי החיבור, הסטטוס והסיום של שיחה.
ההרשאה שאפליקציה צריכה כדי לקבל וובהוקים של שיחות, כמו בהודעות.
מה מדווח שדה calls בוובהוק (Webhook)?
כל מה שקורה לשיחה שנוצרה או התקבלה דרך Calling API, כשדה אחד עם אירוע לכל שלב. שיחה שהעסק יזם מייצרת אירוע חיבור, עדכוני סטטוס ואירוע סיום. שיחות שמנותבות דרך SIP מדווחות על call_created במקום connect, בלי סשן SDP. אירוע קשור אחד נמצא בשדה אחר: כשלקוח משיב לבקשת הרשאה לשיחה, התשובה מגיעה בשדה messages כהודעה אינטראקטיבית מסוג call_permission_reply.
איך נראה וובהוק של שיחה?
אותה מעטפת כמו בכל וובהוק של WhatsApp, עם מערך calls תחת value, והשדה field מוגדר לערך calls. direction מציין BUSINESS_INITIATED או USER_INITIATED. השדה from ושדה to נושאים את מספרי הטלפון, to_user_id הוא ה-BSUID של הלקוח, וכל אחד ממספרי הטלפון יכול להיעדר עבור לקוח שמשתמש בשם משתמש. metadata.phone_number_id מזהה את המספר שלכם, כמו בכל שדה אחר. זו הדוגמה של Meta ל-Call Connect, עם ערכי הדוגמה כפי ש-Meta מדפיסה אותם:
{
"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 ימים מרגע הוובהוק, ואחר כך הם נעלמים.
כל מספר מנוטר 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 Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-