assemblyai-webhooks-events

# AssemblyAI Webhooks & Events ## Overview Handle AssemblyAI webhooks for transcription completion. When you submit a transcript with `webhook_url`, AssemblyAI sends a POST request to your URL when the transcript is completed or fails. One webhook per transcript — no complex event routing needed. ## Prerequisites - HTTPS endpoint accessible from the internet - `assemblyai` package installed - API key configured ## How AssemblyAI Webhooks Work 1. You submit a transcription with `webhook_url` parameter 2. AssemblyAI processes the audio asynchronously 3. When done (completed or error), AssemblyAI sends a POST to your URL 4. Your endpoint receives transcript ID and status, then fetches the full transcript **Key difference from other APIs:** AssemblyAI webhooks are per-transcript (set at submission time), not a global webhook registration. There are no event types to subscribe to — you get one callback per transcript. ## Instructions ### Step 1: Submit Transcription with Webhook ```typescript import { AssemblyAI } from 'assemblyai'; const client = new AssemblyAI({ apiKey: process.env.ASSEMBLYAI_API_KEY!, }); // submit() queues the job and returns immediately (doesn't poll) const transcript = await client.transcripts.submit({ audio: 'https://example.com/meeting-recording.mp3', webhook_url: 'https://your-app.com/webhooks/assemblyai', // Optional: auth header for webhook verification webhook_auth_header_name: 'X-Webhook-Secret', webhook_auth_header_value: proce...