Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.talkturo.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

​
Authentifizierung

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