Skip to main content
כאשר שיחת טלפון נכנסת מגיעה למספר ללא סוכן מוקצה, או שסשן של וידג’ט אינטרנט מתחיל במפתח publishable במצב mode="webhook", ThunderPhone שולחת בקשת telephony.incoming / web.incoming חוסמת אל כתובת ה-webhook הישנה שלכם וממתינה עד 10 שניות לתגובת תצורה. השתמשו בהחלפה זו כדי לבחור באופן דינמי הנחיה, קול וכלים לכל שיחה — עיינו במדריך לתצורת שיחה דינמית לתבנית המלאה מקצה לקצה.
נקודות קצה של webhook שנרשמתם אליהן מקבלות גם telephony.incoming / web.incoming — עבור כל שיחה נכנסת וסשן אינטרנט, בין אם הוגדר להם סוכן ובין אם לא — אך מסירות אלה הן התראות שליחה-ושכחה עם event_id, ולעולם אינן חוסמות. רק ה-webhook הישן בעל כתובת ה-URL היחידה נושא את החלפת התצורה בדף זה. מבני התראות נקודות הקצה מופיעים ב קטלוג האירועים.
להחלפה החוסמת אין חלופה: אם המטפל שלכם מחזיר סטטוס שאינו 2xx, חורג מזמן ההמתנה או מחזיר תצורה שנכשלת באימות, השיחה נדחית (שיחת הטלפון אינה מתחברת; בקשת סשן הווידג’ט נכשלת עם 502/422). השיבו במהירות — המתקשר שומע צליל חיוג בזמן שאתם מחליטים.

מטען הבקשה

עבור שיחות טלפון (telephony.incoming):
עבור סשנים של וידג’ט אינטרנט (web.incoming), data מזהה את הדף המטמיע במקום מספרי טלפון:
וידג’טים במצב webhook מוסרים בקשה זו אל webhook_url משלהם של המפתח ה-publishable כאשר הוא מוגדר, וחוזרים אל כתובת ה-webhook ברמת הארגון אם לא. בכל מקרה, היא נחתמת באמצעות secret של ה-webhook בארגון.

סכמת תגובה

החזירו אובייקט JSON המתאר את תצורת הסוכן עבור שיחה זו. prompt ו-voice הם שדות חובה; כל השאר אופציונליים.
מפתחות עליונים לא מוכרים מתעלמים מהם בשקט — שם שדה עם שגיאת הקלדה לא דוחה את התצורה, הוא פשוט לא מוחל. סדר הדיבור ו-max_hold_seconds אינם מתקבלים כאן; ניתן להגדיר אותם רק ב-סוכן עצמו.
מכיוון ש-prompt ו-voice הם שדות חובה, החזרת {} או כל תגובה שנכשלת באימות דוחה את השיחה עם 422 — אין נתיב חלופי של סוכן סטטי במסלול זה (למספר או למפתח במצב webhook אין סוכן מוקצה).

מטפל לדוגמה


תגובה עם כלי פונקציות

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

דף עזר לרמות מוצר


קשור

telephony.complete / web.complete

אירוע סיום השיחה שאינו חוסם.

כלי פונקציה

סכמת JSON מלאה עבור tools[] וחוזה נקודת הקצה החתום.

נקודות קצה של Webhook

הירשמו מספר כתובות URL ל-telephony.incoming / web.incoming.

תצורת שיחה דינמית

תבניות להנחיות, כלים ובדיקות A/B לכל מתקשר.