Skip to main content
Docs menu: Webhook payload

API reference

Webhook payload

The request Telvana sends to your server when a call ends. Not an endpoint you call.

Post-conversation webhook

POST Your webhook URL

Sent once per call, after the call ends, when the agent's post-conversation webhook is on. How to turn it on, check the signature and handle delivery is in the Webhooks guide.

Body fields

Name Description
conversationId string required Unique identifier for the conversation
dateInitiated string (date-time) required When the conversation started (ISO timestamp)
agentId string required ID of the AI agent that handled the call
workspaceId string required ID of the workspace/organization
transcript string required Full text transcript of the conversation (empty string for failed calls)
direction INBOUND | OUTBOUND required Direction of call: OUTBOUND (Calling a Human) or INBOUND (Incoming Call from Human)
cost number required Cost in cents (0 for failed calls)
agentPhoneNumber string required The phone number used by the AI agent
humanPhoneNumber string required The customer's phone number
duration number required Call duration in seconds (0 for failed calls)
summary string required AI-generated summary of the conversation (empty string for failed calls)
sentiment POSITIVE | NEUTRAL | NEGATIVE | N_A required Sentiment classification of the conversation. N_A indicates no sentiment is available (e.g., the call failed to connect and no human was reached).
disposition string required Call outcome (e.g., COMPLETED, FAILED, VOICEMAIL). For failed calls this is "FAILED".
tags array of string required Zero or more tags that apply to this conversation (built-in and custom)
variables object of string required Key-value pairs passed during call initiation
recordingUrl string Signed link to the call recording, valid for an hour. Absent when the call never connected.

Example body

{
  "conversationId": "clx8y9z1a2b3c4d5e6f7g8h9i",
  "dateInitiated": "2025-12-01T14:30:00.000Z",
  "agentId": "agent_abc123",
  "workspaceId": "workspace_xyz789",
  "transcript": "Agent: Hello, this is Sarah from Telvana calling to confirm your appointment tomorrow at 2:00 PM. Is this still convenient for you?\n\nCustomer: Yes, that works perfectly. Thank you for calling to confirm.\n\nAgent: Great! We look forward to seeing you tomorrow. Have a wonderful day!\n\nCustomer: Thank you, you too!",
  "direction": "OUTBOUND",
  "cost": 125,
  "agentPhoneNumber": "+15559876543",
  "humanPhoneNumber": "+15551234567",
  "duration": 210,
  "recordingUrl": "https://s3.amazonaws.com/recordings/clx8y9z1a2b3c4d5e6f7g8h9i.wav",
  "summary": "Successfully confirmed customer appointment for tomorrow at 2:00 PM. Customer was polite and confirmed availability.",
  "sentiment": "POSITIVE",
  "disposition": "COMPLETED",
  "tags": [
    "appointment_booked"
  ],
  "variables": {
    "firstName": "John",
    "lastName": "Smith",
    "appointmentTime": "2:00 PM"
  }
}