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.
- PUBLICAR/v2/chamadas— Faça chamadas para qualquer número
- PEGAR/v2/chamadas/:id— Obtenha status ao vivo, duração e gravação
- PUBLICAR/v2/chamadas/:id/transferência— Transferência quente ou fria no meio da chamada
- EXCLUIR/v2/chamadas/:id— Encerre uma chamada ativa imediatamente
- PUBLICAR/v2/mensagens— Envie SMS ou MMS para um único destinatário
- PUBLICAR/v2/mensagens/em massa— Agrupe até 1.000 mensagens por solicitação
- PEGAR/v2/mensagens/:id— Pesquisar status de entrega e recibo da transportadora
- PUBLICAR/v2/chamadas/:id/registro— Inicie a gravação de chamadas de canal duplo
- EXCLUIR/v2/chamadas/:id/registro— Pare a gravação e acione o armazenamento
- PUBLICAR/v2/gravações/:id/transcrever— Solicitar transcrição assíncrona de IA
- PUBLICAR/v2/ai/agentes— Provisionar uma nova recepcionista de IA
- COLOCAR/v2/ai/agentes/:id/conhecimento— Push FAQs, documentos e regras de escalonamento
- PEGAR/v2/ai/sessions/:id/resumo— Recuperar resumo de IA pós-chamada
- PUBLICAR/v2/eventos/assinaturas— Inscreva-se em qualquer evento da plataforma
- PEGAR/v2/eventos/assinaturas— Liste e filtre suas assinaturas
- EXCLUIR/v2/events/subscrições/:id— Remover uma assinatura de evento
- PUBLICAR/v2/auth/tokens— Emitir token ao portador de curta duração
- PUBLICAR/v2/auth/chaves— Criar chave de API do espaço de trabalho com escopo
- COLOCAR/v2/auth/keys/:id/rotate— Rotação de chaves com tempo de inatividade zero
Clientes idiomáticos para sua pilha.
Cada Ringflow SDK é construído 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-Remanescente, X-RateLimit-Reset, e um Tentar novamente depois 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. 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 | Fluxo de anel | 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.
Da saúde ao varejo – a API da 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 cuida disso 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