Envíe su primer SMS de prueba cinco minutos después de recibir las credenciales.
Solicite acceso de prueba y le responderemos en un día hábil con sus credenciales de prueba. Después, tome el token, instale el TypeScript SDK y llame a smsSendsmsPost. Su primer mensaje de prueba llegará a su propio número verificado aproximadamente cinco minutos después de recibir las credenciales de prueba. Cada ejemplo de abajo está listo para copiar, y el paso 5 detalla qué verificar antes de la producción.
Un solo camino hacia su primer mensaje, con tiempos detallados en cada paso.
- 01
Solicitar acceso de prueba
Respondemos en 1 día hábilUn ingeniero de mensajería responderá con sus credenciales de prueba y programará una llamada de 30 minutos sobre sus países, volúmenes y caso de uso.
- 02
Primer mensaje de prueba
Aproximadamente 5 minutos después de recibir las credencialesEnvíe un mensaje de prueba a su propio número verificado con el código de inicio rápido. La confirmación de entrega (DLR) se enviará a su webhook.
- 03
Integración
2–5 días hábilesImplemente y realice pruebas con sus credenciales de prueba en el mismo endpoint que los ejemplos de código. Un ingeniero de BroadNet le acompañará en REST o SMPP.
- 04
Aprobación
3–10 días hábilesLa identidad del remitente, el propósito del tráfico y las reglas de destino se revisan, y los Sender ID se registran ante cada regulador en paralelo con su integración.
- 05
Producción
Día del paso a producciónEl acceso y las rutas de producción ya están habilitados para su cuenta. Su integración ya llama a https://api.broadnet.me.
Total: de 5 a 15 días hábiles desde la solicitud hasta producción en la mayoría de los mercados; más donde el plazo de registro del Sender ID ante el regulador es mayor.
- Su aplicaciónSe envía a través de REST API o SMPP
- Plataforma BroadNetValida, enruta y factura cada mensaje
- SMSC del operadorConexión directa con el operador
- Terminal del abonadoEl mensaje se entrega
Obtén tu token de acceso.
Su token de acceso se incluye con sus credenciales de prueba: solicite acceso de prueba y le responderemos en un plazo de un día hábil. Guárdelo en la variable de entorno BROADNET_TOKEN y envíelo en un encabezado Authorization: Bearer en cada llamada. Todos los ejemplos de esta página utilizan la URL base de producción, https://api.broadnet.me.
Envíe un SMS de prueba a su propio número verificado con POST /sms/sendSms. Un código 200 OK cuyo cuerpo sea un ID de mensaje confirmará que el token funciona antes de que escriba cualquier otro código.
Instala el SDK.
BroadNet cuenta con un SDK oficial para TypeScript y Node.js: npm install @broadnet/cpaas-sdk axios. Se genera a partir de la especificación OpenAPI BroadNet. En cualquier otro lenguaje, llame a la API REST con su biblioteca HTTP habitual o genere un cliente a partir de la especificación OpenAPI.
npm install @broadnet/cpaas-sdk axios
export BROADNET_TOKEN=your_access_tokenImporta Configuration y SMSSMSApi desde @broadnet/cpaas-sdk. Si la importación se resuelve y pasa la comprobación de tipos, ya puedes enviar.
Envía tu primer mensaje.
Crea una API SMSSMSApi con tu URL base y token, llama a smsSendsmsPost con senderId, destinationNumber, message y messageType, y registra el resultado. El cuerpo de la respuesta es el ID del mensaje; guárdalo para consultar el estado de entrega posteriormente.
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";
const sms = new SMSSMSApi(
new Configuration({
basePath: "https://api.broadnet.me",
accessToken: process.env.BROADNET_TOKEN!,
}),
);
const res = await sms.smsSendsmsPost({
sMSSmsRequest: {
senderId: "BroadNet",
destinationNumber: "447700900123",
message: "Your verification code is 482913",
messageType: "TEXT",
},
});
console.log(res.data); // message IDHTTP/1.1 200 OK
2603121407537573731Comprueba el teléfono que tienes en la mano. Si recibiste el SMS, ya has superado la parte más difícil; todo lo que sigue son detalles técnicos.
Recibir estado de entrega.
BroadNet envía el estado de entrega a la URL del webhook configurada en tu cuenta: SUBMITTED, SENT, DELIVERED, READ en los canales que informan lecturas, o FAILED y REJECTED. Almacena cada actualización, responde rápidamente con un código 2xx y procésala de forma asíncrona.
import express from "express";
const app = express();
app.post("/webhooks/broadnet", express.json(), async (req, res) => {
// Store the status update first, then acknowledge with a 2xx.
// Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
res.sendStatus(200);
});Confirmado en el dispositivo. Las actualizaciones anteriores, SUBMITTED y SENT, llegan a medida que el mensaje se propaga por la red.
Abierto por el destinatario, en canales que informan lecturas, como WhatsApp.
No se ha entregado. Compruebe el formato del número y su identificador de remitente antes de volver a enviarlo.
Envía un mensaje a tu teléfono y luego revisa el registro del servidor para ver la actualización del estado DELIVERED.
Antes de la producción.
El acceso a producción se habilita una vez completada la aprobación: identidad del remitente, propósito del tráfico e IDs de remitente, de 3 a 10 días hábiles, en paralelo con su integración. Una vez aprobada, el mismo código enviará tráfico de producción. Antes de eso, mantenga el token fuera del control de versiones, configure los webhooks de estado de entrega y decida su política de reintentos.
- 01Traslada secretos a tu entorno
Guarda BROADNET_TOKEN en una variable de entorno o en tu gestor de secretos; nunca en el control de versiones ni en el código del cliente. Reemplázalo inmediatamente si se filtra.
- 02Inténtalo de nuevo de forma segura y vigila tu saldo.
Reintentar errores de red y respuestas 5xx con retroceso exponencial. Cada envío aceptado devuelve un ID de mensaje; guárdelo y verifique el estado de entrega en lugar de reenviar a ciegas. Los envíos masivos informan sobre los créditos restantes en cada respuesta.
- 03Fija la versión del SDK
Fije la versión exacta @broadnet/cpaas-sdk en package.json y actualícela deliberadamente. Las rutas API no llevan prefijo de versión, así que siga los cambios en el registro de cambios y la especificación OpenAPI.
- 04Gestionar errores por código de estado
Los errores devuelven un código de estado HTTP y un cuerpo ExceptionResponse con status, error, message, errorCode y requestUri. Corrige los errores 400 y 401; reintenta los errores 5xx con retroceso.
- 05Decida su política de reintentos
Por defecto: retroceso exponencial en los errores 5xx y de red; nunca en los errores 4xx. Tras un tiempo de espera agotado, compruebe el estado de entrega antes de volver a enviar la solicitud, ya que es posible que la primera ya haya sido aceptada.
Aplique la siguiente lista de verificación a su código. Cuando todos los elementos estén marcados, su integración estará lista para producción tan pronto como se complete la aprobación.
Las mismas rutas de código procesan más de 300 millones de mensajes al día.
Su tráfico de prueba no es una simulación. Cada solicitud, clave y webhook que configuró en los pasos anteriores se procesa a través de la misma infraestructura de enrutamiento, facturación y cumplimiento que gestiona nuestro tráfico empresarial, la cual se audita anualmente bajo las certificaciones que se presentan a continuación.
Preguntas sobre el inicio rápido
POST https://api.broadnet.me/sms/sendSms, con una cabecera Authorization: Bearer y un cuerpo JSON con senderId, destinationNumber, message y messageType (TEXT o UNICODE). La respuesta es el ID del mensaje. La API HTTP heredada en /websmpp sigue disponible para integraciones de la época de SMPP.
Solicite acceso de prueba en /signup. Un ingeniero de BroadNet le responde en un día hábil con sus credenciales de prueba: el token de acceso que se envía en una cabecera Authorization: Bearer, y la dirección a la que enviar el tráfico de prueba. Su primer mensaje de prueba puede salir unos cinco minutos después de recibirlas.
Un único SDK oficial: @broadnet/cpaas-sdk para TypeScript y Node.js, en npm. En cualquier otro lenguaje, llame directamente a la REST API por HTTPS o genere un cliente a partir de la especificación OpenAPI (/developers/openapi.yaml).
¿La pregunta no está aquí? Consulte a nuestro equipo de ingeniería
Cinco escalones más abajo.
Solo falta una llave.
Realice pruebas con sus propios números verificados, implemente la integración y luego pase al tráfico en vivo desde la misma consola. El mismo SDK, los mismos endpoints y los mismos SLA que gestionan más de 300 millones de mensajes al día.