Uma API para chamadas, SMS e IA – construído para equipes modernas.
A API REST do Ringflow oferece controle programático sobre cada parte de sua pilha de comunicações – chamadas de saída, SMS em massa, gravações de canal duplo, agentes recepcionistas de IA e webhooks de eventos em tempo real – tudo por trás de um único endpoint autenticado.
curl -X POST https://api.ringflow.com/v2/calls \
-H "Authorization: Bearer $RINGFLOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+14155550199",
"from": "+19172544289",
"recordDualChannel": true,
"aiReceptionistId": "agent_rfw_support"
}'
# 201 Created
{
"id": "call_rfw_2Kj8mNpQ",
"status": "ringing",
"to": "+14155550199",
"recording": true,
"ai": true
}Tudo que você precisa, nada que você não precise.
Seis grupos de recursos, uma URL base, um esquema de autenticação. Cada endpoint é versionado, retorna JSON consistente e é fornecido com exemplos de solicitação/resposta no arquivo referência completa.
- POST/v2/calls— Faça chamadas para qualquer número
- GET/v2/calls/:id— Obtenha status ao vivo, duração e gravação
- POST/v2/calls/:id/transfer— Transferência quente ou fria no meio da chamada
- DELETE/v2/calls/:id— Encerre uma chamada ativa imediatamente
- POST/v2/messages— Envie SMS ou MMS para um único destinatário
- POST/v2/messages/bulk— Agrupe até 1.000 mensagens por solicitação
- GET/v2/messages/:id— Pesquisar status de entrega e recibo da transportadora
- POST/v2/calls/:id/record— Inicie a gravação de chamadas de canal duplo
- DELETE/v2/calls/:id/record— Pare a gravação e acione o armazenamento
- POST/v2/recordings/:id/transcribe— Solicitar transcrição assíncrona de IA
- POST/v2/ai/agents— Provisionar uma nova recepcionista de IA
- PUT/v2/ai/agents/:id/knowledge— Push FAQs, documentos e regras de escalonamento
- GET/v2/ai/sessions/:id/summary— Recuperar resumo de IA pós-chamada
- POST/v2/events/subscriptions— Inscreva-se em qualquer evento da plataforma
- GET/v2/events/subscriptions— Liste e filtre suas assinaturas
- DELETE/v2/events/subscriptions/:id— Remover uma assinatura de evento
- POST/v2/auth/tokens— Emitir token ao portador de curta duração
- POST/v2/auth/keys— Criar chave de API do espaço de trabalho com escopo
- PUT/v2/auth/keys/:id/rotate— Rotação de chaves com tempo de inatividade zero
Clientes idiomáticos para sua pilha.
Cada SDK Ringflow é criado com base no código – não gerado a partir de uma especificação. Novas tentativas, cursores de paginação e verificação de webhook são de primeira classe, não reflexões posteriores.
import { Ringflow } from "@ringflow/sdk"
const client = new Ringflow({
apiKey: process.env.RINGFLOW_API_KEY,
region: "us-east-1",
})
// Place a call and stream status updates
const call = await client.calls.create({
to: "+14155550199",
from: "+19172544289",
recordDualChannel: true,
onStatus: (evt) => console.log(evt.status),
})
console.log(call.id) // call_rfw_2Kj8mNpQLimites previsíveis em todos os níveis.
Os limites são aplicados por espaço de trabalho, não por IP. Toda resposta carrega X-RateLimit-Remaining, X-RateLimit-Reset, e um Retry-After cabeçalho ativado 429 para que você possa recuar graciosamente.
| Plano | Sustentado | Tampa de explosão | Chamadas simultâneas |
|---|---|---|---|
| Caixa de areia | 5 solicitações/s | 15 solicitações/s | 2 chamadas |
| Iniciante | 40 solicitações/s | 80 solicitações/s | 25 chamadas |
| Negócios | 150 solicitações/s | 300 solicitações/s | 150 chamadas |
| EmpresaPersonalizado | Personalizado | Personalizado | Ilimitado |
Construído diferente. Preço justo.
Maioria APIs de telefonia ative a IA como uma reflexão tardia. O Ringflow construiu IA, voz e mensagens desde o início como uma única API coerente — para que você não cole três fornecedores juntos.
| Capacidade | Ringflow | Alternativa típica |
|---|---|---|
| Chamadas unificadas + SMS + IA em uma API | ✕ | |
| Sandbox permanente – sem vencimento, sem cartão | ✕ | |
| Gravação de canal duplo pronta para uso | ✕ | |
| Recepcionista de IA via endpoint REST | ✕ | |
| Entregas de webhook assinadas por HMAC | ||
| Rotação de chaves de API com tempo de inatividade zero | ✕ | |
| Auditoria de segurança empresarial + BAA disponível | ✕ |
Nosso Compromisso
Uma API REST desenvolvida de acordo com padrões de produção.
A API do Ringflow foi projetada para lidar com cargas de trabalho de produção reais — respostas JSON consistentes, autenticação forte, sinalização clara de limite de taxa e uma sandbox permanente para testes de integração seguros.
Amado por equipes de engenharia de todos os setores.
Do setor de saúde ao varejo: a API do Ringflow potencializa as comunicações de produção em grande escala.
Arjun Mehta
Chefe de Engenharia, Zenia Health - Mumbai
“A API do Ringflow nos permitiu incorporar a triagem de voz em nosso portal do paciente em duas semanas. Somente o endpoint AI Receptionist reduziu nosso volume de chamadas fora do horário comercial em 40%.”
Raquel Torres
Vice-presidente de produto, ClearLane Finance - Austin TX
“Migramos três fornecedores de contact center para o Ringflow em um trimestre. A superfície REST unificada simplificou nossa integração: um fluxo de autenticação, um esquema de webhook, tudo.”
Ben Hargreaves
Líder de plataforma, StackRoute – Londres
“Os endpoints de gravação de canal duplo e transcrição assíncrona nos pouparam de construir nosso próprio pipeline de fala. O Ringflow simplesmente lida com isso e a latência é genuinamente impressionante.”
Nadia Yusupova
CTO, Varejo Orbis – Dubai
“Nosso endpoint em massa de SMS envia 50.000 confirmações de pedidos diariamente sem problemas. Os recibos de entrega chegam ao nosso webhook em segundos – exatamente o que as operações de varejo exigem.”
Tom Fitzgerald
Engenheiro de back-end sênior, Lawbridge-Chicago IL
“A rotação de chaves com tempo de inatividade zero foi o recurso que convenceu nossa equipe de segurança. Rolar chaves de API sem uma janela de manutenção é algo que nosso antigo provedor simplesmente não conseguia fazer.”
Parque Soo-Jin
Arquiteto de Soluções, Clearview SaaS – Seul
“O Go SDK é idiomático e compila limpo em cada execução de CI. O cancelamento de contexto, as novas tentativas e a retirada do limite de taxa funcionam exatamente da maneira que você esperaria que um cliente de primeira classe se comportasse.”
Perguntas frequentes
Perguntas frequentes
Responder proativamente às perguntas frequentes aumenta a confiança do usuário e reduz os tíquetes de suporte.
Voz, SMS e IA – tudo conectado antes do almoço.
Avaliação gratuita · Sem cartão · Portabilidade de número gratuita · tempo de atividade respaldado por contrato de nível de serviço