flujo de anillo
API REST de flujo de anillo · 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
  • CORREO/v2/llamadasRealizar llamadas salientes a cualquier número
  • CONSEGUIR/v2/llamadas/:idObtener estado en vivo, duración y grabación
  • CORREO/v2/llamadas/:id/transferenciaTransferencia en caliente o en frío en mitad de una llamada
  • BORRAR/v2/llamadas/:idTerminar una llamada activa inmediatamente
SMS y MMS
  • CORREO/v2/mensajesEnvía SMS o MMS a un único destinatario
  • CORREO/v2/mensajes/masivoAgrupe hasta 1000 mensajes por solicitud
  • CONSEGUIR/v2/mensajes/:idConsultar el estado de entrega y el recibo del transportista
Grabaciones
  • CORREO/v2/llamadas/:id/registroIniciar la grabación de llamadas de doble canal
  • BORRAR/v2/llamadas/:id/registroDetener la grabación y activar el almacenamiento
  • CORREO/v2/grabaciones/:id/transcribirSolicitar transcripción de IA asíncrona
Recepcionista de IA
  • CORREO/v2/ai/agentesProporcione una nueva recepcionista de IA
  • PONER/v2/ai/agentes/:id/conocimientoEnvíe preguntas frecuentes, documentos y reglas de derivación
  • CONSEGUIR/v2/ai/sesiones/:id/resumenRecuperar el resumen de IA posterior a la llamada
Eventos
  • CORREO/v2/eventos/suscripcionesSuscríbete a cualquier evento de la plataforma.
  • CONSEGUIR/v2/eventos/suscripcionesEnumere y filtre sus suscripciones
  • BORRAR/v2/eventos/suscripciones/:idEliminar una suscripción a un evento
Autenticación y claves
  • CORREO/v2/autenticación/tokensEmitir token al portador de corta duración
  • CORREO/v2/autenticación/clavesCrear clave API de espacio de trabajo con ámbito
  • PONER/v2/auth/keys/:id/rotarRotació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, Restablecimiento de límite de velocidad X, y un Reintentar después 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.

Capacidadflujo de anilloAlternativa 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ímites 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 por voz en nuestro portal para 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 de 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 evento POST 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

Referencia de API REST para desarrolladores · JSON y HTTPS · Ringflow