Ringflow
API REST Ringflow · v2

Una API para llamadas, SMS e IA — creado para equipos modernos.

La API REST de Ringflow le brinda control programático sobre cada parte de su pila de comunicaciones (llamadas salientes, SMS masivos, grabaciones de doble canal, agentes recepcionistas de IA y webhooks de eventos en tiempo real), todo detrás de un único punto final autenticado.

Zona de pruebas permanente gratuita5 minutos para la primera llamada en vivocapa API respaldada por acuerdo de nivel de servicio
API respaldada por acuerdo de nivel de servicio·Seguridad empresarial·BAA disponible·Redacción de grabaciones de llamadas·Firma de eventos HMAC·Residencia de datos de la UE y EE. UU.
Referencia API

Todo lo que necesitas, nada que no necesites.

Seis grupos de recursos, una URL base, un esquema de autenticación. Cada punto final tiene versiones, devuelve JSON consistente y se envía con ejemplos de solicitud/respuesta en el referencia completa.

Llamadas de voz
  • POST/v2/calls— Realizar llamadas salientes a cualquier número
  • GET/v2/calls/:id— Obtener estado en vivo, duración y grabación
  • POST/v2/calls/:id/transfer— Transferencia en caliente o en frío en mitad de una llamada
  • DELETE/v2/calls/:id— Terminar una llamada activa inmediatamente
SMS y MMS
  • POST/v2/messages— Envía SMS o MMS a un único destinatario
  • POST/v2/messages/bulk— Agrupe hasta 1000 mensajes por solicitud
  • GET/v2/messages/:id— Consultar el estado de entrega y el recibo del transportista
Grabaciones
  • POST/v2/calls/:id/record— Iniciar la grabación de llamadas de doble canal
  • DELETE/v2/calls/:id/record— Detener la grabación y activar el almacenamiento
  • POST/v2/recordings/:id/transcribe— Solicitar transcripción de IA asíncrona
AI Receptionist
  • POST/v2/ai/agents— Proporcione una nueva recepcionista de IA
  • PUT/v2/ai/agents/:id/knowledge— Envíe preguntas frecuentes, documentos y reglas de derivación
  • GET/v2/ai/sessions/:id/summary— Recuperar el resumen de IA posterior a la llamada
Eventos
  • POST/v2/events/subscriptions— Suscríbete a cualquier evento de la plataforma.
  • GET/v2/events/subscriptions— Enumere y filtre sus suscripciones
  • DELETE/v2/events/subscriptions/:id— Eliminar una suscripción a un evento
Autenticación y claves
  • POST/v2/auth/tokens— Emitir token al portador de corta duración
  • POST/v2/auth/keys— Crear clave API de espacio de trabajo con ámbito
  • PUT/v2/auth/keys/:id/rotate— Rotación de claves sin tiempo de inactividad
SDK de cliente

Clientes idiomáticos para su pila.

Cada SDK de Ringflow se construye primero con código, no se genera a partir de una especificación. Los reintentos, los cursores de paginación y la verificación de webhooks son de primera clase, no son ideas tardías.

npm i @ringflow/sdk
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_2Kj8mNpQ
Reintentos inteligentes con jitter
Paginación basada en cursor
Verificación de firma incorporada
Cobertura 100% de TypeScript
Límites de tarifas

Límites predecibles en cada nivel.

Los límites se aplican por espacio de trabajo, no por IP. Cada respuesta lleva X-RateLimit-Remaining, X-RateLimit-Reset, y un Retry-After encabezado encendido 429s para que puedas retroceder con gracia.

PlanSostenidotapa reventadaLlamadas simultáneas
Salvadera5 solicitudes/s15 solicitudes/s2 llamadas
Motor de arranque40 solicitudes/s80 solicitudes/s25 llamadas
Negocio150 solicitudes/s300 solicitudes/s150 llamadas
EmpresaCostumbreCostumbreCostumbreIlimitado
¿Por qué Ringflow?

Construido diferente. Precio justo.

Mayoría API de telefonía conecte la IA como una ocurrencia tardía. Ringflow creó inteligencia artificial, voz y mensajería desde cero como una única API coherente, por lo que no es necesario unir a tres proveedores con cinta adhesiva.

CapacidadRingflowAlternativa típica
Llamadas unificadas + SMS + IA en una API✕
Sandbox permanente: sin vencimiento, sin tarjeta✕
Grabación de doble canal lista para usar✕
Recepcionista de IA a través del punto final REST✕
Entregas de webhooks firmados por HMAC
Rotación de claves API sin tiempo de inactividad✕
Auditoría de seguridad empresarial + BAA disponible✕

Nuestro Compromiso

Una API REST construida según los estándares de producción.

