Skip to main content
Når et innkommende telefonanrop når et nummer uten en tilordnet agent, eller en økt i en webwidget starter på en publiserbar nøkkel i mode="webhook", sender ThunderPhone en blokkerende telephony.incoming / web.incoming-forespørsel til din eldre webhook-URL og venter i opptil 10 sekunder på et konfigurasjonssvar. Bruk denne utvekslingen til å velge prompt, stemme og verktøy dynamisk per anrop — se veiledningen for dynamisk anropskonfigurasjon for mønsteret fra start til slutt.
Abonnerte webhook-endepunkter mottar også telephony.incoming / web.incoming — for hvert innkommende anrop og hver webøkt, enten agenten er konfigurert eller ikke — men disse leveringene er varsler som sendes og glemmes med en event_id, aldri blokkerende. Bare den eldre webhooken med én URL inneholder konfigurasjonsutvekslingen på denne siden. Formatene for endepunktvarsler finnes i hendelseskatalogen.
Den blokkerende utvekslingen har ingen reserve: Hvis behandleren din returnerer en ikke-2xx-status, får tidsavbrudd eller returnerer en konfigurasjon som ikke består validering, avvises anropet (telefonanropet kobles ikke til; forespørselen om widgetøkten mislykkes med 502/422). Svar raskt — innringeren hører ringetone mens du avgjør.

Forespørselsdata

For telefonanrop (telephony.incoming):
For økter i webwidgeten (web.incoming) identifiserer data siden widgeten er innebygd på, i stedet for telefonnumre:
Widgeter i webhook-modus leverer denne forespørselen til den publiserbare nøkkelens egen webhook_url når en er angitt, med reservetilbakefall til webhook-URL-en på organisasjonsnivå. Uansett er den signert med organisasjonens webhook-secret.

Responseskjema

Returner et JSON-objekt som beskriver agentkonfigurasjonen for dette anropet. prompt og voice er påkrevd; alt annet er valgfritt.
Ukjente nøkler på toppnivå blir stille ignorert — et felt med skrivefeil i navnet avviser ikke konfigurasjonen, det blir bare ikke brukt. Taleordre og max_hold_seconds godtas ikke her; de kan bare konfigureres på selve Agenten.
Siden prompt og voice er påkrevd, avviser {} eller et hvilket som helst svar som ikke består valideringen anropet med 422 — det finnes ingen reserve for statisk agent på denne banen (et nummer eller en nøkkel i webhook-modus har ingen tilordnet agent).

Eksempelbehandler


Svar med funksjonsverktøy

Legg ved verktøy slik at AI-en kan kalle API-ene dine midt i samtalen:
Forespørsler til verktøyendepunkter signeres med den samme webhook-hemmeligheten for organisasjonen som signerte denne utvekslingen. Se Funksjonsverktøy for nøyaktig format og formatet for signerte forespørsler.

Hurtigoversikt over produktnivåer


Relatert

telephony.complete / web.complete

Den ikke-blokkerende hendelsen ved samtaleavslutning.

Funksjonsverktøy

Fullstendig JSON-skjema for tools[] og den signerte endepunktkontrakten.

Webhook-endepunkter

Abonner flere URL-er på telephony.incoming / web.incoming.

Dynamisk samtalekonfigurasjon

Mønstre for ledetekster, verktøy og A/B-tester per innringer.