API REST Teloz

Dê voz a qualquer coisa com o API Teloz

Inicie chamadas, receba webhooks, transmita transcrições e incorpore um discador completo, tudo por meio de uma API REST limpa com SDKs para todas as principais linguagens.

API RESTWebhooksEspecificação OpenAPISDKs99,99% de tempo de atividade
200 OK – chamada em fila
Especificação OpenAPI 3.0 incluída
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
// }
Pelos Números

Construído para produção desde o primeiro dia

A API Teloz é a mesma infraestrutura que alimenta milhares de usuários dos EUA sistemas telefônicos empresariais diariamente.

99.99%
SLA de tempo de atividade da API
Confiabilidade de nível empresarial
<100ms
Tempo médio de resposta
Em todas as regiões dos EUA
50+
Pontos de extremidade REST
Chamadas, contatos, números e muito mais
4 SDKs
Bibliotecas de línguas oficiais
Nó, Python, PHP, Go
Pontos finais

Seis grupos de recursos, mais de 50 endpoints

Tudo o que você precisa para incorporar recursos de voz, SMS e contact center ao seu produto.

POSTAR · OBTER · EXCLUIR

Chamadas

Inicie chamadas, recupere registros de chamadas, acesse gravações e transmita transcrições em tempo real.

PUBLICAR/v1/calls
PEGAR/v1/calls/:sid
PEGAR/v1/calls/:sid/recording
EXCLUIR/v1/calls/:sid
POSTAR · OBTER · COLOCAR · DELETAR

Contatos

Crie, leia, atualize e exclua contatos. Sincronize com seu CRM ou crie sua própria agenda telefônica.

PUBLICAR/v1/contacts
PEGAR/v1/contacts
COLOCAR/v1/contacts/:id
EXCLUIR/v1/contacts/:id
POSTAR · OBTER · EXCLUIR

Números

Pesquise números disponíveis, forneça DIDs locais ou gratuitos e gerencie a configuração de números.

PEGAR/v1/numbers/available
PUBLICAR/v1/numbers
PEGAR/v1/numbers/:id
EXCLUIR/v1/numbers/:id
POSTAR · OBTER · EXCLUIR

Webhooks

Registre endpoints para receber eventos em tempo real para chamadas, correios de voz, transcrições e SMS.

PUBLICAR/v1/webhooks
PEGAR/v1/webhooks
COLOCAR/v1/webhooks/:id
EXCLUIR/v1/webhooks/:id
PEGAR

Análise

Extraia estatísticas de volume, duração, disposição e fila de chamadas para seus painéis e relatórios.

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

Discador incorporado

Coloque um widget clique para ligar completo em qualquer aplicativo da web com algumas linhas de JavaScript.

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

Integre no idioma de sua escolha

SDKs oficiais para Node.js, Python, PHP e Go — ou ligue para API REST diretamente de qualquer idioma.

Iniciar uma chamada
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

Reaja a todos os eventos de chamada em tempo real

Registre um URL de webhook e o Teloz POSTARÁ uma carga JSON assinada em seu endpoint no momento em que um evento ocorrer - sem necessidade de pesquisa. Combine webhooks com nossos integrações para automatizar seus fluxos de trabalho de ponta a ponta.

Assinatura HMAC-SHA256 em cada carga útil
Nova tentativa automática com espera exponencial
Registros de entrega e reprodução no painel
Filtrável por tipo de evento por endpoint
EventoCategoria
call.initiatedDisparado quando uma chamada de saída está na fila
Chamadas
call.ringingO telefone de destino está tocando
Chamadas
call.answeredA chamada foi atendida — inclui metadados do chamador
Chamadas
call.completedChamada encerrada - inclui duração, disposição
Chamadas
call.missedA chamada recebida não foi atendida
Chamadas
recording.readyO URL do arquivo de gravação está disponível para download
Gravação
transcript.readyTexto da transcrição completa e etiquetas dos alto-falantes anexadas
IA
voicemail.newNovo correio de voz recebido com URL de áudio
Correio de voz
sms.inboundSMS de entrada recebido em um número provisionado
SMS
Perguntas frequentes sobre APIs

As respostas curtas.

Perguntas comuns antes de começar a construir.

Cadastre-se para uma conta Teloz e navegue até Configurações → Desenvolvedor → Chaves de API. Você pode criar várias chaves com permissões de escopo (somente leitura, somente chamadas, administrador) e revogá-las a qualquer momento.

Sim. A especificação completa do OpenAPI 3.0 está disponível em api.teloz.com/openapi.json e pode ser importada diretamente para Postman, Insomnia ou qualquer cliente compatível. Ele é mantido sincronizado com cada lançamento.

A API usa autenticação de token de portador. Passe sua chave API no cabeçalho de autorização como 'Bearer YOUR_API_KEY'. Para uso servidor a servidor, recomendamos chaves com escopo definido; para discadores incorporados ao navegador, use tokens de curta duração OAuth.

Sim — o limite padrão é de 100 solicitações por segundo por chave de API. Bursts de até 500 req/s são permitidos por até 10 segundos. Os planos empresariais podem solicitar limites mais elevados. Os cabeçalhos de limite de taxa (X-RateLimit-Remaining, X-RateLimit-Reset) são retornados em cada resposta.

Cada webhook POST inclui um cabeçalho X-Teloz-Signature contendo um hash HMAC-SHA256 do corpo da solicitação bruta assinado com seu segredo do webhook. Calcule o mesmo hash e compare - rejeite solicitações que não correspondam.

Sim. Use o URL base https://api.sandbox.teloz.com com sua chave de API de teste. As chamadas feitas no modo sandbox nunca são conectadas à PSTN — elas simulam o ciclo de vida completo do evento, incluindo gravações e transcrições.

Comece a construir com a API Teloz. Caixa de areia gratuita incluída.

Obtenha sua chave API em menos de dois minutos. Teste com nosso sandbox completo antes de entrar no ar – não é necessário cartão de crédito.

Especificação completa do OpenAPI4 SDKs oficiaisAmbiente sandboxSuporte ao desenvolvedor dos EUA