Teloz REST-API

Bouw overal een stem in met de Teloz-API

Start oproepen, ontvang webhooks, stream transcripties en sluit een volledig functionele dialer in – allemaal via een overzichtelijke REST API met SDK's voor elke belangrijke taal.

REST-APIWebhakenOpenAPI-specificatieSDK's99,99% uptime
200 OK — oproep in wachtrij
OpenAPI 3.0-specificatie inbegrepen
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
// }
Door de cijfers

Gebouwd voor productie vanaf dag één

De Teloz API is dezelfde infrastructuur die duizenden Amerikaanse bedrijven aandrijft zakelijke telefoonsystemen elke dag.

99.99%
SLA voor API-uptime
Betrouwbaarheid op ondernemingsniveau
< 100 ms
Gemiddelde responstijd
In alle Amerikaanse regio's
50+
REST-eindpunten
Oproepen, contacten, nummers en meer
4 SDK's
Officiële taalbibliotheken
Knooppunt, Python, PHP, Go
Eindpunten

Zes resourcegroepen, meer dan 50 eindpunten

Alles wat u nodig heeft om spraak-, sms- en contactcenterfuncties in uw product in te bouwen.

POST · KRIJGEN · VERWIJDEREN

Oproepen

Start uitgaande oproepen, haal oproeprecords op, krijg toegang tot opnames en stream realtime transcripties.

NA/v1/calls
KRIJGEN/v1/calls/:sid
KRIJGEN/v1/calls/:sid/recording
VERWIJDEREN/v1/calls/:sid
POST · KRIJGEN · PUT · VERWIJDEREN

Contacten

Contacten maken, lezen, bijwerken en verwijderen. Synchroniseer met uw CRM of bouw uw eigen telefoonboek.

NA/v1/contacts
KRIJGEN/v1/contacts
NEERZETTEN/v1/contacts/:id
VERWIJDEREN/v1/contacts/:id
POST · KRIJGEN · VERWIJDEREN

Nummers

Zoek beschikbare nummers, richt lokale of gratis doorkiesnummers in en beheer de nummerconfiguratie.

KRIJGEN/v1/numbers/available
NA/v1/numbers
KRIJGEN/v1/numbers/:id
VERWIJDEREN/v1/numbers/:id
POST · KRIJGEN · VERWIJDEREN

Webhaken

Registreer eindpunten om realtime gebeurtenissen voor oproepen, voicemails, transcripties en sms-berichten te ontvangen.

NA/v1/webhooks
KRIJGEN/v1/webhooks
NEERZETTEN/v1/webhooks/:id
VERWIJDEREN/v1/webhooks/:id
KRIJGEN

Analyses

Bekijk de gespreksvolume-, duur-, dispositie- en wachtrijstatistieken voor uw dashboards en rapporten.

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

Ingebouwde kiezer

Plaats een complete click-to-call-widget in elke web-app met een paar regels JavaScript.

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

Integreer in de taal van uw keuze

Officiële SDK's voor Node.js, Python, PHP en Go - of bel de REST-API rechtstreeks vanuit elke taal.

Start een oproep
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…
Webhaken

Reageer op elke oproepgebeurtenis in realtime

Registreer een webhook-URL en Teloz zal een ondertekende JSON-payload naar uw eindpunt POSTen zodra er een gebeurtenis plaatsvindt – geen polling vereist. Combineer webhooks met onze integraties om uw workflows end-to-end te automatiseren.

HMAC-SHA256-handtekening op elke lading
Automatische nieuwe poging met exponentiële uitstel
Leveringslogboeken en herhaling in het dashboard
Filterbaar op gebeurtenistype per eindpunt
EvenementCategorie
call.initiatedWordt geactiveerd wanneer een uitgaand gesprek in de wachtrij staat
Oproepen
call.ringingDe bestemmingstelefoon gaat over
Oproepen
call.answeredOproep is aangenomen: bevat metagegevens van de beller
Oproepen
call.completedGesprek beëindigd — inclusief duur en dispositie
Oproepen
call.missedInkomende oproep bleef onbeantwoord
Oproepen
recording.readyDe URL van het opnamebestand kan worden gedownload
Opname
transcript.readyVolledige transcriptietekst en sprekerlabels bijgevoegd
AI
voicemail.newNieuwe voicemail ontvangen met audio-URL
Voicemail
sms.inboundInkomende sms ontvangen op een ingericht nummer
Sms
Veelgestelde vragen over API's

De korte antwoorden.

Veelgestelde vragen voordat u begint met bouwen.

Meld u aan voor een Teloz-account en navigeer naar Instellingen → Ontwikkelaar → API-sleutels. U kunt meerdere sleutels maken met bepaalde machtigingen (alleen-lezen, alleen bellen, beheerder) en deze op elk gewenst moment intrekken.

Ja. De volledige OpenAPI 3.0-specificatie is beschikbaar op api.teloz.com/openapi.json en kan rechtstreeks in Postman, Insomnia of een andere compatibele client worden geïmporteerd. Het wordt bij elke release gesynchroniseerd.

De API maakt gebruik van Bearer-tokenverificatie. Geef uw API-sleutel in de Autorisatie-header door als 'Bearer YOUR_API_KEY'. Voor server-naar-server-gebruik raden we scoped-sleutels aan; gebruik voor in de browser ingebedde dialers OAuth-tokens met een korte levensduur.

Ja: de standaardlimiet is 100 verzoeken per seconde per API-sleutel. Uitbarstingen tot 500 req/s zijn toegestaan ​​gedurende maximaal 10 seconden. Enterprise-abonnementen kunnen hogere limieten aanvragen. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) worden bij elk antwoord geretourneerd.

Elke webhook-POST bevat een X-Teloz-Signature-header met een HMAC-SHA256-hash van de onbewerkte aanvraagtekst, ondertekend met uw webhookgeheim. Bereken dezelfde hash aan uw kant en vergelijk – wijs verzoeken af ​​die niet overeenkomen.

Ja. Gebruik de basis-URL https://api.sandbox.teloz.com met uw test-API-sleutel. Oproepen in de sandbox-modus worden nooit verbonden met het PSTN; ze simuleren de volledige levenscyclus van gebeurtenissen, inclusief opnames en transcripties.

Begin met bouwen met de Teloz API. Gratis zandbak inbegrepen.

Ontvang uw API-sleutel in minder dan twee minuten. Test met onze complete sandbox voordat u live gaat: geen creditcard vereist.

Volledige OpenAPI-specificatie4 officiële SDK'sSandbox-omgevingOndersteuning voor Amerikaanse ontwikkelaars