La API de Ringflow está diseñada para manejar cargas de trabajo de producción reales: respuestas JSON consistentes, autenticación sólida, señalización clara de límite de velocidad y una zona de pruebas permanente para pruebas de integración seguras.

Respuestas JSON
Autenticación OAuth 2.0
Encabezados de límite de tarifa
Claves de idempotencia
Reintentos de webhook
Puntos finales versionados
tiempo de actividad de 99 puntos
Pruebas de espacio aislado

Amado por los equipos de ingeniería de todas las industrias.

Desde atención médica hasta venta minorista: la API de Ringflow impulsa las comunicaciones de producción a escala.

A

Arjun Mehta

Jefe de Ingeniería, Zenia Health — Bombay

“La API de Ringflow nos permitió integrar la clasificación de voz en nuestro portal de pacientes en dos semanas. El terminal AI Receptionist por sí solo redujo nuestro volumen de llamadas fuera de horario en un 40%.”

Cliente verificado
R

Raquel Torres

Vicepresidente de Producto, ClearLane Finance — Austin, TX

“Migramos tres proveedores de centros de contacto a Ringflow en un trimestre. La superficie REST unificada hizo que nuestra integración fuera sencilla: un flujo de autenticación, un esquema de webhook, todo.”

Cliente verificado
B

Ben Hargreaves

Líder de plataforma, StackRoute — Londres

“Los puntos finales de grabación de doble canal y transcripción asíncrona nos salvaron de crear nuestro propio canal de voz. Ringflow simplemente lo maneja y la latencia es realmente impresionante.”

Cliente verificado
N

Nadia Yusupova

CTO, Venta al por menor de Orbis - Dubái

“Nuestro terminal masivo de SMS envía 50 000 confirmaciones de pedidos diariamente sin problemas. Los recibos de entrega llegan a nuestro webhook en cuestión de segundos, exactamente lo que exigen las operaciones minoristas.”

Cliente verificado
T

Tom Fitzgerald

Ingeniero sénior de back-end, Lawbridge — Chicago Illinois

“La rotación de claves sin tiempo de inactividad fue la característica que convenció a nuestro equipo de seguridad. Transferir claves API sin una ventana de mantenimiento es algo que nuestro antiguo proveedor simplemente no podía hacer.”

Cliente verificado
S

Parque Soo-Jin

Arquitecto de Soluciones, Clearview SaaS — Seúl

“El Go SDK es idiomático y se compila limpio en cada ejecución de CI. La cancelación de contexto, los reintentos y la reducción del límite de velocidad funcionan exactamente como se esperaría que se comportara un cliente de primera clase.”

Cliente verificado

Preguntas frecuentes

Preguntas frecuentes

Responder proactivamente a las preguntas frecuentes aumenta la confianza del usuario y reduce los tickets de soporte.

Inicie sesión en su panel de Ringflow, navegue hasta Configuración → Desarrollador → Claves API y haga clic en Nueva clave. Cada clave tiene como alcance recursos específicos (llamadas, mensajes, IA o todos) y está vinculada a un único entorno de espacio de trabajo.
Sí. Cada cuenta Ringflow incluye un entorno Sandbox permanente. Las llamadas de Sandbox utilizan enrutamiento de operador simulado, por lo que puede probar su integración completa, incluidas grabaciones, recepcionista de IA y webhooks, sin cargos por uso ni una línea telefónica real.
En la mayoría de los casos, menos de 5 minutos desde el registro hasta una llamada en vivo. Proporcione un número en el panel, copie su clave API y PUBLICAR en /v2/calls. Nuestra guía de incorporación lo explica paso a paso.
Cada POST de evento incluye un encabezado X-Ringflow-Signature-256: un resumen HMAC-SHA256 del cuerpo de la solicitud sin procesar codificado con su secreto de webhook. Tanto el SDK de Node.js como el de Python exponen una utilidad verificarSignature() para que nunca tengas que implementarla tú mismo.
Ringflow ofrece regiones de residencia de datos de EE. UU. y la UE a nivel de espacio de trabajo. Los acuerdos de socios comerciales están disponibles en planes Business y Enterprise para casos de uso de atención médica. Póngase en contacto con nuestro equipo para obtener el paquete completo de documentación de seguridad.
La recepcionista con IA está incluida en los planes Business y Enterprise. Las cuentas Sandbox y Starter tienen acceso de lectura a los puntos finales de IA para pruebas de integración, pero el manejo de llamadas de IA en vivo requiere una suscripción activa Business o Enterprise.

Voz, SMS e IA: todo conectado antes del almuerzo.

Prueba gratuita · Sin tarjeta · Transferencia de números gratuita · tiempo de actividad respaldado por el acuerdo de nivel de servicio