Skip to content
AISARAISAR
Calls

Calls

Call transcript ready

call.transcript_ready

Fires when the automatic transcript of a call recording is ready. It arrives after call.recording_ready and only for companies whose administrator has turned on automatic call transcription. The payload carries the same call record as the other call.* events, without the routing block; it contains no conversation text. Read the transcript itself with GET /v1/calls/{call_id}/transcript (the response has source = recording). The event is not sent for calls of hidden contacts.

HTTP request

AISAR sends a signed POST request to your webhook_url:

http
POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...

{
  "event": "call.transcript_ready",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-06-06T12:04:10.000000Z",
  "company_id": 1,
  "data": {
    "call_id": 123,
    "direction": "inbound",
    "status": "completed",
    "from_number": "12025550187",
    "to_number": "12025550187",
    "contact_id": 42,
    "conversation_id": 100,
    "channel_id": 5,
    "external_call_id": "wacall_abc123",
    "duration_sec": 150,
    "started_at": "2026-06-06T12:00:00+00:00",
    "answered_at": "2026-06-06T12:00:08+00:00",
    "ended_at": "2026-06-06T12:02:38+00:00"
  }
}

The X-AISAR-Signature header carries an HMAC-SHA256 signature of the request body — use it to verify the request came from AISAR.

Example payload

json
{
  "event": "call.transcript_ready",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-06-06T12:04:10.000000Z",
  "company_id": 1,
  "data": {
    "call_id": 123,
    "direction": "inbound",
    "status": "completed",
    "from_number": "12025550187",
    "to_number": "12025550187",
    "contact_id": 42,
    "conversation_id": 100,
    "channel_id": 5,
    "external_call_id": "wacall_abc123",
    "duration_sec": 150,
    "started_at": "2026-06-06T12:00:00+00:00",
    "answered_at": "2026-06-06T12:00:08+00:00",
    "ended_at": "2026-06-06T12:02:38+00:00"
  }
}

Payload fields

FieldTypeDescription
call_idintegerInternal call ID (stable across all lifecycle events of this call)
directionstringinbound (from contact) or outbound (placed by operator)
statusstringCall status: completed
from_numberstringCaller number. For inbound calls — the customer; for outbound — your WhatsApp Business number
to_numberstringCallee number. For inbound calls — your WhatsApp Business number; for outbound — the customer
contact_idinteger|nullContact ID
conversation_idinteger|nullConversation ID
channel_idintegerWhatsApp Business channel ID
external_call_idstring|nullProvider-specific call ID (WhatsApp/SIP)
duration_secintegerTalk time in seconds
started_atstring|nullISO 8601 timestamp the call started ringing
answered_atstringISO 8601 timestamp the call connected
ended_atstringISO 8601 timestamp the call ended