Learn how webhooks work with Ultravox and get started with real-time notifications.
Webhooks provide a powerful way to receive real-time notifications about events in your Ultravox Realtime account. Instead of repeatedly polling our API to check for updates, webhooks push event data directly to your application as soon as something happens.When you configure a webhook in Ultravox, we’ll send an HTTP POST request to your specified URL whenever a subscribed event occurs. This allows your application to react immediately to important events like call starts, call ends, etc. Your server needs to respond with a 2xx to confirm receipt. If delivery fails, we will retry delivery.
Respond Quickly: Return a 2xx status code (we recommend 204) as soon as you receive the webhook. Process the data asynchronously if needed.Handle Duplicates: In rare cases, you might receive the same webhook twice. Make your processing idempotent.Implement Security: Always verify webhook signatures to ensure requests are from Ultravox Realtime.Monitor Failures: Keep track of failed webhook deliveries and have a backup plan to retrieve missed data via our API.Use HTTPS: Always use HTTPS endpoints for webhooks to protect sensitive data in transit.