Die Call0-API.

Alle Endpoints liegen unter der Basis-URL https://www.call0.ai/api/v1. Requests und Responses sind JSON (Content-Type: application/json). Alle Ressourcen sind strikt auf das Konto deines API-Keys beschränkt.

Erstelle API-Keys im Dashboard unter Entwickler. Keys beginnen mit ck_live_ und werden nur einmal angezeigt. Jeder Key hat einen Scope: read (lesen) oder write (lesen + Anrufe starten).

Sende den Key als Bearer-Token:

curl https://www.call0.ai/api/v1/calls \
  -H "Authorization: Bearer ck_live_IhrSchluessel"

Ohne gültigen Key antwortet die API mit 401, bei fehlendem Scope mit 403.

GET/v1/calls

Listet die Anrufe deines Kontos, neueste zuerst. Scope: read.

curl "https://www.call0.ai/api/v1/calls?limit=2" \
  -H "Authorization: Bearer ck_live_…"

Antwort · 200

{
  "calls": [
    {
      "id": "3af91e9e-…",
      "agent_id": "23061e5a-…",
      "direction": "inbound",
      "status": "completed",
      "from": "+4917612345678",
      "to": "+4921268943062",
      "started_at": "2026-07-01T14:00:05Z",
      "ended_at": "2026-07-01T14:03:41Z",
      "duration_seconds": 216,
      "sentiment": "positive",
      "summary": "Tischreservierung für 4 Personen am Freitag, 19 Uhr.",
      "action_items": ["Reservierung bestätigen"],
      "callback_requested": false
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 0
}

GET/v1/calls/{id}

Ein einzelner Anruf — zusätzlich zur Liste mit vollständigem transcript. Scope: read.

curl https://www.call0.ai/api/v1/calls/3af91e9e-… \
  -H "Authorization: Bearer ck_live_…"

Antwort · 200

{
  "call": {
    "id": "3af91e9e-…",
    "status": "completed",
    "duration_seconds": 216,
    "summary": "Tischreservierung für 4 Personen …",
    "transcript": [
      { "role": "agent",  "text": "Willkommen bei MAKU …" },
      { "role": "caller", "text": "Ich hätte gern einen Tisch für vier." },
      { "role": "agent",  "text": "Sehr gern — für wann?" }
    ]
  }
}

Existiert der Anruf nicht (oder gehört er einem anderen Konto): 404.

POST/v1/calls/outbound

Startet einen ausgehenden Anruf über einen deiner Outbound-Agenten. Scope: write. Als agent_id ist der Outbound-Agent selbst oder sein Inbound-Elternteil erlaubt — Call0 löst automatisch zum Outbound-Agenten auf.

curl -X POST https://www.call0.ai/api/v1/calls/outbound \
  -H "Authorization: Bearer ck_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "23061e5a-…",
    "to": "+4917612345678",
    "mode": "2",
    "variables": { "name": "Frau Weber", "sendung": "DHL-4471" }
  }'

Antwort · 201

{
  "success": true,
  "call_id": "d9d63b86-…",
  "call_sid": "CA7f3e…",
  "mode": "2"
}

Für Demo-Modi ist mode direkt in diesem Request die sichere Variante: Der Wert wird beim Platzieren festgeschrieben und kann sich bis zum Abheben nicht mehr ändern. Ohne Feld verwendet Call0 den zuvor über POST /v1/agents/{id}/mode gesetzten Default.

Den Verlauf holst du danach über GET /v1/calls/{call_id} — oder du lässt dir das Ergebnis per Webhook schicken. Fehlt dem Agenten eine Absender-Nummer: 422.

GET/v1/agents

Listet die Agenten deines Kontos (ID, Name, Rolle, Sprache, Status).

POST/v1/agents

Legt einen Agenten an. Wichtigste Felder:

Lege Webhook-Endpoints im Dashboard unter Integrationen → Webhook erstellen an. Nach jedem abgeschlossenen Gespräch senden wir call.completed als POST an deine URL. Außerdem kannst du call.missed, call.failed, handoff.requested, handoff.connected, intake.captured und booking.created abonnieren. Der Button Docs im Webhook-Dialog zeigt alle Payloads, Wiederholungen und Pausenregeln:

{
  "event": "call.completed",
  "call": {
    "id": "3af91e9e-…",
    "agent_id": "23061e5a-…",
    "direction": "outbound",
    "status": "completed",
    "duration_seconds": 216,
    "summary": "…",
    "transcript": [ … ]
  }
}

Jede Zustellung ist signiert: Header X-Call0-Signature enthält sha256=<hex> — ein HMAC-SHA256 über timestamp.body mit deinem Webhook-Secret; der Zeitstempel steht in X-Call0-Timestamp. Verifikation in Node:

import crypto from 'crypto'

function verify(req, secret) {
  const ts = req.headers['x-call0-timestamp']
  const sig = req.headers['x-call0-signature'] // "sha256=…"
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(ts + '.' + req.rawBody)
    .digest('hex')
  return crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))
}

Antworte mit einem 2xx-Status. Lehne Zustellungen ab, deren Zeitstempel älter als ein paar Minuten ist (Replay-Schutz).

Fehler kommen als { "error": "…" } mit passendem HTTP-Status. Fragen? Schreib uns.