Webhook
ThinkVoice automatically sends an HTTP POST request to your system when certain events occur. This section contains example payloads and field descriptions for webhook events.
How It Works
- The webhook URL, custom headers and an (optional) queue filter are configured per event type in the ThinkVoice admin panel. Each tenant can have a single webhook definition per event type.
- When a call’s analysis completes, the system POSTs a single JSON object (not an array) to the active webhook URL configured for that event type for the relevant tenant, together with the custom headers saved in the definition.
- If a queue filter is configured, the webhook is triggered only for calls in those queues; if the filter is empty, it is triggered for all queues.
- If delivery fails (timeout,
429or5xx), the system makes up to 3 attempts with exponential backoff. If all 3 attempts fail, the webhook is silently dropped — this never blocks or fails the analysis process. - No delivery is attempted for a tenant without an active webhook definition.
Available Event Types
| Value | Name | Description |
|---|---|---|
| 1 | CompletedCallAnalysis | Completed Call Analysis — triggered when a call’s analysis process completes. |
The only event type currently defined in the system is Completed Call Analysis. See the Call Analysis Completed Webhook Payload page for an example payload.
Last updated: