About inbound call webhooks
You can intercept, reroute and decline every incoming call with inbound call webhooks.
You will receive a JSON payload (event: "call_inbound"
) within 10 seconds after a call was initiated. Your endpoint will need to respond with an updated call_inbound
object to assign an agent to the call or update the metadata.
What to expect
- If your endpoint responds with an empty call_inbound object, the call will be disconnected.
- If your endpoint doesn’t respond within timeout, the call is put on hold. Up to 3 more requests will be sent. If all these attempts fail, the call will be rerouted to the
default_agent
you specified. If you did not specify adefault_agent
, the call will be disconnected.
Requests
Every inbound call will generate and send a JSON in this format:
Responses
Your endpoint needs to respond with an updated call_inbound object.