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