API

ScaleTalk programmatisch steuern — Schlüssel erstellen, erste Anfrage, interaktive Referenz.

Über die öffentliche REST-API steuerst du ScaleTalk aus deinen eigenen Systemen: Agenten anlegen und ändern, Anrufe und Transkripte auslesen, Rufnummern kaufen, Kampagnen starten, Wissensdokumente hochladen.

Alles, was du in der Oberfläche machst, lässt sich damit automatisieren — aus einem eigenen Backend, aus n8n oder direkt aus einer KI wie Claude.

VideoanleitungScaleTalk-API mit Claude verbinden und Agenten per Chat bauen

Der Sprung ins Video

Wenn dich nur die API-Anbindung interessiert: Ab 10:33 geht es im Video genau darum, wie du die ScaleTalk-API mit Claude verbindest.

Einen API-Schlüssel erstellen

Einstellungen öffnen

Klick oben rechts auf dein Profilbild und im Menü auf Einstellungen.

Das Benutzermenü oben rechts mit dem Eintrag Einstellungen

Schlüssel anlegen

Wechsle auf den Reiter API-Schlüssel und klick auf API-Schlüssel erstellen. Vergib einen Namen, wähle optional ein Ablaufdatum und hak genau die Berechtigungen an, die dieser Schlüssel braucht.

Der Dialog API-Schlüssel erstellen mit Name, Ablauf und den Berechtigungen

Der Schlüssel wird genau einmal angezeigt

Nach dem Erstellen siehst du den vollständigen Schlüssel ein einziges Mal. Danach steht in der Übersicht nur noch ein abgeschnittener Rest. Kopiere ihn sofort in deinen Passwortmanager oder direkt in die Zielanwendung.

Wie du Berechtigungen sinnvoll zuschneidest, Schlüssel widerrufst und aufräumst, steht unter API-Schlüssel verwalten.

Die erste Anfrage

Der Schlüssel wandert als Bearer-Token in den Authorization-Header:

curl https://app.scaletalk.ai/api/public/v1/me \
  -H "Authorization: Bearer sk_live_..."


Basis-URL	`https://app.scaletalk.ai/api/public/v1`
Staging	`https://staging.scaletalk.ai/api/public/v1`
Authentifizierung	`Authorization: Bearer <dein Schlüssel>`
Format	JSON in Anfrage und Antwort

GET /me ist der beste erste Aufruf: Er braucht keine besonderen Berechtigungen und sagt dir, ob Schlüssel und Basis-URL stimmen.

Interaktive Referenz

Die vollständige, immer aktuelle Referenz liegt in der Plattform selbst — mit allen Feldern, Beispielantworten und der Möglichkeit, Aufrufe direkt im Browser auszuprobieren:

API-Dokumentation öffnen

Interaktive Referenz mit allen Endpunkten, Parametern und Beispielen. Erreichbar auch über den Button API-Dokumentation auf der Seite mit den API-Schlüsseln.

Die maschinenlesbare Spezifikation liegt unter https://app.scaletalk.ai/api/public/v1/openapi.json — praktisch, wenn du dir einen Client generieren lassen willst.

Einen Überblick, welche Endpunkte es überhaupt gibt, findest du unter Endpunkte.

API-Zugang zu einem fremden Konto

Arbeitest du als Dienstleister für einen Kunden, braucht ihr keinen geteilten Schlüssel: Über Entwickler-Workspaces kann dir ein Kunde befristeten Zugriff auf seinen Arbeitsbereich geben. Frag dazu beim Support nach.