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.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.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: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.