Call Transcription Webhook

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

EventDescription
CALL_TRANSCRIPTIONSent 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_TRANSCRIPTION on 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_TRANSCRIPTION on 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

FieldTypeRequiredDescription
eventstringYesAlways "CALL_TRANSCRIPTION".
channelstringYesThe channel the call went through. See values below.
callIdstringYesUnique identifier for the call. Same callId as the call's lifecycle webhooks.
callDirectionstringYesDirection of the call. See values below.
callStatusstringYesStatus of the call when the transcript was sent. Normally "END".
durationInSecondsnumberYesCall duration in seconds.
callStartedAtstringYesISO 8601 timestamp when the call started.
callEndedAtstringYesISO 8601 timestamp when the call ended.
fromstringYesYour PSTN number or WhatsApp Business number. The same for incoming and outgoing calls.
tostringYesCustomer's phone number. The same for incoming and outgoing calls.
channelNumberstringYesSame value as from, under the name used by the other call webhooks.
customerNumberstringYesSame value as to, under the name used by the other call webhooks.
agentNumberstringNoPhone number of the team member who handled or started the call. Absent when there is none.
callTypestringYesWho handled the call. See values below.
triggeredViastringYesHow the call was started. See values below.
transcriptobjectYesThe call transcript. See Transcript Object.

channel Values

ValueDescription
PSTNThe call went through your PSTN number
WHATSAPPThe call went through your WhatsApp Business number

callDirection Values

ValueDescription
INCOMINGThe call was placed by the customer to the business
OUTGOINGThe call was placed by the business to the customer

callType Values

ValueDescription
AI_BOTThe call was handled by an AI bot
AGENTThe call was handled by a team member

triggeredVia Values

ValueDescription
INBOUNDThe customer called the business
CAMPAIGNThe call was placed as part of a voice campaign
APIThe call was started through the public API
UIThe call was started from the DoubleTick app

Transcript Object

FieldTypeRequiredDescription
linesarrayYesThe 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.

KeyValue typeDescription
AgentstringWhat the agent said. In an AI bot call, this is the AI bot.
CustomerstringWhat the customer said.
Tool callobjectAn action the AI bot took during the call. See Tool Call Line. AI bot calls only.
System errorstringAn 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 endedstringHow 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 labelstringIn 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

FieldTypeRequiredDescription
namestringYesName of the action.
responseTimeMsnumberNoHow long the action took to respond, in milliseconds.
argumentsobjectYesThe inputs the AI bot passed to the action. An empty object when there were none.
resultstring, object or arrayNoWhat the action returned to the AI bot. Absent when the action returned nothing.

🚧

Note

When a call ends, callStatus is "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.
  • agentNumber is absent, not an empty string, when no team member handled or started the call.
  • from and channelNumber always hold your number. to and customerNumber always 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 result is what the action returned to the AI bot. It can be long text, often in Markdown.

Best Practices

  • Use callId to link this event with the call's lifecycle webhooks: CALL_INCOMING_INITIATED or CALL_OUTGOING_INITIATED, then CALL_ACCEPTED, CALL_ENDED and CALL_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 channel to tell the calls apart.
  • Treat agentNumber as 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.