Public API & Webhooks

One call's full outcome: status, duration, AI analysis and transcript.

curl https://app.exocall.io/api/v1/calls/1234 \
  -H "Authorization: Bearer exo_live_..."

{
  "id": 1234,
  "call_type": "outbound",
  "phone": "09876543210",
  "duration_seconds": 142,
  "ended_by": "ai",
  "lead_label": "hot",            // hot | warm | cold | not_interested | callback_requested
  "lead_score": 4,                // 1–5
  "callback_datetime": null,
  "summary": "Customer asked about pricing...",
  "intent": "pricing",
  "sentiment": "positive",
  "language_used": "Hinglish",
  "key_insight": "Ready to buy if EMI option is available",
  "analysis_extra": {              // extended analysis (null on older calls)
    "call_outcome": "completed",   // completed | caller_hung_up_early | voicemail | wrong_person | dropped
    "goal_achieved": true,         // outbound calls with a purpose only
    "next_action": "Send EMI plan on WhatsApp, call back Thursday",
    "follow_up_message": "Ready-to-send WhatsApp text in the caller's language",
    "customer_details": { "name": "Ravi", "city": "Surat" },
    "competitors_mentioned": ["..."],
    "questions_unanswered": ["..."],
    "agent_performance": 4,        // 1–5 AI agent QA rating
    "agent_mistakes": null,
    "agent_talk_percent": 55
  },
  "recording_url": "https://...",
  "transcript": [ { "role": "agent", "text": "...", "spoken_at": "..." } ]
}

Paginated call history. Filters: limit (max 100), offset, call_type (inbound/outbound), lead_label, search (phone), date_from/date_to (YYYY-MM-DD), campaign_id.

curl "https://app.exocall.io/api/v1/call-logs?lead_label=hot&limit=50" \
  -H "Authorization: Bearer exo_live_..."

{ "total": 8, "stats": { ... }, "calls": [ { "id": 1234, "lead_label": "hot", ... } ] }

Push a lead in from your CRM or form. Without campaign_id the lead is called immediately; with it, the lead is added to that draft campaign instead.

curl -X POST https://app.exocall.io/api/v1/leads \
  -H "Authorization: Bearer exo_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "phone": "+919876543210", "name": "Ravi", "purpose": "Follow up on demo request" }'

# 201 → { "call_sid": "...", "phone": "09876543210", "status": "call_initiated" }

# Or add to a campaign instead of calling now:
#   { "phone": "+919876543210", "name": "Ravi", "campaign_id": 12 }
# 201 → { "added_to_campaign": 12, "phone": "+919876543210", "total_leads": 341 }

Bulk-add up to 1,000 contacts to a draft campaign in one request.

curl -X POST https://app.exocall.io/api/v1/campaigns/12/contacts \
  -H "Authorization: Bearer exo_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "contacts": [
        { "phone": "+919876543210", "name": "Ravi",  "notes": "From October webinar" },
        { "phone": "+919812345678", "name": "Meena" }
      ] }'

# 201 → { "campaign_id": 12, "added": 2, "total_leads": 343 }