Skip to main content
אירוע השלמה מופעל לאחר סיום כל שיחה — טלפוניה נכנסת, טלפוניה יוצאת, שיחת ווב או שיחת בדיקה (סשן מיקרופון בבונה). הוא אינו חוסם: השיבו עם כל קוד 2xx. האירוע נמסר בשני הנתיבים:

מטען הבקשה (מסירות לנקודות קצה)

סיבות סיום

פורמט התמליל

כל רשומה ב-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 למילוי נתונים חסרים או להפעלה חוזרת.