Webhooks

Webhooks allow your system to receive real-time updates about call lifecycles.

Call Status Events

We send POST requests to your configured webhook URL for the following events:

Status	Description
`initiated`	Outbound call has started dialing.
`ringing`	The recipient’s phone is ringing.
`in-progress`	The call was answered and the bot is active.
`completed`	The call ended successfully.
`failed`	The call failed (e.g., invalid number).
`busy`	The line was busy.
`no-answer`	The recipient did not pick up.

Webhook Payload

{
  "call_sid": "call_123456",
  "status": "completed",
  "duration": 45,
  "timestamp": "2024-01-01T12:00:45Z",
  "error_code": null,
  "error_message": null
}

Configuring Webhooks

Currently, webhook URLs are configured at the Phone Number level (via Twilio configuration) or system-wide settings.

In the current version, we proxy Twilio’s status callbacks. When bringing your own Twilio number, our system sets the StatusCallback URL to our platform, and we process the events.

Glossary Security & Compliance

Getting Started

Core Concepts

Telephony

Cookbook

Best Practices

Resources

Advanced

Call Status Events

Webhook Payload

Configuring Webhooks

​Call Status Events

​Webhook Payload

​Configuring Webhooks

Call Status Events

Webhook Payload

Configuring Webhooks