Webhooks - Trikon Voice

Webhooks allow your application server to receive instant HTTP notifications whenever a call completes or generates AI summaries and transcripts.

Configure your webhook URL in Settings → Developer API. Each workspace can store one URL.

Webhook Delivery

When an event occurs, Trikon sends an HTTP POST request to your configured Webhook URL with a Content-Type: application/json payload. Your server should respond with a 200 OK status code within 3 seconds to acknowledge receipt.

Event Types

Event Name	Trigger Description
`call.completed`	Fired when a phone call finishes a successful human conversation.
`call.no_answer`	Fired when a call goes to voicemail, is unanswered, or busy.
`call.failed`	Fired when call origination or line connectivity fails.
`recording.ready`	Fired when the carrier MP3 audio recording has finished processing.
`analysis.completed`	Fired when Gemini AI generates post-call summary, sentiment, and intent.

Payload Schema

Every webhook event payload includes standardized call metadata, call status, duration, recording URL, and full conversation transcripts.

Example Payload (`call.completed`)

{
  "event": "call.completed",
  "callUuid": "9d1f6b2a-0c44-11f0-9c3e-0242ac120002",
  "callLogId": "bf9c7bea-16ae-481e-b943-e962c4199933",
  "enterprise": "acmeclinic",
  "campaignId": "731874e9-c349-4c18-ad52-40a80ffcd0f2",
  "leadId": null,
  "agentId": "8f2c1d34-5b6a-4c7e-9f10-2a3b4c5d6e7f",
  "direction": "outbound",
  "from": "+918031339921",
  "to": "+919845012345",
  "name": "Asha",
  "callStatus": "completed",
  "disconnectReason": "normal_hangup",
  "duration": 45,
  "recordingUrl": "https://voice.trikon.tech/api/media-proxy?url=https%3A%2F%2Fexample.com%2Frecordings%2F0579a482.mp3",
  "timestamp": "2026-08-03T10:15:30.000Z",
  "origin": "campaign",
  "hangupSource": "callee",
  "hangupCause": "normal_clearing",
  "summary": "User confirmed the appointment for Thursday.",
  "intent": "appointment_scheduled",
  "sentiment": "positive",
  "sentimentReason": "User enthusiastically agreed to the time.",
  "calledAt": "2026-08-03T10:14:45.000Z",
  "transcript": [
    {
      "speaker": "Agent",
      "text": "Hello Asha, I'm calling from Acme Clinic regarding your upcoming health checkup."
    },
    {
      "speaker": "User",
      "text": "Hi, yes! I'd like to confirm my appointment for Thursday at 3 PM."
    },
    {
      "speaker": "Agent",
      "text": "Perfect! Your appointment for Thursday at 3 PM is confirmed. See you then!"
    }
  ]
}

Field Reference

string

The event type: call.completed, call.no_answer, call.failed, recording.ready, or analysis.completed.

string

Unique carrier call identifier string.

string

Unique database log ID for matching records in Trikon Call Logs.

string

Your workspace slug (e.g., acmeclinic).

string

(Optional) Unique campaign ID if the call was originated from an outbound campaign.

string

(Optional) The identifier for the lead associated with this call.

string

UUID of the AI Voice Agent that handled the call.

string

The call direction (outbound or inbound).

string

The outbound phone number initiating the call in international E.164 format.

string

The recipient phone number in international E.164 format.

string

The recipient’s name passed during call initiation.

string

Final call status: completed, no_answer, busy, or failed.

string

Reason for disconnection: normal_hangup, voicemail_detected, or user_rejected.

number

Total call duration in seconds.

string

Direct audio URL to stream or download the call MP3 recording.

string

ISO 8601 timestamp of when the event occurred.

string

The source of the call (e.g., web embed, campaign).

string

(Optional) The source that initiated the call hangup (e.g., callee, caller).

string

(Optional) The technical SIP cause for the call termination.

string

(Optional) AI executive summary of the conversation. Populated when AI analysis is generated.

string

(Optional) AI-detected caller intent (e.g. appointment_scheduled, voicemail, not_interested). Populated when AI analysis is performed.

string

(Optional) AI-detected caller sentiment (e.g., positive, neutral, negative). Populated when AI analysis is performed.

string

(Optional) Brief AI explanation for the detected sentiment.

string

(Optional) ISO 8601 timestamp of when the call was initiated.

array

Turn-by-turn spoken conversation transcript objects containing speaker and text. Captured automatically for every call.

Delivery & Retries

Your application server should respond with a 200 OK status code within 3 seconds of receiving a webhook request. If your endpoint returns a server error (5xx or 408) or times out, Trikon automatically retries webhook delivery up to 3 times with exponential backoff.

Perform heavy backend processing (such as CRM syncs or database updates) asynchronously after returning an immediate 200 OK response.

​Webhook Delivery

​Event Types

​Payload Schema

​Example Payload (call.completed)

​Field Reference

​Delivery & Retries

Webhook Delivery

Event Types

Payload Schema

Example Payload (`call.completed`)

Field Reference

Delivery & Retries