Teloz REST-API

Bauen Sie mit dem eine Stimme in alles ein Teloz-API

Initiieren Sie Anrufe, empfangen Sie Webhooks, streamen Sie Transkripte und betten Sie einen voll ausgestatteten Dialer ein – alles über eine saubere REST-API mit SDKs für jede wichtige Sprache.

REST-APIWebhooksOpenAPI-SpezifikationSDKs99,99 % Betriebszeit
200 OK – Anruf in der Warteschlange
OpenAPI 3.0-Spezifikation enthalten
teloz-api.js
// Initiate an outbound call
 
const response = await teloz.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
webhook: "https://your-app.com/events"
});
 
// Response
// {
// sid: "CA3f9a…"
// status: "queued"
// duration: null
// }
Durch die Zahlen

Vom ersten Tag an für die Produktion konzipiert

Die Teloz-API ist dieselbe Infrastruktur, die Tausende von US-amerikanischen Unternehmen antreibt Geschäftstelefonsysteme täglich.

99.99%
API-Verfügbarkeits-SLA
Zuverlässigkeit auf Unternehmensniveau
< 100ms
Mittlere Reaktionszeit
In allen US-Regionen
50+
REST-Endpunkte
Anrufe, Kontakte, Nummern und mehr
4 SDKs
Offizielle Sprachbibliotheken
Node, Python, PHP, Go
Endpunkte

Sechs Ressourcengruppen, über 50 Endpunkte

Alles, was Sie brauchen, um Sprach-, SMS- und Contact-Center-Funktionen in Ihr Produkt zu integrieren.

POST · GET · LÖSCHEN

Anrufe

Initiieren Sie ausgehende Anrufe, rufen Sie Anrufaufzeichnungen ab, greifen Sie auf Aufzeichnungen zu und streamen Sie Transkripte in Echtzeit.

POST/v1/calls
ERHALTEN/v1/calls/:sid
ERHALTEN/v1/calls/:sid/recording
LÖSCHEN/v1/calls/:sid
POST · GET · PUT · DELETE

Kontakte

Kontakte erstellen, lesen, aktualisieren und löschen. Synchronisieren Sie mit Ihrem CRM oder erstellen Sie Ihr eigenes Telefonbuch.

POST/v1/contacts
ERHALTEN/v1/contacts
SETZEN/v1/contacts/:id
LÖSCHEN/v1/contacts/:id
POST · GET · LÖSCHEN

Zahlen

Suchen Sie nach verfügbaren Nummern, stellen Sie lokale oder gebührenfreie DIDs bereit und verwalten Sie die Nummernkonfiguration.

ERHALTEN/v1/numbers/available
POST/v1/numbers
ERHALTEN/v1/numbers/:id
LÖSCHEN/v1/numbers/:id
POST · GET · LÖSCHEN

Webhooks

Registrieren Sie Endpunkte, um Echtzeitereignisse für Anrufe, Voicemails, Transkripte und SMS zu empfangen.

POST/v1/webhooks
ERHALTEN/v1/webhooks
SETZEN/v1/webhooks/:id
LÖSCHEN/v1/webhooks/:id
ERHALTEN

Analytik

Rufen Sie Anrufvolumen, Dauer, Disposition und Warteschlangenstatistiken für Ihre Dashboards und Berichte ab.

ERHALTEN/v1/analytics/calls
ERHALTEN/v1/analytics/queues
ERHALTEN/v1/analytics/agents
ERHALTEN/v1/analytics/summary
JavaScript-SDK

Eingebetteter Dialer

Fügen Sie mit ein paar Zeilen JavaScript ein voll funktionsfähiges Click-to-Call-Widget in jede Web-App ein.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
Codebeispiele

Integrieren Sie in der Sprache Ihrer Wahl

Offizielle SDKs für Node.js, Python, PHP und Go – oder rufen Sie das an REST-API direkt aus einer beliebigen Sprache.

Einen Anruf einleiten
import Teloz from "@teloz/node";
 
const client = new Teloz(process.env.TELOZ_API_KEY);
 
const call = await client.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
transcribe: true,
webhook: "https://your-app.com/events",
});
 
console.log(call.sid); // CA3f9a7b…
Webhooks

