Teloz REST API

Bygg in röst i vad som helst med Teloz API

Initiera samtal, ta emot webhooks, streama transkriptioner och bädda in en fullfjädrad uppringare – allt genom ett rent REST API med SDK:er för alla större språk.

Starta en gratis provperiodDokumentationsnav
REST APIWebhooksOpenAPI SpecSDK:er99,99 % drifttid
200 OK — samtal i kö
OpenAPI 3.0 spec ingår
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
// }
Efter siffrorna

Byggd för produktion från dag ett

Teloz API är samma infrastruktur som driver tusentals USA företagstelefonsystem varje dag.

99.99%
API upptid SLA
Tillförlitlighet i företagsklass
< 100 ms
Mediansvarstid
I alla regioner i USA
50+
REST-slutpunkter
Samtal, kontakter, nummer och mer
4 SDK:er
Officiella språkbibliotek
Node, Python, PHP, Go
Slutpunkter

Sex resursgrupper, 50+ endpoints

Allt du behöver för att bygga in röst-, SMS- och kontaktcenterfunktioner i din produkt.

LÄGGA PÅ · HÄMTA · DELETE

Samtal

Initiera utgående samtal, hämta samtalsregister, få tillgång till inspelningar och streama avskrifter i realtid.

POSTA/v1/calls
FÅ/v1/calls/:sid
FÅ/v1/calls/:sid/recording
RADERA/v1/calls/:sid
LÄGGA PÅ · HÄMTA · SÄTT · RADERA

Kontakter

Skapa, läs, uppdatera och ta bort kontakter. Synkronisera med ditt CRM eller bygg din egen telefonbok.

POSTA/v1/contacts
FÅ/v1/contacts
SÄTTA/v1/contacts/:id
RADERA/v1/contacts/:id
LÄGGA PÅ · HÄMTA · DELETE

Tal

Sök efter tillgängliga nummer, tillhandahåll lokala eller avgiftsfria DID:er och hantera nummerkonfiguration.

FÅ/v1/numbers/available
POSTA/v1/numbers
FÅ/v1/numbers/:id
RADERA/v1/numbers/:id
LÄGGA PÅ · HÄMTA · DELETE

Webhooks

Registrera slutpunkter för att ta emot händelser i realtid för samtal, röstmeddelanden, utskrifter och SMS.

POSTA/v1/webhooks
FÅ/v1/webhooks
SÄTTA/v1/webhooks/:id
RADERA/v1/webhooks/:id
FÅ

Analytics

Ta fram samtalsvolym, varaktighet, disposition och köstatistik för dina instrumentpaneler och rapporter.

FÅ/v1/analytics/calls
FÅ/v1/analytics/queues
FÅ/v1/analytics/agents
FÅ/v1/analytics/summary
JavaScript SDK

Inbäddad dialer

Släpp en fullfjädrad klicka för att ringa-widget i vilken webbapp som helst med några rader JavaScript.

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

Integrera på ditt val av språk

Officiella SDK:er för Node.js, Python, PHP och Go - eller ring REST API direkt från vilket språk som helst.

Initiera ett samtal
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

Reagera på varje samtalshändelse i realtid

Registrera en webhook-URL och Teloz POSTAR en signerad JSON-nyttolast till din slutpunkt i samma ögonblick som en händelse inträffar – ingen polling krävs. Kombinera webhooks med vår integrationer för att automatisera dina arbetsflöden från början till slut.

HMAC-SHA256-signatur på varje nyttolast
Automatiskt återförsök med exponentiell backoff
Leveransloggar & repris i instrumentpanelen
Filtrera efter händelsetyp per slutpunkt
HändelseKategori
call.initiatedUtlöses när ett utgående samtal står i kö
Samtal
call.ringingMåltelefonen ringer
Samtal
call.answeredSamtalet togs upp — inkluderar metadata för uppringaren
Samtal
call.completedSamtal avslutat — inkluderar varaktighet, disposition
Samtal
call.missedInkommande samtal blev obesvarat
Samtal
recording.readyInspelningsfilens URL är tillgänglig för nedladdning
Inspelning
transcript.readyFullständig transkriptionstext och högtalaretiketter bifogas
AI
voicemail.newNytt röstmeddelande mottaget med ljud-URL
Röstbrevlåda
sms.inboundInkommande SMS mottaget på ett tillhandahållet nummer
SMS
Vanliga frågor om API

De korta svaren.

Vanliga frågor innan du börjar bygga.

Registrera dig för ett Teloz-konto och navigera till Inställningar → Utvecklare → API-nycklar. Du kan skapa flera nycklar med omfångade behörigheter (skrivskyddad, samtalsskyddad, admin) och återkalla dem när som helst.

Ja. Den fullständiga OpenAPI 3.0-specifikationen finns tillgänglig på api.teloz.com/openapi.json och kan importeras direkt till Postman, Insomnia eller någon kompatibel klient. Den hålls synkroniserad med varje release.

API:et använder Bearer-token-autentisering. Skicka din API-nyckel i auktoriseringshuvudet som 'Bärare YOUR_API_KEY'. För server-till-server-användning rekommenderar vi scoped-nycklar; för webbläsarinbäddade uppringare använd OAuth kortlivade tokens.

Ja — standardgränsen är 100 förfrågningar per sekund per API-nyckel. Bursts upp till 500 req/s tillåts i upp till 10 sekunder. Företagsplaner kan begära högre gränser. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) returneras vid varje svar.

Varje webhook-POST innehåller en X-Teloz-Signature-rubrik som innehåller en HMAC-SHA256-hash av råbegäran undertecknad med din webhook-hemlighet. Beräkna samma hash på din sida och jämför – avvisa förfrågningar som inte matchar.

Ja. Använd basadressen https://api.sandbox.teloz.com med din test-API-nyckel. Samtal som görs i sandlådeläge kopplas aldrig till PSTN – de simulerar hela händelselivscykeln inklusive inspelningar och utskrifter.

Börja bygga med Teloz API. Gratis sandlåda ingår.

Få din API-nyckel på mindre än två minuter. Testa med vår fullfjädrade sandlåda innan du går live – inget kreditkort krävs.

Hämta API-nyckelVisa dokument
Fullständig OpenAPI-specifikation4 officiella SDK:erSandlådemiljöUSA:s utvecklarstöd