API REST di Teloz

Dai voce a qualsiasi cosa con il API Teloz

Avvia chiamate, ricevi webhook, trascrizioni dello streaming e incorpora un dialer completo, il tutto tramite un'API REST pulita con SDK per tutte le principali lingue.

API RESTWebhookSpecifiche OpenAPISDKTempo di attività del 99,99%.
200 OK: chiamata in coda
Specifiche OpenAPI 3.0 incluse
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
// }
Dai numeri

Costruito per la produzione fin dal primo giorno

L'API Teloz è la stessa infrastruttura che alimenta migliaia di Stati Uniti sistemi telefonici aziendali ogni giorno.

99.99%
SLA sul tempo di attività dell'API
Affidabilità di livello aziendale
<100ms
Tempo di risposta mediano
In tutte le regioni degli Stati Uniti
50+
Endpoint REST
Chiamate, contatti, numeri e altro
4 SDK
Biblioteche delle lingue ufficiali
Nodo, Python, PHP, Go
Endpoint

Sei gruppi di risorse, oltre 50 endpoint

Tutto ciò di cui hai bisogno per integrare funzionalità vocali, SMS e contact center nel tuo prodotto.

PUBBLICARE · OTTIENI · ELIMINA

Chiamate

Avvia chiamate in uscita, recupera i record delle chiamate, accedi alle registrazioni e trasmetti in streaming trascrizioni in tempo reale.

INVIARE/v1/calls
OTTENERE/v1/calls/:sid
OTTENERE/v1/calls/:sid/recording
ELIMINARE/v1/calls/:sid
PUBBLICARE · RICEVI · METTERE · ELIMINA

Contatti

Crea, leggi, aggiorna ed elimina contatti. Sincronizza con il tuo CRM o crea la tua rubrica personale.

INVIARE/v1/contacts
OTTENERE/v1/contacts
METTERE/v1/contacts/:id
ELIMINARE/v1/contacts/:id
PUBBLICARE · OTTIENI · ELIMINA

Numeri

Cerca i numeri disponibili, fornisci DID locali o gratuiti e gestisci la configurazione dei numeri.

OTTENERE/v1/numbers/available
INVIARE/v1/numbers
OTTENERE/v1/numbers/:id
ELIMINARE/v1/numbers/:id
PUBBLICARE · OTTIENI · ELIMINA

Webhook

Registra gli endpoint per ricevere eventi in tempo reale per chiamate, messaggi vocali, trascrizioni e SMS.

INVIARE/v1/webhooks
OTTENERE/v1/webhooks
METTERE/v1/webhooks/:id
ELIMINARE/v1/webhooks/:id
OTTENERE

Analitica

Ottieni statistiche su volume, durata, disposizione e coda delle chiamate per dashboard e report.

OTTENERE/v1/analytics/calls
OTTENERE/v1/analytics/queues
OTTENERE/v1/analytics/agents
OTTENERE/v1/analytics/summary
SDK JavaScript

Dialer incorporato

Inserisci un widget click-to-call completo in qualsiasi app Web con poche righe di JavaScript.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
Esempi di codici

Integra nella tua lingua preferita

SDK ufficiali per Node.js, Python, PHP e Go oppure chiama il file API REST direttamente da qualsiasi lingua.

Avvia una chiamata
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…
Webhook

Reagisci a ogni evento di chiamata in tempo reale

Registra un URL webhook e Teloz pubblicherà un payload JSON firmato sul tuo endpoint nel momento in cui si verifica un evento, senza bisogno di polling. Combina i webhook con i nostri integrazioni per automatizzare i tuoi flussi di lavoro end-to-end.

Firma HMAC-SHA256 su ogni carico utile
Nuovo tentativo automatico con backoff esponenziale
Registri di consegna e riproduzione nella dashboard
Filtrabile per tipo di evento per endpoint
EventoCategoria
call.initiatedAttivato quando una chiamata in uscita viene accodata
Chiamate
call.ringingIl telefono di destinazione sta squillando
Chiamate
call.answeredLa chiamata è stata accettata: include i metadati del chiamante
Chiamate
call.completedChiamata terminata: include durata e disposizione
Chiamate
call.missedLa chiamata in entrata è rimasta senza risposta
Chiamate
recording.readyL'URL del file di registrazione è disponibile per il download
Registrazione
transcript.readyTesto della trascrizione completa ed etichette dei relatori allegate
AI
voicemail.newNuovo messaggio vocale ricevuto con l'URL audio
Segreteria telefonica
sms.inboundSMS in entrata ricevuti su un numero fornito
sms
Domande frequenti sull'API

Le risposte brevi.

Domande comuni prima di iniziare a costruire.

Registrati per un account Teloz e vai su Impostazioni → Sviluppatore → Chiavi API. Puoi creare più chiavi con autorizzazioni mirate (sola lettura, sola chiamate, amministratore) e revocarle in qualsiasi momento.

SÌ. Le specifiche complete di OpenAPI 3.0 sono disponibili su api.teloz.com/openapi.json e possono essere importate direttamente in Postman, Insomnia o qualsiasi client compatibile. Viene mantenuto sincronizzato con ogni versione.

L'API utilizza l'autenticazione del token Bearer. Passa la tua chiave API nell'intestazione dell'autorizzazione come "Bearer YOUR_API_KEY". Per l'utilizzo da server a server consigliamo chiavi con ambito; per i dialer incorporati nel browser utilizzano token OAuth di breve durata.

Sì, il limite predefinito è 100 richieste al secondo per chiave API. Sono consentiti burst fino a 500 req/s per un massimo di 10 secondi. I piani aziendali possono richiedere limiti più elevati. Le intestazioni del limite di velocità (X-RateLimit-Remaining, X-RateLimit-Reset) vengono restituite ad ogni risposta.

Ogni POST del webhook include un'intestazione X-Teloz-Signature contenente un hash HMAC-SHA256 del corpo della richiesta non elaborata firmato con il segreto del webhook. Calcola lo stesso hash dalla tua parte e confronta: rifiuta le richieste che non corrispondono.

SÌ. Utilizza l'URL di base https://api.sandbox.teloz.com con la chiave API di prova. Le chiamate effettuate in modalità sandbox non vengono mai connesse alla PSTN: simulano l'intero ciclo di vita dell'evento, comprese registrazioni e trascrizioni.

Inizia a costruire con l'API Teloz. Sandbox gratuito incluso.

Ottieni la tua chiave API in meno di due minuti. Prova con il nostro sandbox completo prima di pubblicare il servizio: non è richiesta la carta di credito.

Specifiche OpenAPI complete4 SDK ufficialiAmbiente sandboxSupporto agli sviluppatori statunitensi