- נקודות קצה של Webhook מקבלות את
telephony.complete(שיחות טלפון) או אתweb.complete(שיחות ווב ושיחות בדיקת מיקרופון בבונה) עם המטען היציב המתועד להלן,event_idלכל מסירה, זמן קצוב של 30 שניות, וכן ניסיונות חוזרים למשך עד 24 שעות. - ה-Webhook מדור קודם בעל כתובת URL יחידה מקבל ניסיון סינכרוני אחד (זמן קצוב של 10 שניות, ללא ניסיונות חוזרים) עם מטען מעט שונה — ראו הבדלים במטען מדור קודם.
מטען הבקשה (מסירות לנקודות קצה)
סיבות סיום
פורמט התמליל
כל רשומה ב-transcripts היא תור שיחה אחד. התפקידים הם
user (דיבור המתקשר), model (דיבור הסוכן וגם קריאות לכלים),
tool (תוצאות כלים) ו-system (אירועי שיחה כגון החלפות
שפה).
להיסטוריית התורים המובנית במלואה (עם סמני הפרעה,
הנחיות אישור ומיקומים גולמיים), השתמשו ב-
GET /v1/calls/{call_id}/history.
הבדלים במטען הנתונים הישן
מעטפת ה-webhook הישנה עם כתובת URL יחידה היא{"type": "telephony.complete" | "web.complete", "data": {…}} ללא
event_id, וה-data שלה שונה ממטען הנתונים של נקודת הקצה:
- מערך התורים נמצא תחת
history, ולא תחתtranscripts(אותה סכמת תור כמו למעלה). - קבוצת השדות היא דוח גולמי של סוף השיחה, ויכולה לכלול שדות פנימיים נוספים מעבר לטבלה שלמעלה — התייחסו לשדות לא מוכרים כמידע בלבד.
- שיחות ווב (
direction: "web") משמיטות אתfrom_number/to_numberומוסיפות אתorigin_domain. - שיחות בדיקת מיקרופון ב-Builder מדווחות כ-
telephony.completeבנתיב הישן (מערכת נקודת הקצה ממפה אותן ל-web.complete). - תיאום העברה: כאשר שיחה מסתיימת בהעברה, ה-webhook הישן נקרא באופן סינכרוני ועשוי להחזיר
{"transfer_ready": false}כדי לציין שיעד ההעברה אינו מוכן. כל תגובה אחרת (או היעדר webhook ישן) מאפשרת להעברה להמשיך. מסירות לנקודת הקצה לעולם אינן נבדקות לצורך כך.
מטפל לדוגמה
תרחישי שימוש נפוצים
אינטגרציה עם CRM
שמרו את תמליל כל שיחה ואת כתובת ה-URL של ההקלטה לצד
רשומות הלקוחות שלכם.
ניתוח נתונים
הזרימו תמלילים למערך לצורך מידול נושאים, חילוץ
אותות CSAT או ניטור שיעורי העברה.
סקירת איכות
פתחו שיחות בכלי QA לסקירה אנושית, או העבירו אותן דרך
מודל ההערכה שלכם.
התראות
הפעילו התראה לנציג אנושי בעת העברה או כשל.
קשור
telephony.incoming / web.incoming
המקבילה החוסמת שפועלת בתחילת השיחה.
קטלוג אירועים
סוגי אירועים נוספים שתוכלו להירשם אליהם.
API להיסטוריית שיחות
אותם נתונים זמינים באמצעות REST למילוי נתונים חסרים או להפעלה חוזרת.