Receive the transcript of a completed PSTN or WhatsApp call, for calls handled by an AI bot and for calls handled by a team member.
The Call Transcription webhook sends you the transcript of a completed call, for calls handled by an AI bot and for calls handled by a team member.
A single event covers both calling channels. The channel field tells you whether the call went through your PSTN number or your WhatsApp Business number.
Events Covered
| Event | Description |
|---|---|
CALL_TRANSCRIPTION | Sent a few minutes after the transcript of a completed PSTN or WhatsApp call is ready |
Call Transcription
Event type: CALL_TRANSCRIPTION
This event is sent once the call's transcript is ready, usually about 2 minutes later. If the call is still being processed, it can take longer, up to about 45 minutes. It always arrives after CALL_ENDED for the same call.
The transcript you receive is the same one the DoubleTick app shows for the call:
- For a call handled by an AI bot, it is the AI bot's conversation with the customer.
- For a call handled by a team member, it is the transcript made from the call recording.
Trigger Conditions
The event is emitted when:
- A PSTN or WhatsApp call has ended and its transcript is ready.
- For a call handled by an AI bot, the transcript is saved automatically at the end of the call.
- For a call handled by a team member, the transcript is made automatically when call transcription is enabled for your organization, or when a team member generates it from the chat.
- A webhook is subscribed to
CALL_TRANSCRIPTIONon the channel the call went through — your PSTN number for a PSTN call, or your WhatsApp Business number for a WhatsApp call.
It is not emitted when:
- No transcript is available for the call — for example the call was missed or rejected, it ended without a recording, or nothing was said.
- For a call handled by a team member, call transcription is turned off and nobody generated the transcript from the chat.
- For a call handled by a team member, the transcript could not be generated, for example because transcription failed or your organization ran out of AI credits.
- The transcript for the call was already sent earlier. The event fires only once per call.
- The call is a bot test call and webhooks were not turned on for that test.
- No webhook is subscribed to
CALL_TRANSCRIPTIONon the call's channel.
Subscriptions are per channel. A webhook on your PSTN number receives transcripts for PSTN calls, and a webhook on your WhatsApp Business number receives transcripts for WhatsApp calls. Subscribe on both if you want both. On WhatsApp, the event is offered only to organizations with WhatsApp calling or a calling licence.
Payload Structure
| Field | Type | Required | Description |
|---|---|---|---|
event | string | Yes | Always "CALL_TRANSCRIPTION". |
channel | string | Yes | The channel the call went through. See values below. |
callId | string | Yes | Unique identifier for the call. Same callId as the call's lifecycle webhooks. |
callDirection | string | Yes | Direction of the call. See values below. |
callStatus | string | Yes | Status of the call when the transcript was sent. Normally "END". |
durationInSeconds | number | Yes | Call duration in seconds. |
callStartedAt | string | Yes | ISO 8601 timestamp when the call started. |
callEndedAt | string | Yes | ISO 8601 timestamp when the call ended. |
from | string | Yes | Your PSTN number or WhatsApp Business number. The same for incoming and outgoing calls. |
to | string | Yes | Customer's phone number. The same for incoming and outgoing calls. |
channelNumber | string | Yes | Same value as from, under the name used by the other call webhooks. |
customerNumber | string | Yes | Same value as to, under the name used by the other call webhooks. |
agentNumber | string | No | Phone number of the team member who handled or started the call. Absent when there is none. |
callType | string | Yes | Who handled the call. See values below. |
triggeredVia | string | Yes | How the call was started. See values below. |
transcript | object | Yes | The call transcript. See Transcript Object. |
channel Values
| Value | Description |
|---|---|
PSTN | The call went through your PSTN number |
WHATSAPP | The call went through your WhatsApp Business number |
callDirection Values
| Value | Description |
|---|---|
INCOMING | The call was placed by the customer to the business |
OUTGOING | The call was placed by the business to the customer |
callType Values
| Value | Description |
|---|---|
AI_BOT | The call was handled by an AI bot |
AGENT | The call was handled by a team member |
triggeredVia Values
| Value | Description |
|---|---|
INBOUND | The customer called the business |
CAMPAIGN | The call was placed as part of a voice campaign |
API | The call was started through the public API |
UI | The call was started from the DoubleTick app |
Transcript Object
| Field | Type | Required | Description |
|---|---|---|---|
lines | array | Yes | The lines of the transcript, in conversation order. Never empty. |
Each item in lines is an object with a single key. The key tells you who spoke or what kind of line it is, and the value is its content.
| Key | Value type | Description |
|---|---|---|
Agent | string | What the agent said. In an AI bot call, this is the AI bot. |
Customer | string | What the customer said. |
Tool call | object | An action the AI bot took during the call. See Tool Call Line. AI bot calls only. |
System error | string | An error during the call: "Call failed to connect", "Call disconnected unexpectedly" or "Call error", followed by ": " and the error message when there is one. AI bot calls only. |
Call ended | string | How the call ended: "Call ended by agent", "Call ended by customer", "Call ended due to a system error" or "Call ended". AI bot calls only. |
| Speaker label | string | In a transcript made from the call recording, a line whose speaker could not be identified as the agent or the customer is keyed by a generic speaker label instead. |
In a transcript made from the call recording, lines are normally keyed "Agent" and "Customer".
Tool Call Line
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of the action. |
responseTimeMs | number | No | How long the action took to respond, in milliseconds. |
arguments | object | Yes | The inputs the AI bot passed to the action. An empty object when there were none. |
result | string, object or array | No | What the action returned to the AI bot. Absent when the action returned nothing. |
Note
When a call ends,
callStatusis"END"— not"ENDED". Checking for"ENDED"in your code will silently fail.
Sample Payloads
WhatsApp Call Handled by an Agent
{
"event": "CALL_TRANSCRIPTION",
"channel": "WHATSAPP",
"callId": "call_01HX9A7K2M4N6P8Q0R2S4T6V8W",
"callDirection": "INCOMING",
"callStatus": "END",
"durationInSeconds": 94,
"callStartedAt": "2026-11-16T09:30:12.000Z",
"callEndedAt": "2026-11-16T09:31:46.000Z",
"from": "+919000000000",
"to": "+919111111111",
"channelNumber": "+919000000000",
"customerNumber": "+919111111111",
"agentNumber": "+919222222222",
"callType": "AGENT",
"triggeredVia": "INBOUND",
"transcript": {
"lines": [
{ "Agent": "Hello, thanks for calling. How can I help you?" },
{ "Customer": "Hi, I wanted to check the status of my order." },
{ "Agent": "Sure. Could you share your order number?" },
{ "Customer": "It is 4521." },
{ "Agent": "Thanks. Your order was shipped today and should reach you in two days." },
{ "Customer": "Great, thank you." }
]
}
}
PSTN Call Handled by an AI Bot
{
"event": "CALL_TRANSCRIPTION",
"channel": "PSTN",
"callId": "call_01HX9B3C5D7E9F1G3H5J7K9M1N",
"callDirection": "INCOMING",
"callStatus": "END",
"durationInSeconds": 58,
"callStartedAt": "2026-11-16T10:05:00.000Z",
"callEndedAt": "2026-11-16T10:05:58.000Z",
"from": "+918000000000",
"to": "+919333333333",
"channelNumber": "+918000000000",
"customerNumber": "+919333333333",
"callType": "AI_BOT",
"triggeredVia": "INBOUND",
"transcript": {
"lines": [
{ "Agent": "Hello. Thanks for calling. How can I help you today?" },
{ "Customer": "Hi, tell me about your product." },
{
"Tool call": {
"name": "search_knowledge",
"responseTimeMs": 651,
"arguments": { "query": "product information" },
"result": "## FAQs Found: Our product helps teams manage customer chats and calls in one place."
}
},
{ "Agent": "Our product helps your team manage customer chats and calls in one place." },
{ "Customer": "Okay, thanks." },
{ "Call ended": "Call ended by customer" }
]
}
}
PSTN Call Started by an Agent from the App
{
"event": "CALL_TRANSCRIPTION",
"channel": "PSTN",
"callId": "call_01HX9C8D0E2F4G6H8J0K2M4N6P",
"callDirection": "OUTGOING",
"callStatus": "END",
"durationInSeconds": 41,
"callStartedAt": "2026-11-16T11:20:30.000Z",
"callEndedAt": "2026-11-16T11:21:11.000Z",
"from": "+918000000000",
"to": "+919444444444",
"channelNumber": "+918000000000",
"customerNumber": "+919444444444",
"agentNumber": "+919222222222",
"callType": "AGENT",
"triggeredVia": "UI",
"transcript": {
"lines": [
{ "Agent": "Hi, I'm calling from the sales team about your demo request." },
{ "Customer": "Yes, can we do it tomorrow at 4 pm?" },
{ "Agent": "Tomorrow at 4 pm works. I'll send you the invite." }
]
}
}
Notes
- The event fires once per call, when the transcript first becomes available. Generating the transcript again later does not send a second event.
agentNumberis absent, not an empty string, when no team member handled or started the call.fromandchannelNumberalways hold your number.toandcustomerNumberalways hold the customer's number.- The webhook is fire-and-forget. A delivery failure never affects the transcript being saved.
- Failed deliveries are retried in the same way as the other call webhooks.
- A tool call's
resultis what the action returned to the AI bot. It can be long text, often in Markdown.
Best Practices
- Use
callIdto link this event with the call's lifecycle webhooks:CALL_INCOMING_INITIATEDorCALL_OUTGOING_INITIATED, thenCALL_ACCEPTED,CALL_ENDEDandCALL_TRANSCRIPTION. - Store the transcript against its
callId, so you can match it with the call's other events. - If you subscribe on both your PSTN number and your WhatsApp Business number, check
channelto tell the calls apart. - Treat
agentNumberas optional. Use it for display or audit only. - Read each line by its single key, and ignore keys you don't recognise. New kinds of lines may be added, and your parsing should not break when they are.

