elevenlabs-webhooks-events

# ElevenLabs Webhooks & Events ## Overview ElevenLabs webhooks send HTTP POST notifications when async operations complete. Supported event types include transcription completion, post-call data from Conversational AI agents, and call initiation failures. Webhooks use HMAC-SHA256 signatures for verification. ## Prerequisites - ElevenLabs account (webhooks configured in Settings > Webhooks) - HTTPS endpoint accessible from the internet - Webhook secret (generated during webhook creation in dashboard) ## Instructions ### Step 1: Webhook Event Types | Event Type | Payload | When Triggered | |------------|---------|----------------| | `post_call_transcription` | Full conversation transcript, analysis, metadata | After Conversational AI call ends | | `post_call_audio` | Base64-encoded call audio, minimal metadata | After call ends (if audio recording enabled) | | `call_initiation_failure` | Failure reason, metadata | When an outbound call fails to connect | | `speech_to_text.completed` | Transcription result, word timestamps | Async STT job completes | ### Step 2: Webhook Setup ```bash # Create webhook in ElevenLabs dashboard: # Settings > Webhooks > Create Webhook # - URL: https://your-app.com/webhooks/elevenlabs # - Select event types to subscribe to # - Copy the generated HMAC secret ``` ### Step 3: HMAC Signature Verification ```typescript // src/elevenlabs/webhook-verify.ts import crypto from "crypto"; /** * Verify the ElevenLabs-Signature header using HMAC-SHA25...