Callcompleted

Sent once when a connected call is final, with its outcome. Verify Telleo-Signature before trusting it, answer 2xx within 10 seconds, and ignore an id you have already processed.

WEBHOOK call.completed

Example

{
  "id": "evt_6f1d2c9a8b7e4f3a2d1c0b9a",
  "object": "event",
  "type": "call.completed",
  "created_at": "2026-10-13T09:33:05Z",
  "data": {
    "id": "call_6f1d2c9a8b7e4f3a2d1c0b9a",
    "object": "call",
    "status": "completed",
    "agent_id": "17ea33d2-5b6c-4c1e-9a1f-2d4e6f8a9b0c",
    "phone_number": "[phone]",
    "contact": {
      "name": "Asha Verma",
      "email": "[e-mail]",
      "external_id": "lead-8812"
    },
    "variables": {
      "course": "NEET 2027",
      "city": "Indore"
    },
    "metadata": {
      "crm_owner": "u_42"
    },
    "batch_id": null,
    "test": false,
    "duration_seconds": 142,
    "created_at": "2026-10-13T09:30:02Z",
    "dialed_at": "2026-10-13T09:30:03Z",
    "ended_at": "2026-10-13T09:32:31Z",
    "recording_url": "https://media.example-cdn.com/recordings/abc.mp3?X-Amz-Signature=…",
    "recording_expires_at": "2026-10-14T09:40:00Z",
    "outcome": {
      "disposition": "Interested",
      "summary": "Asha wants the NEET 2027 weekend batch and asked for the fee structure on WhatsApp.",
      "answers": {
        "Which course are you interested in?": "NEET 2027",
        "Preferred batch timing?": "Weekends"
      },
      "lead_rating": 8,
      "callback_requested": true,
      "callback_time_text": "tomorrow after 6 pm",
      "follow_up": "CALL",
      "follow_up_note": "Send the fee structure; call back tomorrow evening.",
      "meeting": {
        "requested": true,
        "at": "2026-10-14T18:00:00+05:30",
        "time_text": "tomorrow after 6 pm",
        "type": "call"
      },
      "transcript": [
        {
          "speaker": "agent",
          "text": "Hi Asha, this is Riya from Shiksha Academy. Is this a good time?"
        },
        {
          "speaker": "contact",
          "text": "Yes, tell me."
        }
      ]
    }
  }
}

Authorizations

X-API-Key · string · header · required

Your AI calling API key (vak_call_…). Authorization: Bearer <key> also works.

Headers

Telleo-Signature · string · required

Telleo-Event-Id · string · required

Telleo-Event-Type · string · required

Body

application/json

id · string

Same on every retry of this event. Use it to ignore duplicates.

Example:

"evt_6f1d2c9a8b7e4f3a2d1c0b9a"

object · string

Allowed value: "event"

type · enum<string>

Available options: call.completed, call.not_connected, webhook.test

created_at · string<date-time>

data · object

Show child attributes

Response

200

Any 2xx acknowledges the event.