Skip to main content
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:
StatusDescription
initiatedOutbound call has started dialing.
ringingThe recipient’s phone is ringing.
in-progressThe call was answered and the bot is active.
completedThe call ended successfully.
failedThe call failed (e.g., invalid number).
busyThe line was busy.
no-answerThe 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.