# Envíe su primer SMS de prueba cinco minutos después de recibir las credenciales. - URL canónica: https://www.broadnet.me/es/developers/quickstart - Idioma: es - Última actualización: 2026-10-21 - Editor: BroadNet (https://www.broadnet.me) - Versión Markdown de la página, generada a partir de la página publicada. Guía de inicio rápido para desarrolladores 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. [Solicitar acceso de prueba](https://www.broadnet.me/es/signup) [Referencia completa de la API](https://www.broadnet.me/es/developers/api) Progreso 0 / 5 pasos · 5 min 0/5 Pasos restantes 5 1. Obtén tu token de acceso Paso 1 · 30 sec 2. Instala el SDK Paso 2 · 45 sec 3. Envía tu primer mensaje Paso 3 · 60 sec 4. Recibir estado de entrega Paso 4 · 90 sec 5. Antes de la producción Paso 5 · no forma parte de los cinco minutos De la solicitud a la producción ## Un solo camino hacia su primer mensaje, con tiempos detallados en cada paso. 1. 01 Solicitar acceso de prueba Respondemos en 1 día hábil Un 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. 2. 02 Primer mensaje de prueba Aproximadamente 5 minutos después de recibir las credenciales Enví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. 3. 03 Integración 2–5 días hábiles Implemente 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. 4. 04 Aprobación 3–10 días hábiles La 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. 5. 05 Producción Día del paso a producción El 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. Diagrama Cómo llega un mensaje A2P al teléfono 1. Su aplicación Se envía a través de REST API o SMPP 2. Plataforma BroadNet Valida, enruta y factura cada mensaje 3. SMSC del operador Conexión directa con el operador 4. Terminal del abonado El mensaje se entrega La confirmación de entrega (DLR) regresa por la misma ruta hacia su webhook En esta página 1. 01 Obtén tu token de acceso 2. 02 Instala el SDK 3. 03 Envía tu primer mensaje 4. 04 Recibir estado de entrega 5. 05 Antes de la producción Tras recibir las credenciales 5 min Unos cinco minutos desde las credenciales de prueba hasta su primer mensaje de prueba. El paso del webhook requiere una URL pública; ngrok funciona perfectamente. 01 Paso 1 · 30 sec ## 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. your BroadNet account · access token Access token quickstart-default active 84f1a02e3c7d4b91a7e0•••••••••••• copy Header Bearer Env var BROADNET_TOKEN Base URL api.broadnet.me $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" … 200 OK Pruébalo 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. step 1.broadnet.me 02 Paso 2 · 45 sec ## 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. Install ``` npm install @broadnet/cpaas-sdk axios export BROADNET_TOKEN=your_access_token ``` bash node >= 18 Pruébalo Importa Configuration y SMSSMSApi desde @broadnet/cpaas-sdk. Si la importación se resuelve y pasa la comprobación de tipos, ya puedes enviar. step 2.broadnet.me 03 Paso 3 · 60 sec ## 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. POST /sms/sendSms ``` // 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 ID ``` javascript 200 OK · message ID Response · 200 OK body · message ID ``` HTTP/1.1 200 OK 2603121407537573731 ``` Pruébalo Comprueba 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. step 3.broadnet.me 04 Paso 4 · 90 sec ## 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. POST /webhooks/broadnet ``` 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); }); ``` javascript delivery status · JSON DELIVERED Confirmado en el dispositivo. Las actualizaciones anteriores, SUBMITTED y SENT, llegan a medida que el mensaje se propaga por la red. después de la entrega READ Abierto por el destinatario, en canales que informan lecturas, como WhatsApp. al leer FAILED / REJECTED No se ha entregado. Compruebe el formato del número y su identificador de remitente antes de volver a enviarlo. estado final Pruébalo Envía un mensaje a tu teléfono y luego revisa el registro del servidor para ver la actualización del estado DELIVERED. step 4.broadnet.me 05 Paso 5 · no forma parte de los cinco minutos ## 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. - 01 Traslada 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. - 02 Inté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. - 03 Fija 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. - 04 Gestionar 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. - 05 Decida 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. Pruébalo 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. step 5.broadnet.me Diseñado para la producción desde el primer día. ## 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. ISO 27001 seguridad de la información ISO 9001 Gestión de la calidad ISO 22301 Continuidad del negocio RGPD Alineado · Residencia de datos en la UE HIPAA Alineado · BAA a petición SOC 2 Tipo II · auditoría anual Residencia de datos en la UE y los EAU SLA de disponibilidad de la API del 99,99 % Una única URL base para pruebas y producción Webhooks de estado de entrega Preguntas que hacen los compradores ## 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](https://www.broadnet.me/es/contact) Acceso de prueba · respuesta en un día hábil ## 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. [Solicitar acceso de prueba](https://www.broadnet.me/es/signup) [Referencia completa de la API](https://www.broadnet.me/es/developers/api) $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{ "senderId": "…", "destinationNumber": "…", "message": "…", "messageType": "TEXT" }'