mode="webhook", ThunderPhone שולחת בקשת
telephony.incoming / web.incoming חוסמת אל
כתובת ה-webhook הישנה שלכם
וממתינה עד 10 שניות לתגובת תצורה. השתמשו
בהחלפה זו כדי לבחור באופן דינמי הנחיה, קול וכלים לכל שיחה —
עיינו במדריך לתצורת שיחה דינמית
לתבנית המלאה מקצה לקצה.
נקודות קצה של webhook שנרשמתם אליהן מקבלות גם
telephony.incoming / web.incoming — עבור כל שיחה נכנסת
וסשן אינטרנט, בין אם הוגדר להם סוכן ובין אם לא — אך מסירות אלה הן
התראות שליחה-ושכחה עם event_id, ולעולם אינן חוסמות.
רק ה-webhook הישן בעל כתובת ה-URL היחידה נושא את החלפת
התצורה בדף זה. מבני התראות נקודות הקצה מופיעים ב
קטלוג האירועים.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 שלכם במהלך השיחה:דף עזר לרמות מוצר
קשור
telephony.complete / web.complete
אירוע סיום השיחה שאינו חוסם.
כלי פונקציה
סכמת JSON מלאה עבור
tools[] וחוזה נקודת הקצה החתום.נקודות קצה של Webhook
הירשמו מספר כתובות URL ל-
telephony.incoming / web.incoming.תצורת שיחה דינמית
תבניות להנחיות, כלים ובדיקות A/B לכל מתקשר.