Send Call
When a call ends, send its details to this endpoint. ThinkVoice saves the call and queues it for analysis; when the analysis completes, the Call Analysis Completed webhook is sent to you if configured.
Headers
Request Body
{
"id": "20260410-143512-00042",
"startTime": "2026-04-10T11:35:12Z",
"answerTime": "2026-04-10T11:35:20Z",
"endTime": "2026-04-10T11:41:47Z",
"source": "02121234567",
"callerName": "Ahmet Yılmaz",
"destination": "08501234567",
"externalSupportPersonnelId": "1042",
"supportPersonnelName": "Ayşe Yılmaz",
"duration": "00:06:35",
"talkDuration": 387,
"queueWaitSeconds": 12,
"queue": "musteri-hizmetleri",
"queueName": "Müşteri Hizmetleri",
"missed": false,
"result": 1,
"hangupDirection": 0,
"direction": 0,
"recordUrl": "https://santral.firma.com/kayitlar/20260410-143512-00042.wav"
}Parameters
startTime, answerTime and endTime must be in UTC. Dates without time zone information (2026-04-10T14:35:12) or with a local offset (+03:00) are rejected with 400. Convert your local time to UTC before sending.
You can deliver the recording in two ways: by providing a URL in the recordUrl field, or by sending the file directly with the Upload Recording endpoint. Agree with our team during the integration on which one will be used for your account.
Example cURL
curl --request POST 'https://public-api.thinkvoice.ai/api/v1/webhooks/calls' \
--header 'X-Api-Key: <API_KEY>' \
--header 'X-Api-Secret: <API_SECRET>' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": "20260410-143512-00042",
"startTime": "2026-04-10T11:35:12Z",
"answerTime": "2026-04-10T11:35:20Z",
"endTime": "2026-04-10T11:41:47Z",
"queue": "musteri-hizmetleri",
"result": 1,
"direction": 0,
"recordUrl": "https://santral.firma.com/kayitlar/20260410-143512-00042.wav"
}'Responses
If a problem occurs during processing, the HTTP status may still be 200, but the success field will be false and the reason will be given in message. To consider a submission successful, check the success field, not just the HTTP status.
| Message | HTTP | Description |
|---|---|---|
StartTime, EndTime and AnswerTime must be UTC. | 400 | One of the dates was not sent in UTC (Z). |
EndTime cannot be earlier than StartTime. | 400 | endTime is before startTime. |
EndTime cannot be earlier than AnswerTime. | 400 | endTime is before answerTime. |
Unregistered Tenant. | 401 | X-Api-Key / X-Api-Secret is missing, invalid or disabled. |
An error occurred while processing the call data. | 500 | Unexpected error. Try again. |