Zum Hauptinhalt springen
Die telli API ist eine REST-API mit JSON-Request- und -Response-Bodies. Mit ihr verwaltest du Kontakte und Kontakteigenschaften, löst Anrufe aus und planst sie, rufst Anrufergebnisse ab und arbeitest mit Agenten und Telefonnummern. Für Anruf-Events in Echtzeit kombinierst du sie mit Webhooks. Wenn du lieber ohne Code integrierst, verbindet sich telli auch mit CRMs und Automatisierungsplattformen. Sieh dir dazu den Integrationsüberblick an.
AuthentifizierungErstelle in der telli App unter Einstellungen > Entwickler > API-Schlüssel einen Schlüssel. Wähle die benötigten Berechtigungen und optional ein Ablaufdatum und kopiere den geheimen Wert, bevor du den Dialog schließt: Er ist nur beim Erstellen verfügbar. Sende ihn als Bearer-Token:
Der Webhook-Signaturschlüssel und das Signatur-Secret im Svix-Portal dienen der Prüfung von Anfragen von telli, nicht der API-Authentifizierung. Unter Entwickler-Einstellungen findest du Informationen zu Ablauf, Reaktivierung und Widerruf.

OpenAPI-Spezifikation

Alle Endpunkte in dieser Referenz werden aus den OpenAPI-Dateien der API generiert. Lade sie herunter, um Client-Bibliotheken zu generieren, die API in Tools wie Postman zu importieren oder Coding-Agents maschinenlesbaren API-Kontext mitzugeben: Kontakt-Endpunkte existieren in beiden Versionen. Nutze V2 für neue Integrationen und sieh dir die Migrationsanleitung an, falls du noch die veralteten V1-Kontakt-Endpunkte verwendest.

Basis-URLs