API REST de Teloz

Incorpore voz a cualquier cosa con el API Teloz

Inicie llamadas, reciba webhooks, transmita transcripciones e incorpore un marcador con todas las funciones, todo a través de una API REST limpia con SDK para todos los idiomas principales.

API DESCANSOGanchos webEspecificaciones de OpenAPISDK99,99 % de tiempo de actividad
200 OK: llamada en cola
Especificaciones OpenAPI 3.0 incluidas
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
// }
En números

Diseñado para la producción desde el primer día

La API de Teloz es la misma infraestructura que impulsa a miles de usuarios de EE. UU. sistemas telefónicos empresariales cada día.

99.99%
SLA de tiempo de actividad de API
Fiabilidad de nivel empresarial
< 100 ms
Tiempo medio de respuesta
En todas las regiones de EE. UU.
50+
Puntos finales de descanso
Llamadas, contactos, números y más
4 SDK
Bibliotecas oficiales de idiomas
Nodo, Python, PHP, Ir
Puntos finales

Seis grupos de recursos, más de 50 puntos finales

Todo lo que necesita para incorporar funciones de voz, SMS y centro de contacto en su producto.

PUBLICAR · OBTENER · BORRAR

llamadas

Inicie llamadas salientes, recupere registros de llamadas, acceda a grabaciones y transmita transcripciones en tiempo real.

CORREO/v1/calls
CONSEGUIR/v1/calls/:sid
CONSEGUIR/v1/calls/:sid/recording
BORRAR/v1/calls/:sid
PUBLICAR · OBTENER · PONER · BORRAR

Contactos

Crear, leer, actualizar y eliminar contactos. Sincroniza con tu CRM o crea tu propia agenda.

CORREO/v1/contacts
CONSEGUIR/v1/contacts
PONER/v1/contacts/:id
BORRAR/v1/contacts/:id
PUBLICAR · OBTENER · BORRAR

Números

Busque números disponibles, proporcione DID locales o gratuitos y administre la configuración de números.

CONSEGUIR/v1/numbers/available
CORREO/v1/numbers
CONSEGUIR/v1/numbers/:id
BORRAR/v1/numbers/:id
PUBLICAR · OBTENER · BORRAR

Ganchos web

Registre puntos finales para recibir eventos en tiempo real para llamadas, mensajes de voz, transcripciones y SMS.

CORREO/v1/webhooks
CONSEGUIR/v1/webhooks
PONER/v1/webhooks/:id
BORRAR/v1/webhooks/:id
CONSEGUIR

Analítica

Obtenga estadísticas de volumen, duración, disposición y cola de llamadas para sus paneles e informes.

CONSEGUIR/v1/analytics/calls
CONSEGUIR/v1/analytics/queues
CONSEGUIR/v1/analytics/agents
CONSEGUIR/v1/analytics/summary
SDK de JavaScript

Marcador integrado

Inserte un widget de clic para llamar con todas las funciones en cualquier aplicación web con unas pocas líneas de JavaScript.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
Ejemplos de código

Integre en el idioma de su elección

SDK oficiales para Node.js, Python, PHP y Go, o llame al API DESCANSO directamente desde cualquier idioma.

iniciar una llamada
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…
Ganchos web

Reaccionar a cada evento de llamada en tiempo real

Registre una URL de webhook y Teloz PUBLICARÁ una carga útil JSON firmada en su punto final en el momento en que ocurra un evento, sin necesidad de sondeo. Combine webhooks con nuestros integraciones para automatizar sus flujos de trabajo de un extremo a otro.

Firma HMAC-SHA256 en cada carga útil
Reintento automático con retroceso exponencial
Registros de entrega y reproducción en el panel
Filtrable por tipo de evento por punto final
EventoCategoría
call.initiatedSe activa cuando una llamada saliente está en cola
llamadas
call.ringingEl teléfono de destino está sonando
llamadas
call.answeredLa llamada fue atendida: incluye metadatos de la persona que llama
llamadas
call.completedLlamada finalizada: incluye duración y disposición
llamadas
call.missedLa llamada entrante no fue respondida
llamadas
recording.readyLa URL del archivo de grabación está disponible para descargar
Grabación
transcript.readyTexto completo de la transcripción y etiquetas de los oradores adjuntas.
AI
voicemail.newNuevo mensaje de voz recibido con URL de audio
Correo de voz
sms.inboundSMS entrantes recibidos en un número aprovisionado
SMS
Preguntas frecuentes sobre API

Las respuestas cortas.

Preguntas comunes antes de empezar a construir.

Regístrese para obtener una cuenta de Teloz y navegue hasta Configuración → Desarrollador → Claves API. Puede crear varias claves con permisos específicos (solo lectura, solo llamadas, administrador) y revocarlas en cualquier momento.

Sí. La especificación completa de OpenAPI 3.0 está disponible en api.teloz.com/openapi.json y se puede importar directamente a Postman, Insomnia o cualquier cliente compatible. Se mantiene sincronizado con cada lanzamiento.

La API utiliza autenticación de token de portador. Pase su clave API en el encabezado de Autorización como 'Portador YOUR_API_KEY'. Para uso de servidor a servidor, recomendamos claves de ámbito; para los marcadores integrados en el navegador, utilice tokens de corta duración de OAuth.

Sí, el límite predeterminado es 100 solicitudes por segundo por clave API. Se permiten ráfagas de hasta 500 solicitudes/s durante un máximo de 10 segundos. Los planes empresariales pueden solicitar límites más altos. Los encabezados de límite de velocidad (X-RateLimit-Remaining, X-RateLimit-Reset) se devuelven en cada respuesta.

Cada POST de webhook incluye un encabezado X-Teloz-Signature que contiene un hash HMAC-SHA256 del cuerpo de la solicitud sin formato firmado con su secreto de webhook. Calcule el mismo hash por su parte y compare: rechace las solicitudes que no coincidan.

Sí. Utilice la URL base https://api.sandbox.teloz.com con su clave API de prueba. Las llamadas realizadas en modo sandbox nunca se conectan a la PSTN: simulan el ciclo de vida completo del evento, incluidas grabaciones y transcripciones.

Comience a construir con la API de Teloz. Caja de arena gratuita incluida.

Obtenga su clave API en menos de dos minutos. Pruebe con nuestra zona de pruebas con todas las funciones antes de publicarla, no se requiere tarjeta de crédito.

Especificaciones completas de OpenAPI4 SDK oficialesEntorno de caja de arenaSoporte para desarrolladores de EE. UU.