Webhook

A webhook is a mechanism for real-time data delivery between applications. When a specific event occurs in a source system, the system sends an HTTP POST request (the "webhook") to a pre-configured URL in the destination system, carrying data about the event as a JSON payload.

Webhooks are a fundamental integration pattern for AI voice agent platforms. Rather than requiring external systems to repeatedly poll for new data ("has a call ended yet?"), webhooks push data the moment an event happens.

Common TurboCall webhook events

• call.completed — Fired when a call ends; includes transcript, duration, outcome, and captured data
• lead.captured — Fired when the AI captures lead information (name, email, phone, intent)
• appointment.booked — Fired when the AI successfully books an appointment
• transfer.initiated — Fired when the AI escalates a call to a human agent
• sentiment.threshold — Fired when caller sentiment drops below a configured threshold

Webhook payload example

{
  "event": "call.completed",
  "call_id": "cal_8f3k2j9",
  "timestamp": "2026-03-28T14:22:31Z",
  "duration_seconds": 187,
  "outcome": "appointment_booked",
  "transcript_url": "https://...",
  "caller": { "phone": "+14155552671", "name": "Jane Doe" }
}

Webhooks vs. polling vs. native integrations

Webhooks are more efficient than polling but require the destination system to have an accessible HTTPS endpoint. For common tools (HubSpot, Salesforce, Slack), TurboCall offers native integrations that handle the webhook logic internally — no custom endpoint needed.