--- title: "Una sola API de mensajería para ocho canales" description: "Una sola API REST para SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, correo y push, con webhooks, SMPP, un SDK de TypeScript y un servidor MCP." canonical: "https://omnichannels.ai/es/developers/" language: "es" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Una sola API de mensajería para ocho canales Canonical: https://omnichannels.ai/es/developers/ Language: es Publisher: OmniChannels.ai by BroadNet Technologies Envíe SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, correo electrónico y notificaciones push desde su propio código con una URL base y un token Bearer. Siga cada mensaje mediante webhooks, escale los SMS con SMPP y permita que los agentes de IA usen la misma API a través de MCP. **Respuesta breve:** OmniChannels.ai ofrece a los desarrolladores una sola API REST para SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, correo electrónico y push. Cuenta con unas 225 rutas documentadas en una especificación OpenAPI 3.1, un SDK de TypeScript, webhooks de estado de entrega, SMPP v3.4 sobre TLS y un servidor MCP para agentes de IA. El acceso de prueba envía a sus propios números verificados, nuestros ingenieros acompañan su integración y los revendedores pueden usar la misma API con su propia marca. ## Qué obtiene como desarrollador - **Una API REST, ocho canales:** SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, correo electrónico y push comparten una URL base, un token Bearer y un formato de error, así que añadir un canal es un nuevo endpoint, no un nuevo proveedor. - **OpenAPI 3.1 y un SDK de TypeScript:** Unas 225 rutas documentadas en una especificación OpenAPI 3.1 que puede importar en Postman o usar para generar clientes, además del paquete oficial @broadnet/cpaas-sdk para TypeScript y Node.js. - **Webhooks de estado de entrega:** Los estados están normalizados entre canales (SUBMITTED, SENT, DELIVERED, READ, FAILED y REJECTED) y se envían a su endpoint HTTPS, con endpoints de consulta y de reenvío como red de seguridad. - **SMPP v3.4 para SMS de alto volumen:** Binds de tipo transceiver sobre TLS con lista de IP permitidas, habilitados para su cuenta, por las mismas rutas directas con operadores que la API REST. - **Servidor MCP para agentes de IA:** Conecte Claude, Cursor o cualquier cliente MCP a la API con su token, para que los agentes envíen mensajes y consulten informes de entrega (DLR) dentro de los límites que usted defina. - **Pruebe antes de pasar a producción:** Las credenciales de prueba envían a sus propios números verificados con la misma URL base que producción, por lo que su código no cambia en el paso a producción. - **Soporte de ingenieros:** Un ingeniero de mensajería revisa su caso de uso, le ayuda con el diseño en REST o SMPP, los ID de remitente y las normas de cada país, y le acompaña hasta la puesta en marcha. - **Pensada para revendedores:** Los revendedores usan la misma API con su propia marca, con subcuentas que tienen cada una su propio saldo, ID de remitente, usuarios y webhooks, además de una API de revendedor para gestionar las cuentas. ## La oferta para desarrolladores de un vistazo | Elemento | Detalles | |---|---| | API REST (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, correo electrónico, push) | URL base https://api.broadnet.me con autenticación mediante token Bearer. El acceso de prueba se concede tras una breve solicitud. | | Webhooks de estado de entrega | Se configuran por cuenta o subcuenta. Los estados están normalizados entre canales. | | SDK de TypeScript | npm install @broadnet/cpaas-sdk axios. Desde otros lenguajes se llama directamente a la API REST o se genera un cliente. | | Especificación OpenAPI 3.1 | Pública en https://omnichannels.ai/developers/openapi.json (YAML en /developers/openapi.yaml): todas las operaciones que puede llamar un token de cliente, para Postman, Insomnia, la generación de clientes y las herramientas de programación con IA. | | Servidor MCP | https://mcp.broadnet.me/mcp sobre Streamable HTTP, autenticado con su token. | | SMPP v3.4 sobre TLS | Nuestro equipo habilita para su cuenta los binds, el caudal y la lista de IP permitidas. | | Voz (OTP, IVR, llamadas salientes, agentes de voz con IA) | Se habilita con el equipo de cuenta; la API REST no tiene endpoints públicos de voz. | ## De la primera solicitud a producción 1. **Solicite acceso de prueba:** Indíquenos sus canales, países de destino, volúmenes y caso de uso. Un ingeniero revisa la solicitud y emite las credenciales de prueba. 2. **Envíe su primer mensaje de prueba:** Siga la guía de inicio rápido para enviar un SMS a su propio número verificado y recibir su estado de entrega en su webhook. 3. **Desarrolle la integración:** Añada los canales que necesite, gestione errores y reintentos y registre los ID de mensaje. Nuestros ingenieros pueden revisar su diseño en REST o SMPP. 4. **Obtenga la aprobación de remitentes:** Los ID de remitente, las cuentas de WhatsApp Business y los agentes de RCS se registran en paralelo a su desarrollo, según las normas de cada país y de cada plataforma. 5. **Pase a producción:** Se activan las rutas de producción para su cuenta. Su código sigue llamando a la misma URL base, así que nada cambia en el paso a producción. ## ¿Es esta API adecuada para su equipo? ### Encaja bien cuando - Quiere una sola integración para SMS, WhatsApp, RCS, mensajería social, correo electrónico y push en lugar de varios proveedores. - Necesita el estado de entrega de cada mensaje en sus propios sistemas, no solo en un panel. - Envía grandes volúmenes de SMS y quiere SMPP además de REST. - Revende mensajería y necesita la misma API con su marca, con subcuentas. - Desarrolla agentes de IA que deben enviar y seguir mensajes a través de MCP. ### Conviene saber antes de empezar - No hay alta instantánea de autoservicio; el acceso de prueba se concede tras una breve solicitud. - El SDK oficial es solo para TypeScript; otros lenguajes usan HTTP directamente o un cliente generado a partir de la especificación. - La API no admite clave de idempotencia, por lo que su integración debe registrar cada envío antes de reintentarlo. - La voz y SMPP se habilitan con nuestro equipo, no mediante endpoints públicos. - Los envíos por WhatsApp, Messenger e Instagram siguen las reglas de Meta, incluidas las plantillas aprobadas y las ventanas de mensajería. ## Preguntas de desarrolladores ### ¿Cómo me autentico? Envíe el token de acceso de su cuenta en una cabecera Authorization: Bearer en cada solicitud. Los tokens se emiten por cuenta; no existe un endpoint que cambie usuario y contraseña por un token. Un token ausente o no válido devuelve 401. Guarde el token en sus servidores, nunca en código de navegador o de aplicaciones móviles. ### ¿Cuál es la URL base y hay un sandbox independiente? Todas las llamadas van a https://api.broadnet.me, sin prefijo de versión. Prueba y producción usan la misma URL base: las credenciales de prueba solo envían a sus propios números verificados, y la producción se activa para su cuenta tras la aprobación de remitentes, así que su código no cambia. ### ¿Cómo obtengo los informes de entrega? Los estados se envían a la URL de webhook configurada en su cuenta: SUBMITTED, SENT, DELIVERED, READ en los canales que informan de la lectura, FAILED y REJECTED. También puede consultarlos, por ejemplo con GET /sms/list para envíos masivos de SMS y GET /whatsapp/message/bulk-insights para lotes de WhatsApp. ### ¿Cómo debo gestionar reintentos y duplicados? Reintente solo los errores de red y las respuestas 429 y 5xx, con backoff exponencial y jitter, y nunca reintente sin cambios los errores 4xx. La API no admite clave de idempotencia, así que registre cada envío antes de hacerlo, guarde el ID de mensaje devuelto y compruebe el estado tras un tiempo de espera agotado antes de volver a enviar. ### ¿Cuáles son los límites de frecuencia? Los valores documentados por defecto son 200 solicitudes por segundo en REST con picos de hasta 500 durante un máximo de 60 segundos, 1.000 mensajes por segundo por bind SMPP y 50 solicitudes por segundo para consultas de números. Los límites de su cuenta se confirman junto con sus credenciales. Las solicitudes que superan el límite devuelven 429 con una cabecera Retry-After. ### ¿Qué lenguajes se admiten? Cualquier lenguaje que pueda hacer solicitudes HTTPS. Hay un SDK oficial de TypeScript, @broadnet/cpaas-sdk, y la documentación incluye ejemplos HTTP para cURL, Node.js, Python, PHP, Java, .NET, Go y Ruby. También puede generar un cliente a partir de la especificación OpenAPI 3.1, pública en /developers/openapi.json. ### ¿Debo usar REST o SMPP para los SMS? REST es adecuado para la mayoría de las aplicaciones y le da todos los canales a través de una sola API. SMPP v3.4 sobre TLS es adecuado para SMS de alto volumen sostenido, sobre todo si ya utiliza un cliente SMPP. Los binds, el caudal y las listas de IP permitidas se habilitan para su cuenta, y puede usar ambos en una misma cuenta. ### ¿Puedo revender mensajería a través de la API? Sí. Los revendedores usan la misma API con su propia marca. Cada subcuenta tiene su propio saldo, ID de remitente, usuarios y webhooks, y una API de revendedor cubre la creación de cuentas, las recargas de saldo, las tablas de tarifas y los informes. Mencione la reventa al solicitar acceso para que definamos la estructura con usted. Actualizado: 2026-10-10