mode="webhook", ThunderPhone trimite o solicitare blocantă
telephony.incoming / web.incoming către
URL-ul webhook moștenit
și așteaptă până la 10 secunde un răspuns de configurare. Utilizați acest
schimb pentru a alege dinamic un prompt, o voce și instrumente pentru fiecare apel —
consultați ghidul de configurare dinamică a apelurilor
pentru fluxul complet.
Endpointurile webhook abonate primesc și ele
telephony.incoming / web.incoming — pentru fiecare apel de intrare
și sesiune web, indiferent dacă este configurat un agent sau nu — însă aceste
livrări sunt notificări fire-and-forget cu un event_id, niciodată blocante.
Numai webhookul moștenit cu un singur URL gestionează schimbul de configurare
din această pagină. Formatele notificărilor de endpoint sunt disponibile în
catalogul de evenimente.502/422). Răspundeți rapid — apelantul aude tonul de apel
în timp ce decideți.
Conținutul solicitării
Pentru apelurile telefonice (telephony.incoming):
Pentru sesiunile de widget web (
web.incoming), data identifică
pagina încorporată în locul numerelor de telefon:
Widgeturile în modul webhook livrează această solicitare la propriul
webhook_url al cheii publicabile atunci când este setat, folosind ca rezervă
URL-ul webhook la nivel de organizație. În ambele cazuri, solicitarea este
semnată cu secret webhookului organizației.Schemă de răspuns
Returnați un obiect JSON care descrie configurația agentului pentru acest apel.prompt și voice sunt obligatorii; toate celelalte sunt opționale.
Cheile de nivel superior necunoscute sunt ignorate în mod silențios — un nume de câmp scris greșit
nu respinge configurația, pur și simplu nu se aplică. Ordinea de vorbire
și
max_hold_seconds nu sunt acceptate aici; pot fi
configurate numai pentru Agent.prompt și voice sunt obligatorii, returnarea {} sau a oricărui
răspuns care nu trece validarea respinge apelul cu 422 — nu există
nicio rezervă pentru agent static pe această rută (un număr sau o cheie în modul webhook
nu are niciun agent atribuit).
Exemplu de handler
Răspuns cu instrumente de funcții
Atașați instrumente pentru ca AI-ul să vă poată apela API-urile în timpul conversației:Fișă rapidă pentru nivelurile de produs
Asociate
telephony.complete / web.complete
Evenimentul neblocant de încheiere a apelului.
Instrumente de funcții
Schema JSON completă pentru
tools[] și contractul endpointului semnat.Endpointuri webhook
Abonați mai multe URL-uri la
telephony.incoming / web.incoming.Configurarea dinamică a apelurilor
Modele pentru prompturi, instrumente și teste A/B per apelant.