Documentation Index
Fetch the complete documentation index at: https://docs.topcalls.ai/llms.txt
Use this file to discover all available pages before exploring further.
What Are Webhooks?
Webhooks are HTTP callbacks that TopCalls sends to your server when events occur. They’re the best way to integrate TopCalls with your existing systems.Real-Time Updates
Get notified instantly when calls complete, fail, or campaigns update. No polling required.
Complete Data
Receive full call details, transcripts, recordings, and analysis in a single webhook payload.
Reliable Delivery
Built-in retry logic ensures webhooks are delivered even if your server is temporarily unavailable.
Secure
Optional signature verification ensures webhooks are authentic and haven’t been tampered with.
Available Events
Call Events
| Event | When It Fires | Payload Includes |
|---|---|---|
call.queued | Call created and queued | Basic call info |
call.started | Call connected to recipient | Connection details |
call.completed | Call finished successfully | Full transcript, recording, summary |
call.failed | Call failed (busy, no answer, error) | Error details |
call.transferred | Call was transferred | Transfer destination |
Campaign Events
| Event | When It Fires | Payload Includes |
|---|---|---|
campaign.started | Campaign began running | Campaign config, contact count |
campaign.paused | Campaign was paused | Reason, pending contacts |
campaign.resumed | Campaign resumed | Current stats |
campaign.completed | All contacts processed | Final statistics |
campaign.stopped | Campaign was cancelled | Final statistics |
Webhook Timing
Successful Calls
Webhooks are sent ~15 seconds after call ends to ensure:- Recording URL is available
- Transcript is complete
- Call summary is generated (if configured)
Failed Calls
Webhooks are sent immediately when the call fails (no recording to wait for).Webhook Retries
TopCalls automatically retries failed webhook deliveries:- Initial attempt: Immediate
- Retry 1: After 1 minute
- Retry 2: After 5 minutes
- Retry 3: After 15 minutes
- Retry 4: After 1 hour
Next Steps
Webhooks Guide
Learn how to set up and handle webhooks in your application.
API Reference
See the complete API documentation.