Agent skill · software engineering · jeremylongshore
deepgram-webhooks-events
Implement Deepgram callback and webhook handling for async transcription.
Why this skill is useful
Provides specific implementation details and callback handling for Deepgram's async transcription that the AI wouldn't reliably generate on its own.
What it needs
Requires @deepgram/sdk, crypto, express installed locally. Requires deepgram account access. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Deepgram Webhooks & Callbacks Prerequisites A verified callback endpoint, signature/authentication requirements, idempotency store, and redacted observability. A data-retention/consent decision and an owner for failed callback recovery. Examples Validate the callback signature before parsing its body, deduplicate by an opaque event ID, acknowledge promptly, and write only state/result metadata to logs. Test with a development event; retry transient failures with bounded backoff and quarantine terminal failures rather than replaying audio/transcripts blindly. Overview Implement async transcription with Deepgram's callback feature. When you pass a callback URL, Deepgram returns a requestid immediately, processes audio in the background, and POSTs results to your endpoint. Supports HTTP and WebSocket callbacks with automatic retry (10 attempts, 30s intervals). Deepgram Callback Flow Instructions Step 1: Submit Async Transcription Step 2: Callback Server Step 3: Job Tracking with Redis Step 4: Client SDK with Submit/Poll/Wait Step 5: Local Testing with ngrok Step 6: Idempotent Processing Output Async transcription submission with callback URL Callback server with signature verification Redis-backed job tracking with pub/sub notifications Client SDK with submit/poll/wait pattern Idempotent callback processing Local testing setup with ngrok Error Handling Issue Cause Solution ------- ------- ---------- Callback not received Endpoint unreachable Check HTTPS, firewall, use ngrok for local Duplicate callbacks Deepgram retry after slow response Implement idempotency with requestid Invalid signature Wrong webhook secret Verify DEEPGRAMWEBHOOKSECRET matches Console Processing timeout Slow downstream Return 200 immediately, process async Large payload Long audio transcript Increase express.raw limit Resources Callback Feature Callback Not Received STT Callback API
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/deepgram-webhooks-events