Generador de solicitudes API.
Rellena los campos y observa cómo se construye en directo una solicitud SMS de BroadNet correcta: POST /sms/sendSms con un token Bearer y un cuerpo JSON, además de fragmentos listos para copiar en cURL, Node, Python y con el TypeScript SDK. La API HTTP heredada también está disponible, para integraciones existentes de la era SMPP. La herramienta construye la solicitud; nunca la envía.
El token de acceso a la API de tu cuenta de BroadNet. Guárdalo en una variable de entorno (BROADNET_TOKEN), nunca en el código fuente.
El ID de remitente aprobado que ve el destinatario.
Dígitos con el código de país y sin + inicial, p. ej. 447700900123.
32 carácteres en el cuerpo del mensaje
La REST API autentica cada llamada con un encabezado Authorization: Bearer que lleva el token de acceso de tu cuenta. Las credenciales nunca van en la URL ni en el cuerpo JSON. Las integraciones nuevas deben usar esta API.
{
"senderId": "BroadNet",
"destinationNumber": "447700900123",
"message": "Your verification code is 482913",
"messageType": "TEXT"
}curl -X POST https://api.broadnet.me/sms/sendSms \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "senderId": "BroadNet", "destinationNumber": "447700900123", "message": "Your verification code is 482913", "messageType": "TEXT"}'HTTP/1.1 200 OK
2603121407537573731Un envío exitoso devuelve HTTP 200 con el ID del mensaje como cuerpo de la respuesta. Un token faltante o no válido es rechazado por la pasarela API con 401 y un cuerpo JSON de dos campos: error y message; otros errores API devuelven una ExceptionResponse (status, error, message, errorCode, requestUri). El ID que se muestra es ilustrativo.
Todo se ejecuta en tu navegador. Ninguna solicitud sale de esta página y no se transmite ninguna credencial. Copia un fragmento y ejecútalo con tu propio token contra la API de producción.
La respuesta breve
¿Qué hace el generador de solicitudes?
Convierte un formulario en una solicitud correcta para la API de SMS de BroadNet. Rellena el ID de remitente, el destinatario, el mensaje y la codificación, y la herramienta arma POST /sms/sendSms con un encabezado Authorization: Bearer y un cuerpo JSON, junto con fragmentos de cURL, Node, Python y TypeScript SDK listos para ejecutar. No se envía nada: genera exactamente la solicitud que ejecutarías tú.
Cómo funciona un envío
Envía por POST un cuerpo JSON con cuatro campos obligatorios —senderId, destinationNumber, message y messageType (TEXT para GSM-7, UNICODE para todo lo demás)— a /sms/sendSms, con tu token en el encabezado Authorization: Bearer. Una respuesta 200 contiene el ID del mensaje. El TypeScript SDK oficial (@broadnet/cpaas-sdk) encapsula la misma llamada; desde cualquier otro lenguaje, llama directamente a la REST API o genera un cliente a partir de la especificación OpenAPI 3.1.
Campos del cuerpo de POST /sms/sendSms
| Parámetro | Obligatorio | Descripción |
|---|---|---|
| senderId | Sí | El ID de remitente aprobado que ve el destinatario. |
| destinationNumber | Sí | Número del destinatario: dígitos con el código de país, sin +. |
| message | Sí | El cuerpo del mensaje. |
| messageType | Sí | TEXT (GSM-7) o UNICODE (árabe, emoji, otras escrituras). |
| campaignName | No | Una etiqueta que agrupa los envíos en tus informes. |
| templateId | No | ID de la plantilla registrada, cuando la normativa local lo exige. |
Parámetros de GET /websmpp/websms (heredada)
| Parámetro | Obligatorio | Descripción |
|---|---|---|
| user | Sí | Nombre de usuario de la API heredada (accesskey puede sustituir a user + pass). |
| pass | Sí | Contraseña de la API heredada. |
| sid | Sí | ID de remitente que ve el destinatario. |
| mno | Sí | Número del destinatario con el código de país, sin +. |
| type | Sí | Codificación: 1 inglés/GSM-7, 2 Unicode, 3 inglés + caracteres especiales, 4 árabe. |
| text | Sí | Cuerpo del mensaje, codificado para URL. |
| schtime | No | Hora de entrega programada (yyyyMMddHHmm). |
| gmt | No | Diferencia horaria de la hora programada. |
Preguntas frecuentes
¿Esta herramienta envía un mensaje?
No. El generador arma la solicitud por completo en tu navegador y la muestra. No se transmite nada y ninguna credencial sale de la página. Copia un fragmento y ejecútalo tú mismo con tu propio token.
¿Qué API debo usar?
Las integraciones nuevas deben usar la REST API: POST /sms/sendSms con un token Authorization: Bearer y un cuerpo JSON. La API HTTP heredada (GET /websmpp/websms, con las credenciales como parámetros de consulta) se mantiene para integraciones existentes de la era SMPP.
¿Cómo me autentico?
Envía el token de acceso de tu cuenta en un encabezado Authorization: Bearer en cada llamada REST. El generador muestra la variable de entorno $BROADNET_TOKEN como marcador: mantén el token real fuera del código fuente.
¿Qué diferencia hay entre TEXT y UNICODE?
TEXT usa el alfabeto GSM-7: 160 caracteres en un SMS simple y 153 por parte cuando se concatena. UNICODE cubre el árabe, los emoji y otras escrituras: 70 caracteres en un SMS simple y 67 por parte. POST /sms/identify devuelve el messageType correcto y el número de segmentos de cualquier mensaje.
¿Hay un SDK?
Sí: un SDK oficial, para TypeScript / Node.js: @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). Desde cualquier otro lenguaje, llama directamente a la REST API como muestran los fragmentos, o genera un cliente a partir de la especificación OpenAPI 3.1.
¿Qué respuesta debo esperar?
Una llamada POST /sms/sendSms correcta devuelve HTTP 200 con el ID del mensaje como cuerpo. Un token Bearer faltante o no válido recibe un 401 de la pasarela API con un cuerpo JSON de error y message; otros errores devuelven una ExceptionResponse con status, error, message, errorCode y requestUri.
Cada endpoint, parámetro y respuesta en la referencia para desarrolladores.
Crea una cuenta para obtener tu token de acceso a la API y tus ID de remitente.
REST + SMPP 3.4, autenticación con token Bearer, webhooks de entrega.
Todas las utilidades gratuitas de BroadNet para desarrolladores.
¿Listo para enviar de verdad?
Obtenga su token de acceso, inserte el fragmento generado en su código y envíe mensajes de prueba a su propio número verificado antes de pasar a producción.