<\/p>\n\n\n\n
\u00a1Vamos all\u00e1! <\/p>\n\n\n\n
<\/p>\n\n\n\n
Requisitos para enviar SMS con Node.js <\/h2>\n\n\n\n
Antes de comenzar, aseg\u00farate de cumplir con los siguientes requisitos:<\/p>\n\n\n\n
\ud83d\udd39 Cuenta en 360NRS<\/strong>: Si a\u00fan no tienes una, reg\u00edstrate en 360NRS<\/a>. Si a\u00fan no tienes un proyecto, cr\u00e9alo ejecutando:<\/p>\n\n\n\n Esto crear\u00e1 un archivo Axios es una librer\u00eda que facilita la realizaci\u00f3n de solicitudes HTTP. Inst\u00e1lala con:<\/p>\n\n\n\n A continuaci\u00f3n, te mostramos c\u00f3mo enviar un SMS utilizando la API de 360NRS.<\/p>\n\n\n\n <\/p>\n\n\n\n \u2714\ufe0f Se usa Axios<\/strong> para hacer una solicitud HTTP Si todo est\u00e1 correcto, recibir\u00e1s una respuesta con el c\u00f3digo 202 ACCEPTED<\/strong> y detalles del SMS enviado.<\/p>\n\n\n\n <\/p>\n\n\n\n La API de 360NRS devuelve diferentes respuestas dependiendo del estado del mensaje. Aqu\u00ed te mostramos los principales casos:<\/p>\n\n\n\n \ud83d\udd39 Significado:<\/strong> El SMS fue aceptado y est\u00e1 en proceso de env\u00edo.<\/p>\n\n\n\n <\/p>\n\n\n\n <\/p>\n\n\n\n \ud83d\udd39 Significado:<\/strong> Algunos SMS se enviaron correctamente y otros fallaron.<\/p>\n\n\n\n <\/p>\n\n\n\n <\/p>\n\n\n\n \ud83d\udd39 Soluci\u00f3n:<\/strong> Verifica que los n\u00fameros de tel\u00e9fono sean correctos.<\/p>\n\n\n\n <\/p>\n\n\n\n <\/p>\n\n\n\n La API permite personalizar los env\u00edos con par\u00e1metros adicionales:<\/p>\n\n\n\n \ud83d\udcc5 Esto enviar\u00e1 el SMS el 15 de febrero de 2025 a las 14:20:00 UTC.<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n \ud83d\udcdd El receptor ver\u00e1:<\/strong> Puedes verificar el estado de un mensaje enviando una solicitud Cuando trabajamos con APIs de terceros, especialmente aquellas que manejan datos sensibles como el env\u00edo de SMS, es importante seguir ciertas buenas pr\u00e1cticas<\/strong> para garantizar seguridad, estabilidad y eficiencia<\/strong> en nuestras aplicaciones.<\/p>\n\n\n\n Aqu\u00ed te explicamos por qu\u00e9<\/strong> cada una de estas pr\u00e1cticas es esencial y c\u00f3mo aplicarlas correctamente.<\/p>\n\n\n\n <\/p>\n\n\n\n <\/p>\n\n\n\n El \ud83d\udd39 Errores comunes<\/strong> \ud83d\udd39 C\u00f3mo proteger tu token correctamente<\/strong><\/p>\n\n\n\n \u2705 Usa variables de entorno (.env)<\/strong> 1\ufe0f\u20e3 Instala 2\ufe0f\u20e3 Crea un archivo .env<\/strong> en la ra\u00edz de tu proyecto y agrega tu token:<\/p>\n\n\n\n 3\ufe0f\u20e3 En tu c\u00f3digo, carga el token desde el archivo \u2705 Usa variables de entorno en servicios cloud<\/strong> \ud83d\udccc Regla de oro:<\/strong> Nunca subas archivos <\/p>\n\n\n\n Cuando env\u00edas un SMS, la API de 360NRS puede responder con diferentes c\u00f3digos de estado dependiendo del resultado del env\u00edo. Manejar estos errores correctamente evita que tu aplicaci\u00f3n falle y ayuda a mejorar la experiencia del usuario.<\/p>\n\n\n\n \ud83d\udd39 Ejemplo de errores comunes<\/strong><\/p>\n\n\n\n \ud83d\udd39 C\u00f3mo manejar errores correctamente<\/strong><\/p>\n\n\n\n Captura los errores y muestra mensajes adecuados<\/strong><\/p>\n\n\n\n Implementa un sistema de reintento para fallos temporales<\/strong><\/p>\n\n\n\n Si recibimos un error 500 o 429<\/strong>, podemos reintentar el env\u00edo despu\u00e9s de un breve tiempo de espera.<\/p>\n\n\n\n \ud83d\udccc Esto asegura que no abandonemos el proceso al primer fallo y permite recuperar errores temporales autom\u00e1ticamente.<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n <\/p>\n\n\n\n La API de 360NRS requiere que los n\u00fameros de tel\u00e9fono est\u00e9n en formato internacional, lo que significa que deben incluir el prefijo del pa\u00eds (Ejemplo para Espa\u00f1a: \ud83d\udd39 Errores comunes<\/strong> \ud83d\udd39 C\u00f3mo validar un n\u00famero antes de enviarlo<\/strong><\/p>\n\n\n\n \ud83d\udccc Implementar validaciones previas evita fallos en la API y mejora la eficiencia.<\/strong><\/p>\n\n\n\n Ahora que ya sabes c\u00f3mo enviar SMS con Node.js y la API de 360NRS, estos son algunos pr\u00f3ximos pasos<\/strong> para mejorar tu integraci\u00f3n:<\/p>\n\n\n\n Experimenta con par\u00e1metros avanzados<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n Automatiza env\u00edos con bases de datos<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n Integra el seguimiento de entrega en tu sistema<\/strong><\/p>\n\n\n\n <\/p>\n\n\n\n Con estas mejoras, tu integraci\u00f3n de SMS ser\u00e1 m\u00e1s robusta y eficiente. \u00a1Manos a la obra!<\/p>\n\n\n\n <\/p>\n\n\n\n Tambi\u00e9n te puede interesar<\/strong>:<\/p>\n\n\n API SMS <\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n API para enviar SMS con Node.js<\/a><\/p><\/div><\/div>\n
\ud83d\udd39 Obtener el Token de Autenticaci\u00f3n<\/strong>: Lo necesitas para autenticarte en la API.
\ud83d\udd39 Node.js instalado<\/strong>: Puedes descargarlo desde nodejs.org.<\/p>\n\n\n\n
\n\n\n\nConfiguraci\u00f3n del entorno en Node.js<\/h2>\n\n\n\n
Paso 1: Crear un nuevo proyecto en Node.js<\/h3>\n\n\n\n
mkdir enviar-sms-node
cd enviar-sms-node
npm init -y
<\/code><\/pre>\n\n\n\npackage.json<\/code> con la configuraci\u00f3n b\u00e1sica del proyecto.<\/p>\n\n\n\nPaso 2: Instalar Axios<\/h3>\n\n\n\n
npm install axios
<\/code><\/pre>\n\n\n\n
\n\n\n\nC\u00f3digo para enviar SMS con Node.js<\/h2>\n\n\n\n
C\u00f3digo para enviar un SMS<\/h3>\n\n\n\n
var axios = require('axios');
var config = {
method: 'post',
url: 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms',
headers: {
'Content-Type': 'application\/json',
'Authorization': 'Basic YOUR_AUTH_TOKEN' \/\/ Reemplaza con tu token de autenticaci\u00f3n
},
data: JSON.stringify({
\"to\": [\"34666555444\"], \/\/ N\u00famero de tel\u00e9fono en formato internacional
\"from\": \"TEST\", \/\/ Remitente del SMS
\"message\": \"SMS text message\" \/\/ Texto del mensaje
})
};
axios(config)
.then(function (response) {
console.log(\"SMS enviado con \u00e9xito:\", response.data);
})
.catch(function (error) {
console.error(\"Error al enviar SMS:\", error.response ? error.response.data : error.message);
});
<\/code><\/pre>\n\n\n\nExplicaci\u00f3n del c\u00f3digo<\/strong><\/h3>\n\n\n\n
POST<\/code> a la API.
\u2714\ufe0f El Authorization<\/code> usa un token Basic Auth<\/strong>, reempl\u00e1zalo con tu TOKEN REAL<\/strong>.
\u2714\ufe0f to<\/code>: N\u00famero de tel\u00e9fono del destinatario en formato internacional.
\u2714\ufe0f from<\/code>: Remitente (puede ser un n\u00famero o texto alfanum\u00e9rico de hasta 11 caracteres).
\u2714\ufe0f message<\/code>: Contenido del SMS.<\/p>\n\n\n\n
\n\n\n\nManejo de respuestas de la API<\/h2>\n\n\n\n
Respuesta Exitosa (202 ACCEPTED)<\/strong><\/h3>\n\n\n\n
{
\"campaignId\": 100000,
\"sendingId\": 100001,
\"result\": [
{
\"accepted\": true,
\"to\": \"34666555444\",
\"id\": \"XXXXXXXXXXXXX\",
\"parts\": 1
}
]
}
<\/code><\/pre>\n\n\n\nError Parcial (207 MULTI-STATUS)<\/strong><\/h3>\n\n\n\n
{
\"campaignId\": 100000,
\"sendingId\": 100001,
\"result\": [
{
\"accepted\": true,
\"to\": \"34666555444\",
\"id\": \"XXXXXXXXXXXXX\"
},
{
\"accepted\": false,
\"to\": \"34\",
\"error\": {
\"code\": 102,
\"description\": \"No valid recipients\"
}
}
]
}
<\/code><\/pre>\n\n\n\nError en el env\u00edo (400 BAD REQUEST)<\/strong><\/h3>\n\n\n\n
{
\"error\": {
\"code\": 102,
\"description\": \"No valid recipients\"
}
}
<\/code><\/pre>\n\n\n\n
\n\n\n\nPar\u00e1metros avanzados en el env\u00edo de SMS con Node.js<\/h2>\n\n\n\n
Programar el env\u00edo de un SMS<\/strong> con Node.js<\/h3>\n\n\n\n
{
\"to\": [\"34666555444\"],
\"from\": \"TEST\",
\"message\": \"Mensaje programado\",
\"scheduleDate\": \"20250215142000\"
}
<\/code><\/pre>\n\n\n\nMensajes con variables personalizadas<\/strong><\/h3>\n\n\n\n
{
\"to\": [\"34666555444\"],
\"from\": \"TEST\",
\"message\": \"Hola {name}\",
\"sub\": [
{ \"name\": \"Juan\" }
]
}
<\/code><\/pre>\n\n\n\n\"Hola Juan\"<\/code><\/p>\n\n\n\n
\n\n\n\nConsultar el estado de un SMS enviado<\/h2>\n\n\n\n
GET<\/code> con su ID.<\/p>\n\n\n\nC\u00f3digo en Node.js<\/h3>\n\n\n\n
var axios = require('axios');
var config = {
method: 'get',
url: 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms\/XXXXXXXXXXXXX', \/\/ Reemplaza con el ID del SMS
headers: {
'Content-Type': 'application\/json',
'Authorization': 'Basic YOUR_AUTH_TOKEN'
}
};
axios(config)
.then(function (response) {
console.log(\"Estado del SMS:\", response.data);
})
.catch(function (error) {
console.error(\"Error al consultar SMS:\", error.response ? error.response.data : error.message);
});
<\/code><\/pre>\n\n\n\n
\n\n\n\nBuenas pr\u00e1cticas en el uso de la API SMS con Node.js<\/strong><\/h2>\n\n\n\n
1. Nunca compartas tu Authorization Token en c\u00f3digo p\u00fablico<\/h3>\n\n\n\n
Authorization Token<\/code> es una credencial privada<\/strong> que te permite autenticarte en la API de 360NRS y realizar env\u00edos de SMS. Si este token cae en manos equivocadas, cualquiera podr\u00eda enviar mensajes a trav\u00e9s de tu cuenta, generando costos no autorizados<\/strong> y potencialmente da\u00f1ando tu reputaci\u00f3n.<\/p>\n\n\n\n
\u274c Subir tu c\u00f3digo a un repositorio p\u00fablico (GitHub, GitLab, Bitbucket) sin ocultar el token.
\u274c Incluir el token directamente en el c\u00f3digo como un string (hardcoded).
\u274c Compartir el token en foros o documentaci\u00f3n sin darse cuenta.<\/p>\n\n\n\n
Almacenar credenciales en un archivo .env<\/code> es una pr\u00e1ctica est\u00e1ndar para evitar exponer datos sensibles en el c\u00f3digo fuente.<\/p>\n\n\n\ndotenv<\/code> para manejar variables de entorno:<\/p>\n\n\n\nnpm install dotenv
<\/code><\/pre>\n\n\n\nAUTH_TOKEN=TU_TOKEN_AQUI
<\/code><\/pre>\n\n\n\n.env<\/code>:<\/p>\n\n\n\nrequire('dotenv').config();
var axios = require('axios');
var config = {
method: 'post',
url: 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms',
headers: {
'Content-Type': 'application\/json',
'Authorization': `Basic ${process.env.AUTH_TOKEN}`
},
data: JSON.stringify({
\"to\": [\"34666555444\"],
\"from\": \"TEST\",
\"message\": \"Mensaje seguro\"
})
};
axios(config)
.then(response => console.log(\"SMS enviado con \u00e9xito:\", response.data))
.catch(error => console.error(\"Error al enviar SMS:\", error.message));
<\/code><\/pre>\n\n\n\n
Si despliegas tu aplicaci\u00f3n en Heroku, Vercel, AWS o cualquier otro servicio<\/strong>, puedes definir las variables de entorno desde la configuraci\u00f3n de la plataforma sin necesidad de un archivo .env<\/code>.<\/p>\n\n\n\n.env<\/code> al repositorio. Agrega .env<\/code> al archivo .gitignore<\/code> para evitar exponerlo accidentalmente.<\/p>\n\n\n\necho .env >> .gitignore<\/code><\/pre>\n\n\n\n 2. Maneja correctamente los errores y reintenta en caso de fallo<\/h3>\n\n\n\n
C\u00f3digo HTTP<\/th> Significado<\/th> Posible soluci\u00f3n<\/th><\/tr><\/thead> 400 Bad Request<\/code><\/td>Alguno de los par\u00e1metros es incorrecto.<\/td> Verifica que el n\u00famero tenga el formato correcto.<\/td><\/tr> 401 Unauthorized<\/code><\/td>Token de autenticaci\u00f3n incorrecto o caducado.<\/td> Aseg\u00farate de usar el token correcto en el encabezado.<\/td><\/tr> 429 Too Many Requests<\/code><\/td>Se ha excedido el l\u00edmite de solicitudes.<\/td> Implementa una estrategia de reintento con tiempo de espera.<\/td><\/tr> 500 Internal Server Error<\/code><\/td>Error en el servidor de 360NRS.<\/td> Reintenta despu\u00e9s de unos segundos.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
axios(config)
.then(response => {
console.log(\"SMS enviado con \u00e9xito:\", response.data);
})
.catch(error => {
if (error.response) {
console.error(\"Error en el env\u00edo:\", error.response.data);
} else if (error.request) {
console.error(\"No hubo respuesta del servidor:\", error.request);
} else {
console.error(\"Error desconocido:\", error.message);
}
});
<\/code><\/pre>\n\n\n\n
const enviarSMS = async (intentos = 3) => {
for (let i = 0; i < intentos; i++) {
try {
let response = await axios(config);
console.log(\"SMS enviado con \u00e9xito:\", response.data);
return;
} catch (error) {
console.error(`Intento ${i + 1} fallido:`, error.message);
if (i < intentos - 1) {
console.log(\"Reintentando en 5 segundos...\");
await new Promise(resolve => setTimeout(resolve, 5000));
} else {
console.error(\"No se pudo enviar el SMS despu\u00e9s de varios intentos.\");
}
}
}
};
enviarSMS();
<\/code><\/pre>\n\n\n\n3. Valida los n\u00fameros de tel\u00e9fono antes de enviarlos<\/h3>\n\n\n\n
+34<\/code>).<\/p>\n\n\n\n
\u274c Enviar n\u00fameros sin prefijo (666555444<\/code> en lugar de 34666555444<\/code>).
\u274c Usar caracteres no num\u00e9ricos.
\u274c N\u00fameros de tel\u00e9fono mal formateados.<\/p>\n\n\n\n
const validarNumero = (numero) => {
const regex = \/^\\d{10,15}$\/; \/\/ Acepta entre 10 y 15 d\u00edgitos
return regex.test(numero);
};
const numero = \"34666555444\";
if (validarNumero(numero)) {
console.log(\"N\u00famero v\u00e1lido. Procediendo con el env\u00edo...\");
} else {
console.error(\"N\u00famero inv\u00e1lido. Verifica el formato.\");
}
<\/code><\/pre>\n\n\n\n
\n\n\n\n Pr\u00f3ximos pasos<\/strong><\/h2>\n\n\n\n
\n
scheduleDate<\/code> para programar env\u00edos.<\/li>\n\n\n\nsub<\/code> para personalizar mensajes din\u00e1micamente.<\/li>\n<\/ul>\n\n\n\n\n
\n
GET https:\/\/dashboard.360nrs.com\/api\/rest\/sms\/<ID><\/code> para consultar el estado de un SMS.<\/li>\n\n\n\n![\"API](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2025\/03\/API-SMS-400x290.jpg\")
<\/a><\/div>\n API de env\u00edo de SMS<\/a><\/h4>\n
![\"Enviar](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2025\/02\/Enviar-SMS-con-Node.js-400x267.jpg\")
<\/a>\n![\"SMS](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2024\/11\/SMS-JAVA-400x267.jpg\")
<\/a>\n
![\"SMS](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2024\/11\/SMS-PYHTON-400x267.jpg\")
<\/a>\n![\"\"](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2025\/02\/Enviar-SMs-con-Shell-400x267.jpg\")
<\/a>\n![\"sms](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2021\/01\/sms-php-400x267.jpg\")
<\/a>\n![\"api](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2020\/10\/api-integracion-en-C-400x267.jpg\")
<\/a>\n