Telofy
Jetzt starten

Die Telofy-Schnittstelle: Ihre Software liest mit.

Anrufe, Anliegen und Termine per API-Schlüssel abholen, in jedem Tarif. Ab Business stößt Ihr System auch ausgehende Anrufe an.

KI-Mitarbeiter erstellenAlle Integrationen
Eigene ÜbersichtZeigen Sie Anrufe und Anliegen in dem Dashboard, das Ihr Team ohnehin offen hat.
Termine übernehmenNeue Termine landen in Ihrer Branchensoftware oder Ihrer Tabelle, ohne dass jemand abtippt.
Anruf aus Ihrem SystemIhr System stößt einen Rückruf an, etwa wenn ein Auftrag fertig ist (ab Business).

In vier Schritten zur ersten Abfrage

Sie brauchen dafür nur das Portal und ein Programm, das Webadressen aufrufen kann.

1.Schlüssel erstellenIm Portal unter Integrationen > API-Schlüssel auf „Schlüssel erstellen“ klicken und einen Namen vergeben. Der Schlüssel beginnt mit tlfy_ und erscheint nur einmal. Kopieren Sie ihn sofort an einen sicheren Ort.
2.Testabfrage sendenRufen Sie https://api.telofy.app/api/v1/calls?limit=2 auf und senden Sie den Schlüssel im Kopf Authorization: Bearer tlfy_… mit. Kommt eine Liste zurück, steht die Verbindung.
3.Seiten durchblätternAlle Listen liefern die neuesten Einträge zuerst. Mit page und limit (höchstens 100) holen Sie weitere Seiten. Filter gibt es nicht; filtern Sie in Ihrem Programm.
4.Fehler einplanenBei 401 stimmt der Schlüssel nicht, bei 429 waren es mehr als 60 Anfragen in der Minute. Legen Sie nach einer 429-Antwort eine kurze Pause ein.

Beispiel: neue Termine abholen

const antwort = await fetch("https://api.telofy.app/api/v1/appointments?limit=100", {
  headers: { Authorization: "Bearer " + process.env.TELOFY_SCHLUESSEL }
});
const { appointments } = await antwort.json();
for (const termin of appointments) {
  console.log(termin.createdAt, termin.structuredData, termin.callSummary);
}

Die Felder in structuredData hängen von der Art des Anliegens ab. Prüfen Sie im Programm, ob ein Feld vorhanden ist, bevor Sie es lesen.

Statt ständig abzufragen

Wenn Sie nicht alle paar Minuten nachsehen wollen, ob etwas Neues da ist, legen Sie zusätzlich einen Webhook an. Telofy meldet Ihnen dann jeden ausgewerteten Anruf von selbst. Die Schnittstelle bleibt für Nachholen und Abgleich.

Gut zu wissen

  • Der Schlüssel liest und kann ab Business Anrufe auslösen. Es gibt keine Berechtigungsstufen je Schlüssel.
  • Die Schnittstelle ist für Server gebaut. Rufen Sie sie nicht aus einer Webseite im Browser auf, denn der Schlüssel wäre dort für alle sichtbar.
  • Schreibend ist nur der ausgehende Anruf. Termine, Kontakte und Katalog pflegen Sie im Portal oder per Import.

Alle Felder, Fehlercodes und Beispiele stehen auf der Seite Telofy für Entwickler.

Häufige Fragen dazu.

Kostet die Schnittstelle extra?

Nein. Lesender Zugriff und Webhooks sind in jedem Tarif enthalten. Ausgehende Anrufe per Schnittstelle gibt es ab dem Tarif Business; sie zählen wie alle Gesprächsminuten.

Wie viele Anfragen sind erlaubt?

60 pro Minute und Schlüssel, zusammengezählt über alle Endpunkte und MCP. Danach antwortet Telofy bis zum Ende der Minute mit Status 429.

Gibt es eine OpenAPI-Datei oder ein SDK?

Nein. Die Referenz auf der Entwicklerseite beschreibt alle Endpunkte mit Beispielen; sie gibt es auch als Markdown unter /entwickler.md.

Hören Sie ihn, bevor Sie sich entscheiden.

Ein Klick, kein Formular, keine Anmeldung.

KI-Mitarbeiter erstellenPreise ansehen