Skip to main content

Overview

When a Voice call ends, Reach analyzes it and sends one call.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

Answer 2xx within 5 seconds, once the event is stored or queued. Reach aborts the request at 5 seconds.
A 400 or 422 is read as a final rejection. Return 503 for anything temporary on your side, or the call is lost.
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.