Una sola API de mensajería para ocho canales

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.

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.

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.

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.

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.

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.

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.

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.