Skip to Content
WebhookWebhook

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, 429 or 5xx), 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

ValueNameDescription
1CompletedCallAnalysisCompleted 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: