Skip to main content
Când un apel telefonic de intrare ajunge la un număr fără un agent alocat sau când începe o sesiune de widget web pe o cheie publicabilă în 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.
Schimbul blocant nu are rezervă: dacă handlerul dumneavoastră returnează un status non-2xx, expiră sau returnează o configurație care nu trece validarea, apelul este respins (apelul telefonic nu se conectează; solicitarea sesiunii widgetului eșuează cu 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.
Deoarece 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:
Solicitările către endpointurile instrumentelor sunt semnate cu același secret webhook al organizației care a semnat acest schimb. Consultați Instrumente de funcții pentru structura exactă și formatul solicitării semnate.

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.