Reagieren Sie auf jedes Anrufereignis in Echtzeit

Registrieren Sie eine Webhook-URL und Teloz sendet eine signierte JSON-Nutzlast an Ihren Endpunkt, sobald ein Ereignis auftritt – keine Abfrage erforderlich. Kombinieren Sie Webhooks mit unseren Integrationen um Ihre Arbeitsabläufe durchgängig zu automatisieren.

HMAC-SHA256-Signatur auf jeder Nutzlast
Automatischer Wiederholungsversuch mit exponentiellem Backoff
Lieferprotokolle und Wiedergabe im Dashboard
Filterbar nach Ereignistyp pro Endpunkt
EreignisKategorie
call.initiatedWird ausgelöst, wenn ein ausgehender Anruf in der Warteschlange steht
Anrufe
call.ringingDas Zieltelefon klingelt
Anrufe
call.answeredAnruf wurde entgegengenommen – einschließlich Anrufermetadaten
Anrufe
call.completedAnruf beendet – einschließlich Dauer und Disposition
Anrufe
call.missedEingehender Anruf blieb unbeantwortet
Anrufe
recording.readyDie URL der Aufnahmedatei steht zum Download zur Verfügung
Aufnahme
transcript.readyVollständiger Transkripttext und Sprecherbezeichnungen beigefügt
KI
voicemail.newNeue Voicemail mit Audio-URL erhalten
Voicemail
sms.inboundEingehende SMS, die auf einer bereitgestellten Nummer empfangen wurde
SMS
API-FAQs

Die kurzen Antworten.

Häufige Fragen, bevor Sie mit dem Bau beginnen.

Registrieren Sie sich für ein Teloz-Konto und navigieren Sie zu Einstellungen → Entwickler → API-Schlüssel. Sie können mehrere Schlüssel mit eingeschränkten Berechtigungen (schreibgeschützt, nur Anrufe, Administrator) erstellen und diese jederzeit widerrufen.

Ja. Die vollständige OpenAPI 3.0-Spezifikation ist unter api.teloz.com/openapi.json verfügbar und kann direkt in Postman, Insomnia oder einen anderen kompatiblen Client importiert werden. Es wird mit jeder Veröffentlichung synchronisiert.

Die API verwendet die Bearer-Token-Authentifizierung. Übergeben Sie Ihren API-Schlüssel im Authorization-Header als „Bearer YOUR_API_KEY“. Für die Server-zu-Server-Nutzung empfehlen wir Schlüssel mit Gültigkeitsbereich. Verwenden Sie für im Browser eingebettete Dialer kurzlebige OAuth-Token.

Ja – das Standardlimit beträgt 100 Anfragen pro Sekunde und API-Schlüssel. Bursts mit bis zu 500 req/s sind für bis zu 10 Sekunden zulässig. Unternehmenspläne können höhere Limits verlangen. Ratenlimit-Header (X-RateLimit-Remaining, X-RateLimit-Reset) werden bei jeder Antwort zurückgegeben.

Jeder Webhook-POST enthält einen X-Teloz-Signature-Header, der einen HMAC-SHA256-Hash des rohen Anforderungstexts enthält, der mit Ihrem Webhook-Geheimnis signiert ist. Berechnen Sie auf Ihrer Seite denselben Hash und vergleichen Sie ihn – lehnen Sie Anfragen ab, die nicht übereinstimmen.

Ja. Verwenden Sie die Basis-URL https://api.sandbox.teloz.com mit Ihrem Test-API-Schlüssel. Im Sandbox-Modus getätigte Anrufe werden nie mit dem PSTN verbunden – sie simulieren den gesamten Ereignislebenszyklus, einschließlich Aufzeichnungen und Transkripten.

Beginnen Sie mit der Entwicklung mit der Teloz-API. Kostenlose Sandbox inklusive.

Erhalten Sie Ihren API-Schlüssel in weniger als zwei Minuten. Testen Sie es mit unserer voll ausgestatteten Sandbox, bevor Sie es in Betrieb nehmen – keine Kreditkarte erforderlich.

Vollständige OpenAPI-Spezifikation4 offizielle SDKsSandbox-UmgebungUS-Entwicklerunterstützung