REST-API – Überblick

Die Talkturo-REST-API gibt Ihnen die volle programmatische Kontrolle über Ihre Voice-KI-Infrastruktur: Assistenten anlegen und konfigurieren, ausgehende Kampagnen starten, CRM-Kontakte und -Unternehmen verwalten, Telefonnummern kaufen und Anrufdaten abrufen — ohne das Dashboard. Fast jede Aktion der Web-App ist über diese API abbildbar.

Authentifizierung

API-Token holen und Anfragen mit Bearer-Header autorisieren.

Assistenten

KI-Assistenten erstellen, konfigurieren und Telefonnummern zuweisen.

Kampagnen

Ausgehende Kampagnen aufbauen und Massenwahl starten.

Kontakte

CRM-Kontakte für Kampagnen anlegen und auflisten.

Unternehmen

Unternehmensdatensätze pflegen und Kontakte verknüpfen.

Telefonnummern

Nummern suchen, kaufen und auflisten.

Webhooks

Echtzeit-Ereignisse zu Anrufen und Abrechnung empfangen.

Basis-URL

Alle Endpunkte sind relativ zur Domain Ihres Talkturo-Kontos:

https://<your-domain>/api

Beispiel zum Auflisten von Kampagnen:

https://<your-domain>/api/crm/campaigns

Anfrageformat

Senden Sie Request-Bodies als JSON und setzen Sie bei jedem POST und PATCH den Header Content-Type: application/json.

curl -X POST https://<your-domain>/api/assistants \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"accountSlug": "my-team", "name": "Sales Agent"}'

Antwortformat

Jede Antwort ist ein JSON-Objekt mit einem booleschen Feld success auf oberster Ebene. Bei Erfolg enthält die Antwort das passende Ressourcenobjekt oder -array. Bei Fehler einen passenden HTTP-Status und eine Fehlermeldung.

{
  "success": true,
  "assistant": {
    "id": "asst_01j...",
    "name": "Sales Agent",
    ...
  }
}

Paginierte Listen liefern zusätzlich count, limit und offset:

{
  "success": true,
  "campaigns": [...],
  "count": 120,
  "limit": 50,
  "offset": 0
}

HTTP-Statuscodes

Code	Bedeutung
`200`	Anfrage erfolgreich
`400`	Ungültige oder fehlende Parameter
`401`	Token fehlt oder ungültig
`403`	Authentifiziert, aber keine Berechtigung für diese Aktion
`404`	Ressource existiert nicht
`409`	Konflikt — z. B. Ressource existiert bereits
`500`	Interner Serverfehler

Authentifizierung

Alle Endpunkte erfordern einen Bearer-Token im Header Authorization. Details: Authentifizierung.

Authentifizierung

Assistenten

Kampagnen

Kontakte

Unternehmen

Telefonnummern

Webhooks

​Basis-URL

​Anfrageformat

​Antwortformat

​HTTP-Statuscodes

​Authentifizierung

Basis-URL

Anfrageformat

Antwortformat

HTTP-Statuscodes

Authentifizierung