Event Types
Retell AI supports the following webhook events:If the call did not connect (like dial failed), the
call_started
webhook event will not be triggered.Event Type | Description | Payload |
---|---|---|
call_started | Triggered when a new call begins | Basic call information |
call_ended | Triggered when a call completes, transfers, or encounters an error | all fields from the call object except call_analysis . |
call_analyzed | Triggered when call analysis is complete | Full call data including call_analysis object |
Common Use Cases
-
Real-time Analytics
- Track call statistics and performance metrics
- Monitor call volumes and patterns
- Trigger alerts for specific call outcomes
-
System Integration
- Update CRM records when calls complete
- Trigger workflow automations based on call analysis
- Archive call transcripts in your data warehouse
-
Call Monitoring
- Get notified of failed or transferred calls
- Track call duration and completion status
- Monitor agent performance in real-time
Webhook Spec
The webhook willPOST
the payload to your endpoint. The webhook has a timeout of 10 seconds. If within 10 seconds no success status (2xx) is received, the webhook will be retried, up to 3 times.
The webhook will be triggered in order, but is not blocking. For example, if the webhook for call_started
is not successful, we can still trigger call_ended
webhook.
When the call did not connect (like calls with dial_failed
, dial_no_answer
, dial_busy
disconnection reason), it will not have its call_started
webhook triggered. It will still have its call_ended
and call_analyzed
webhook triggered.