Overview

Webhooks allow your application to receive real-time notifications about events that occur in your Retell AI account. Instead of continuously polling our API, webhooks push data to your application as events happen, making your integrations more efficient and responsive.

​

Event Types

Retell AI supports the following webhook events:

​

Common Use Cases

1. Real-time Analytics

   • Track call statistics and performance metrics
   • Monitor call volumes and patterns
   • Trigger alerts for specific call outcomes

2. System Integration

   • Update CRM records when calls complete
   • Trigger workflow automations based on call analysis
   • Archive call transcripts in your data warehouse

3. Call Monitoring

   • Get notified of failed or transferred calls
   • Track call duration and completion status
   • Monitor agent performance in real-time

​

Example Webhook Payload

{
  "event": "call_ended",
  "call": {
    "call_type": "phone_call",
    "from_number": "+12137771234",
    "to_number": "+12137771235",
    "direction": "inbound",
    "call_id": "Jabr9TXYYJHfvl6Syypi88rdAHYHmcq6",
    "agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
    "call_status": "registered",
    "metadata": {},
    "retell_llm_dynamic_variables": {
      "customer_name": "John Doe"
    },
    "start_timestamp": 1714608475945,
    "end_timestamp": 1714608491736,
    "disconnection_reason": "user_hangup",
    "transcript": "...",
    "transcript_object": [ [Object], [Object], [Object], [Object] ],
    "transcript_with_tool_calls": [ [Object], [Object], [Object], [Object] ],
    "opt_out_sensitive_data_storage": false
  }
}

##🎦 Video Tutorial