Overview
When a Voice call ends, Reach analyzes it and sends onecall.completed webhook carrying the call, its summary, and its transcript. It arrives after analysis, seconds to minutes behind the hangup.
Registration
Webhook setup is not self-serve. Send your Reach contact the URL that should receive calls, and a bearer token for Reach to present on each request.You issue the token. Reach stores it and sends it back to you on every request so you can authenticate the caller. Reach does not generate it for you.
The request
The payload
partner_user.external_id is your own customer ID, set when Reach matched the caller to a customer you shared. A null is a caller you have no record of, not an error.
Responding
Answer2xx within 5 seconds, once the event is stored or queued. Reach aborts the request at 5 seconds.
Delivery is at-least-once, up to 5 attempts roughly five minutes apart. The same call can arrive more than once, so key your writes on
eventId.