Webhooks efter samtal
Få aviseringar via webhooks när samtal avslutas och analysen är klar.
Översikt
Webhooks efter samtal gör att du kan få detaljerad information om ett samtal när analysen är klar. När funktionen är aktiverad skickar ElevenLabs en POST-begäran till din angivna slutpunkt med omfattande samtalsdata.
ElevenLabs har stöd för tre typer av webhooks efter samtal:
- Webhooks för transkribering (
post_call_transcription): Innehåller fullständig konversationsdata, inklusive transkriberingar, analysresultat och metadata - Ljudwebhooks (
post_call_audio): Innehåller minimal data med base64-kodat ljud från hela konversationen - Webhooks för misslyckad samtalsinitiering (
call_initiation_failure): Innehåller information om misslyckade försök att initiera samtal, inklusive felorsaker och metadata
Aktivera webhooks efter samtal
Webhooks efter samtal kan aktiveras för alla agenter i din arbetsyta via ElevenAgents inställningssida.

Webhooks efter samtal måste returnera statuskoden 200 för att räknas som lyckade. Webhooks som misslyckas upprepade gånger inaktiveras automatiskt om det finns 10 eller fler misslyckanden i följd och den senaste lyckade leveransen var för mer än 7 dagar sedan eller aldrig har levererats lyckat.
Webhooks efter samtal kan automatiskt försökas igen om de misslyckas. Se webhook- återförsök.
Autentisering
Det är viktigt att mottagaren validerar alla inkommande webhooks. Webhooks har för närvarande stöd för autentisering via HMAC-signaturer. Konfigurera HMAC-autentisering genom att:
- Lagra den delade hemligheten som genereras när webhooken skapas på ett säkert sätt
- Verifiera headern ElevenLabs-Signature i din endpoint med hjälp av SDK:n
JavaScript-SDK:n exponerar constructEvent; Python-SDK:n exponerar construct_event med rawBody, sig_header och secret (dessa heter inte payload / signature i Python). Båda verifierar signaturen, validerar tidsstämpeln och tolkar JSON-payloaden.
Python
JavaScript
Exempel på webhook-hanterare med FastAPI:
Anpassade begäranderubriker
Utöver validering av HMAC-signaturer kan du inkludera anpassade rubriker i varje webhookleverans. Det är användbart för att skicka API-nycklar, bearer-token eller andra autentiseringsrubriker som din mottagande slutpunkt kräver.
Dashboard
CLI
SDK
Anpassade rubriker kan för närvarande inte konfigureras via ElevenAgents dashboard. Använd SDK eller API för att ange anpassade rubriker.
Anpassade rubriker fungerar tillsammans med HMAC-autentisering. auth_type måste fortfarande vara inställd på hmac,
och anpassade rubriker skickas utöver rubriken ElevenLabs-Signature.
Anpassade rubriker är endast skrivbara. Slutpunkten för att lista webhooks
returnerar inte request_headers i sitt svar, så du kan inte läsa tillbaka vilka rubriker som är
konfigurerade för en webhook.
IP-tillåtelselista
För ökad säkerhet kan du lägga till ElevenLabs statiska utgående IP-adresser i din tillåtelselista. Se IP-tillåtelselista för den fullständiga listan över IP-adresser.
Att använda IP-tillåtelselista tillsammans med validering av HMAC-signaturer ger flera lager av säkerhet.
Webhook-åsidosättningar per agent
Som standard använder alla agenter i din arbetsyta webhooken som har konfigurerats i arbetsytans inställningar. Du kan åsidosätta detta per agent för att skicka data efter samtal till olika slutpunkter för olika agenter.
Dashboard
CLI
SDK
post_call_webhook_id måste referera till en webhook som redan finns i din arbetsyta. Du kan också ange vilka händelsetyper som ska skickas med hjälp av arrayen events:
Struktur för webhook-svar
ElevenLabs skickar tre olika typer av webhooks efter samtal, var och en med olika datastrukturer:
Webhooks för transkribering (post_call_transcription)
Innehåller omfattande konversationsdata, inklusive fullständiga transkriberingar, analysresultat och metadata.
Fält på toppnivå
Datastruktur för objektet
Objektet data innehåller:
conversation_initiation_client_data.dynamic_variables mappar variabelnamn till valfritt JSON-värde, inklusive listor och objekt. Det innehåller de inbyggda system__-variablerna, och nya kan läggas till, så avvisa inte nycklar eller värdetyper som du inte känner igen. Se dynamiska variabler.
Ljudwebhooks (post_call_audio)
Innehåller minimal data med hela konversationens ljud som base64-kodad MP3.
Fält på toppnivå
Datastruktur för objektet
Objektet data innehåller endast:
Ljudwebhooks innehåller endast fälten som listas ovan. De innehåller INTE transkriberingsdata, metadata, analysresultat eller andra konversationsdetaljer.
Webhooks för misslyckad samtalsinitiering (call_initiation_failure)
Innehåller information om försök att initiera telefonsamtal, inklusive felorsaker och metadata från telefonioperatören.
Webhook-händelser för misslyckad samtalsinitiering skickas när ett samtal inte kan initieras på grund av anslutnings- fel, att användaren avböjer samtalet eller att användaren inte svarar. Om ett samtal går till röstbrevlådan eller besvaras av en automatiserad tjänst skickas ingen webhook för misslyckad samtalsinitiering, eftersom samtalet initierades framgångsrikt.
Fält på toppnivå
Datastruktur för objektet
Objektet data innehåller:
För utgående samtal som görs via Twilio härleds failure_reason från Twilios CallStatus: busy och no-answer skickas vidare som de är, och failed rapporteras som unknown. Andra Twilio-samtalsstatusar skickar ingen webhook för misslyckad samtalsinitiering.
Struktur för metadataobjekt
Strukturen för objektet metadata varierar beroende på om det utgående samtalet gjordes via Twilio eller via SIP-trunking. Objektet innehåller fältet type, som skiljer mellan de två, och fältet body, som innehåller operatörsspecifika uppgifter.
SIP-metadata (type: "sip"):
Objektet body för SIP-metadata innehåller:
Twilio-metadata (type: "twilio"):
Exempel på webhook-payloads
Exempel på transkriptionswebhook
Exempel på ljudwebhook
Exempel på webhookar vid misslyckad samtalsinitiering
Exempel på Twilio-metadata
Exempel på SIP-metadata
Leverans av ljudwebhookar
Ljudwebhookar levereras separat från transkriptionswebhookar och innehåller endast de viktigaste fälten som behövs för att identifiera konversationen, tillsammans med base64-kodad ljuddata.
Ljudwebhookar kan aktiveras eller inaktiveras med reglaget “Send audio data” i dina webhook- inställningar. Inställningen kan konfigureras både på arbetsytenivå (i ElevenAgents-inställningarna) och på agentnivå (i enskilda åsidosättningar av agentens webhook-inställningar).
Strömmande leverans
Ljudwebhookar levereras som strömmande HTTP-begäranden med headern transfer-encoding: chunked för att effektivt hantera stora ljudfiler. Varje begäran får timeout efter 5 minuter.
Nya försök
När nya försök är aktiverade för webhooken görs nya försök med misslyckade ljudleveranser enligt samma schema som för transkriptionswebhookar. Ett nytt försök skickar hela ljud-payloaden igen, så avduplicera efter conversation_id. Se nya försök för webhookar för schema, fel som kan försökas igen och gränser för ljudstorlek.
Bearbeta ljudwebhookar
Eftersom ljudwebhookar levereras via chunked transfer encoding behöver du hantera strömmande data korrekt:
Ljudwebhookar kan vara stora filer, så se till att din webhook-slutpunkt kan hantera strömmande begäranden och har tillräckligt med minnes- och lagringskapacitet. Ljudet levereras i MP3-format.
Användningsområden
Automatiska uppföljningar efter samtal
Webhookar efter samtal gör det möjligt att skapa automatiserade arbetsflöden som utlöses direkt efter att ett samtal avslutas. Här är några praktiska användningsområden:
CRM-integrering
Uppdatera ditt system för kundrelationshantering med konversationsdata så snart ett samtal har avslutats:
Tillståndsfulla konversationer
Behåll konversationskontext över flera interaktioner genom att lagra och hämta tillstånd:
- När ett samtal startar skickar du med ditt användar-id som en dynamisk variabel.
- När ett samtal avslutas konfigurerar du din webhook-slutpunkt så att den lagrar konversationsdata i din databas, baserat på användar-id:t som extraherats från dynamic_variables.
- När användaren ringer igen kan du hämta den här kontexten och skicka den till den nya konversationen i en dynamisk variabel
{{previous_topics}}. - Detta skapar en smidig upplevelse där agenten “minns” tidigare interaktioner