Skip to Content
WebhookCall Analysis Completed Webhook Payload

Call Analysis Completed Webhook Payload

When a call’s analysis completes, the system sends a POST request containing the payload below to the active webhook URL configured for the CompletedCallAnalysis event. The body is a single JSON object (not an array).

This payload has the same structure as each record in the Call Records (get-calls) endpoint response. The only differences: in the webhook payload the analysis field is always populated (in Call Records it is populated only when includeAnalysis: true is sent), and callDate is returned as the raw value stored in the system, without conversion to the user’s time zone.

Example Payload

{ "callId": "019e925a-5f79-7778-b0be-a45a146cf828", "customerId": "11111111-2222-3333-4444-555555555555", "customerPhoneNumber": "+905xxxxxxxxx", "callDate": "2026-04-10T14:35:12", "queueName": "Musteri Hizmetleri", "topic": "Odeme", "subTopic": "Iade > Gecikme", "resolutionStatus": "Cozuldu", "title": "Iade sureciyle ilgili sikayet", "summary": "Musteri, [MASKED] numarasi icin iade surecinin geciktigini belirtti.", "callIssueType": "Şikayet", "newRequestInfo": "Müşteri, iade sürecinin durumunu uygulama üzerinden takip edebilmek için yeni bir özellik talep etti.", "direction": 1, "directionName": "Giden", "resultId": 1, "resultName": "Cevaplandı", "hangupDirectionId": 1, "hangupDirectionName": "Müşteri", "endTime": "2026-04-10T14:41:47", "answerTime": "2026-04-10T14:35:20", "callDurationSeconds": 387.5, "queueWaitSeconds": 12, "personnelId": "22222222-3333-4444-5555-666666666666", "personnelName": "Ayşe Yılmaz", "agentId": "agent-42", "agentName": "İade Botu", "analysis": [ { "key": "musteri_memnuniyeti", "friendlyName": "Müşteri Memnuniyeti", "value": "Olumlu" } ], "metadata": { "ref_id": "q_6876" }, "recordUrl": "https://public-api.thinkvoice.ai/api/app/public-calls/019e925a-5f79-7778-b0be-a45a146cf828/record" }

Text values in the example (queue names, topics, labels such as directionName or resultName) are shown as they are returned for a Turkish-speaking tenant. Field names and the payload structure are the same for every tenant.

Fields

FieldTypeRequiredDescription
callIdstring (UUID)NoUnique identifier of the call in the system.
customerIdstring (UUID)NoUnique identifier of the customer in the system.
customerPhoneNumberstringNoCustomer phone number. Returns null if no number is on record.
callDatedatetimeNoCall date. Not converted to the user's time zone; this is the raw value stored in the system.
queueNamestringNoQueue the call belongs to.
topicstringNoMain topic.
subTopicstringNoSubtopic chain.
resolutionStatusstringNoText representation of the resolution status.
titlestringNoCall title. Sensitive data is masked.
summarystringNoSummary text. Data such as phone numbers, email addresses and national ID numbers (TCKN) are returned as [MASKED].
callIssueTypestringNoCall type.
newRequestInfostringNoNew request or feature request information. Returns null if there is none.
directionintNoCall direction. 0 = Inbound, 1 = Outbound.
directionNamestringNoText representation of the call direction, e.g. "Gelen" (Inbound), "Giden" (Outbound).
resultIdintNoCall result ID. 1 = Answered, 2 = Rejected (legacy records), 3 = Busy, 4 = Not Answered, 5 = Missed, 6 = Failed, 7 = Invalid Number.
resultNamestringNoText representation of the call result.
hangupDirectionIdintNoID indicating which party ended the call.
hangupDirectionNamestringNoText representation of the hang-up direction.
endTimedatetimeNoEnd time of the call. Returns null if unavailable.
answerTimedatetimeNoTime the call was answered. Returns null if it was not answered.
callDurationSecondsdoubleNoCall duration (seconds). Returns null if unavailable.
queueWaitSecondsintNoTime spent waiting in the queue (seconds).
personnelIdstringNoID of the agent who handled the call. Returns null if unavailable.
personnelNamestringNoName of the agent who handled the call.
agentIdstringNoID of the AI agent that handled the call. Returns null if unavailable.
agentNamestringNoName of the AI agent that handled the call.
analysisarrayNoExtended analysis parameters; always populated. Each item has the form { key (snake_case), friendlyName (label), value }.
metadataobjectNoThe metadata sent with the Start Call request that initiated the call, returned as-is. null if no metadata was sent.
recordUrlstringNoDownload URL of the call recording. Send a GET request with a Bearer token; opening it in a browser returns 401. See the Call Recording page for details.

The fields above form a fixed contract; they do not change by provider (unlike the Call Records / call-log endpoint). Apart from hangupDirectionId/hangupDirectionName and resultId/resultName, free-text fields (summary, title, etc.) may be empty.

The metadata field contains all the custom fields you sent when starting the call, unchanged. To match the call with your own system, we recommend sending a field such as ref_id.

recordUrl is a Public API URL and requires a Public API token. After receiving the webhook, download the recording from your own system using a token. See the Call Recording page for details.

Last updated: