Skip to main content
Når et indgående telefonopkald når et nummer uden en tilknyttet agent, eller en webwidgetsession starter på en publicerbar nøgle i mode="webhook", sender ThunderPhone en blokerende telephony.incoming / web.incoming-anmodning til din ældre webhook-URL og venter op til 10 sekunder på et konfigurationssvar. Brug denne udveksling til dynamisk at vælge en prompt, stemme og værktøjer pr. opkald — se guiden til dynamisk opkaldskonfiguration for det fulde mønster.
Abonnerede webhook-endpoints modtager også telephony.incoming / web.incoming — for alle indgående opkald og websessioner, med eller uden agentkonfiguration — men disse leveringer er fire-and-forget-notifikationer med et event_id, aldrig blokerende. Kun den ældre webhook med én URL indeholder konfigurationsudvekslingen på denne side. Formatet for endpointnotifikationer findes i hændelseskataloget.
Den blokerende udveksling har ingen fallback: Hvis din handler returnerer en ikke-2xx-status, får timeout eller returnerer en konfiguration, der ikke består valideringen, afvises opkaldet (telefonopkaldet forbindes ikke; anmodningen om widgetsessionen fejler med 502/422). Svar hurtigt — den, der ringer, hører ringetonen, mens du vælger.

Anmodningspayload

For telefonopkald (telephony.incoming):
For webwidgetsessioner (web.incoming) identificerer data den indlejrede side i stedet for telefonnumre:
Widgets i webhooktilstand leverer denne anmodning til den publicerbare nøgles egen webhook_url, når en er angivet, og falder tilbage til webhook-URL’en på organisationsniveau. Uanset hvad signeres den med organisationens webhook-secret.

Svarskema

Returner et JSON-objekt, der beskriver agentkonfigurationen for dette opkald. prompt og voice er påkrævede; alt andet er valgfrit.
Ukendte nøgler på øverste niveau bliver stiltiende ignoreret — et felt- navn med en tastefejl afviser ikke konfigurationen, det anvendes bare ikke. Talerækkefølge og max_hold_seconds accepteres ikke her; de kan kun konfigureres på selve agenten.
Da prompt og voice er påkrævede, afviser returnering af {} eller ethvert svar, der fejler valideringen, opkaldet med 422 — der er ingen reserveagent på denne sti (et nummer eller en nøgle i webhooktilstand har ingen tildelt agent).

Eksempel på handler


Svar med funktionsværktøjer

Tilknyt værktøjer, så AI’en kan kalde dine API’er midt i samtalen:
Anmodninger til værktøjsendepunkter signeres med den samme organisations-webhookhemmelighed, som signerede denne udveksling. Se Funktionsværktøjer for den nøjagtige struktur og det signerede anmodningsformat.

Hurtig oversigt over produktniveauer


Relateret

telephony.complete / web.complete

Den ikke-blokerende hændelse ved opkaldets afslutning.

Funktionsværktøjer

Fuldt JSON-skema for tools[] og den signerede endpoint-kontrakt.

Webhook-endpoints

Abonner på flere URL’er for telephony.incoming / web.incoming.

Dynamisk opkaldskonfiguration

Mønstre for prompter, værktøjer og A/B-tests pr. opkalder.