mode="webhook", skickar ThunderPhone en blockerande
telephony.incoming / web.incoming-begäran till din
äldre webhook-URL
och väntar upp till 10 sekunder på ett konfigurationssvar. Använd detta
utbyte för att dynamiskt välja prompt, röst och verktyg per samtal —
se guiden för dynamisk samtalskonfiguration
för det kompletta mönstret.
Prenumererade webhook-slutpunkter tar också emot
telephony.incoming / web.incoming — för varje inkommande samtal
och webbsession, oavsett om en agent är konfigurerad eller inte — men dessa
leveranser är fire-and-forget-notiser med ett event_id och är aldrig
blockerande. Endast den äldre webhooken med en enda URL innehåller
konfigurationsutbytet på den här sidan. Format för slutpunktsnotiser finns i
händelsekatalogen.502/422). Svara snabbt — uppringaren hör
uppringningssignal medan du bestämmer.
Begärans nyttolast
För telefonsamtal (telephony.incoming):
För webbwidgetsessioner (
web.incoming) identifierar data den
inbäddande sidan i stället för telefonnummer:
Widgetar i webhook-läge levererar denna begäran till den publicerbara nyckelns
egen
webhook_url när en sådan är angiven och använder annars webhook-URL:en
på organisationsnivå. Oavsett vilket signeras den med organisationens webhook-secret.Svarsschema
Returnera ett JSON-objekt som beskriver agentkonfigurationen för det här samtalet.prompt och voice krävs; allt annat är valfritt.
Okända nycklar på toppnivå ignoreras tyst — ett felnamngivet fält
avvisar inte konfigurationen, utan tillämpas bara inte. Talordning
och
max_hold_seconds accepteras inte här; de kan endast
konfigureras på själva Agenten.prompt och voice krävs avvisar {} eller ett svar som
inte klarar valideringen samtalet med 422 — det finns ingen
reservlösning med en statisk agent på den här vägen (ett nummer eller
en nyckel i webhook-läge har ingen tilldelad agent).
Exempelhanterare
Svar med funktionsverktyg
Koppla verktyg så att AI:n kan anropa dina API:er mitt i konversationen:Snabbguide till produktnivåer
Relaterat
telephony.complete / web.complete
Den icke-blockerande händelsen när samtalet avslutas.
Funktionsverktyg
Fullständigt JSON-schema för
tools[] och det signerade endpoint-kontraktet.Webhook-slutpunkter
Prenumerera på
telephony.incoming / web.incoming för flera URL:er.Dynamisk samtalskonfiguration
Mönster för uppmaningar, verktyg och A/B-tester per uppringare.