Edward
02/02/2026, 4:11 AMAI Evy
02/02/2026, 4:11 AMAI Evy
02/02/2026, 4:11 AMwebhook_url field. [(1) ]()
- The webhook has a timeout of 10 seconds. If no success status (2xx) is received within 10 seconds, the webhook will be retried up to 3 times. [(2) ]()
2. Confirm your endpoint returns a 2xx status:
- Retell expects a successful status code (2xx) to be returned from your webhook endpoint.
3. Check webhook event types:
- Supported events include call_started, call_ended, and call_analyzed.
- Note: If a call did not connect (e.g., dial_failed, dial_no_answer, dial_busy) , the call_started webhook will not be triggered, but call_ended and call_analyzed will still fire.
4. Verify your endpoint is publicly accessible:
- Make sure your webhook URL is reachable from the internet.
5. Check for any recent outages:
- There have been community reports of temporary webhook issues in the past. [(3) ]()
If you've verified all the above and still aren't receiving webhooks, could you share:
- How you configured the webhook (agent-level or account-level) ?
- Whether you're receiving any events at all, or none?AI Evy
02/02/2026, 4:12 AMAI Evy
02/02/2026, 4:12 AMEdward
02/02/2026, 4:12 AMEdward
02/02/2026, 4:12 AMAI Evy
02/02/2026, 4:12 AMAI Evy
02/02/2026, 4:13 AMAI Evy
02/02/2026, 4:13 AMcall_started – Triggered when a new call begins
- call_ended – Triggered when a call completes, transfers, or encounters an error
- call_analyzed – Triggered when call analysis is complete
The Chat Agent documentation confirms that chat agents do have a webhook_url field for listening to "chat events," but the sources I have don't explicitly list the specific event type names for chat webhooks. [(2) ]()
Check out these potentially useful sources for more details:
- [Webhook Overview]()
- [Get Chat Agent]()
Would you like me to provide a general answer based on what's typical for chat webhook events, or would you prefer to check the official documentation directly?AI Evy
02/02/2026, 4:13 AMAI Evy
02/02/2026, 4:17 AMEdward
02/02/2026, 4:17 AMAI Evy
02/02/2026, 4:17 AMchat_started webhook may not be sent for chat agents the same way call_started is sent for voice calls. [(1) ]()
A Retell support team member indicated they were checking with the team about whether the chat_started webhook is actually sent for chat agents, noting that unlike voice calls (which have a phone number to customize the call) , chat doesn't have the same triggering mechanism.
From the same discussion, it was confirmed that chat_ended and chat_analyzed events are sent after a chat ends (either automatically or when manually ended via the API) .
What you can do:
- If you need to capture chat session initiation, you may need to handle that logic on your application side when the chat is created
- The chat_ended and chat_analyzed events should fire once the chat concludes
I don't have explicit documentation confirming whether chat_started is a supported event type for chat agents. For definitive clarification, I'd recommend reaching out via:
- [Contact Sales]()
- [GitHub]()
Would you like a general answer on how you might work around this limitation?AI Evy
02/02/2026, 4:17 AMAI Evy
02/02/2026, 4:17 AM