Skip to main content
När ett inkommande telefonsamtal når ett nummer utan en tilldelad agent, eller en webbwidgetsession startar med en publicerbar nyckel i 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.
Det blockerande utbytet har ingen reservlösning: om din hanterare returnerar en icke-2xx-status, får timeout eller returnerar en konfiguration som inte klarar valideringen, avvisas samtalet (telefonsamtalet kopplas inte upp; begäran om widgetsessionen misslyckas med 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.
Eftersom 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:
Begäranden till verktygsändpunkter signeras med samma webhook-hemlighet för organisationen som signerade detta utbyte. Se Funktionsverktyg för exakt format och det signerade begärandeformatet.

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.