Shell<\/code> y cURL<\/code> es una soluci\u00f3n r\u00e1pida y eficiente para notificaciones, alertas o integraciones automatizadas<\/strong>. Gracias a la API de 360NRS<\/strong>, puedes enviar mensajes a m\u00faltiples destinatarios desde scripts o servidores sin necesidad de interfaces gr\u00e1ficas.<\/p>\n\n\n\nEn este art\u00edculo, aprender\u00e1s a usar la API de 360NRS<\/strong> con cURL<\/code>, a manejar respuestas y errores de la API, y a implementar buenas pr\u00e1cticas para garantizar un uso seguro y eficiente del servicio.<\/p>\n\n\n\nSi buscas una forma sencilla y efectiva<\/strong> de enviar SMS desde la terminal de Linux, \u00a1este tutorial es para ti! \ud83d\ude80<\/p>\n\n\n\n
\n\n\n\nRequisitos previos para enviar SMS con Shell<\/h2>\n\n\n\n
Antes de comenzar, aseg\u00farate de contar 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>.
\ud83d\udd39 Obtener el Token de Autenticaci\u00f3n<\/strong>: Necesario para autenticarte en la API.
\ud83d\udd39 Tener cURL instalado<\/strong>: Para comprobar si est\u00e1 instalado, ejecuta en la terminal:<\/p>\n\n\n\ncurl --version
<\/code><\/pre>\n\n\n\nSi no est\u00e1 instalado, puedes hacerlo con:<\/p>\n\n\n\n
\n- Ubuntu\/Debian<\/strong>:
sudo apt install curl<\/code><\/li>\n\n\n\n- CentOS\/Fedora<\/strong>:
sudo dnf install curl<\/code><\/li>\n\n\n\n- MacOS (Homebrew)<\/strong>:
brew install curl<\/code><\/li>\n<\/ul>\n\n\n\n<\/p>\n\n\n\n
Una vez que tengas cURL<\/strong> listo, \u00a1ya podemos comenzar! <\/p>\n\n\n\n
\n\n\n\nC\u00f3mo funciona la API SMS de 360NRS con Shell<\/h2>\n\n\n\n
La API de 360NRS permite enviar SMS mediante solicitudes HTTP POST<\/code>. Aqu\u00ed tienes lo m\u00e1s importante que debes saber:<\/p>\n\n\n\n\ud83d\udccc Endpoint de la API:<\/strong><\/p>\n\n\n\nPOST https:\/\/dashboard.360nrs.com\/api\/rest\/sms
<\/code><\/pre>\n\n\n\n Par\u00e1metros principales:<\/strong><\/p>\n\n\n\nPar\u00e1metro<\/th> Tipo<\/th> Obligatorio<\/th> Descripci\u00f3n<\/th><\/tr><\/thead> to<\/code><\/td>Array<\/td> \u2705 S\u00ed<\/td> N\u00famero(s) de tel\u00e9fono con prefijo internacional.<\/td><\/tr> from<\/code><\/td>String<\/td> \u2705 S\u00ed<\/td> Remitente del SMS (m\u00e1ximo 11 caracteres alfanum\u00e9ricos).<\/td><\/tr> message<\/code><\/td>String<\/td> \u2705 S\u00ed<\/td> Texto del SMS (m\u00e1ximo 160 caracteres).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n\ud83d\udd39 Ejemplo de una petici\u00f3n exitosa:<\/strong><\/p>\n\n\n\n\n- El servidor responder\u00e1 con 202 ACCEPTED<\/strong> si el mensaje se ha enviado correctamente.<\/li>\n<\/ul>\n\n\n\n
\n\n\n\n C\u00f3digo para enviar SMS con Shell y cURL<\/h2>\n\n\n\nEjemplo b\u00e1sico<\/h3>\n\n\n\n
Para enviar un SMS con cURL<\/code>, ejecuta el siguiente comando en la terminal:<\/p>\n\n\n\ncurl -X POST 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms' \\
-H 'Content-Type: application\/json' \\
-H 'Authorization: Basic YOUR_AUTH_TOKEN' \\
-d '{
\"to\": [\"34666555444\"],
\"from\": \"TEST\",
\"message\": \"Mensaje de prueba desde Shell\"
}'
<\/code><\/pre>\n\n\n\nExplicaci\u00f3n del c\u00f3digo:<\/strong>
\u2714\ufe0f -X POST<\/code>: Indica que estamos haciendo una solicitud HTTP POST<\/code>.
\u2714\ufe0f -H 'Content-Type: application\/json'<\/code>: Especifica que enviamos datos en formato JSON.
\u2714\ufe0f -H 'Authorization: Basic YOUR_AUTH_TOKEN'<\/code>: Autenticaci\u00f3n con un token. Sustituye \u00abYOUR_AUTH_TOKEN\u00bb por el tuyo<\/strong>.
\u2714\ufe0f -d '{}'<\/code>: Cuerpo de la solicitud, donde se definen to<\/code>, from<\/code> y message<\/code>.<\/p>\n\n\n\nSi todo est\u00e1 correcto, recibir\u00e1s una respuesta con el c\u00f3digo 202 ACCEPTED<\/strong>.<\/p>\n\n\n\n
\n\n\n\nManejo de respuestas y errores de la API<\/h2>\n\n\n\nRespuestas posibles de la API<\/h3>\n\n\n\nC\u00f3digo HTTP<\/th> Significado<\/th> Posible soluci\u00f3n<\/th><\/tr><\/thead> 202 ACCEPTED<\/code><\/td>El SMS se ha enviado correctamente.<\/td> No es necesario hacer nada.<\/td><\/tr> 207 MULTI-STATUS<\/code><\/td>Algunos mensajes se enviaron y otros fallaron.<\/td> Revisa los detalles en la respuesta.<\/td><\/tr> 400 BAD REQUEST<\/code><\/td>Error en la solicitud (par\u00e1metro incorrecto).<\/td> Verifica los datos enviados.<\/td><\/tr> 401 UNAUTHORIZED<\/code><\/td>Error en la autenticaci\u00f3n.<\/td> Comprueba tu token.<\/td><\/tr> 429 TOO MANY REQUESTS<\/code><\/td>Se ha superado el l\u00edmite de env\u00edos.<\/td> Espera y reintenta m\u00e1s tarde.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n\ud83d\udd39 Ejemplo de c\u00f3mo capturar la respuesta y mostrar el resultado en Shell:<\/strong><\/p>\n\n\n\nresponse=$(curl -s -X POST 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms' \\
-H 'Content-Type: application\/json' \\
-H 'Authorization: Basic YOUR_AUTH_TOKEN' \\
-d '{\"to\":[\"34666555444\"], \"from\":\"TEST\", \"message\":\"Mensaje de prueba\"}')
echo \"Respuesta de la API: $response\"
<\/code><\/pre>\n\n\n\n\ud83d\udccc El -s<\/code> suprime la barra de progreso de cURL, haciendo la salida m\u00e1s limpia.<\/strong><\/p>\n\n\n\n
\n\n\n\nFunciones avanzadas en el env\u00edo de SMS<\/h2>\n\n\n\nProgramar un env\u00edo de SMS<\/h3>\n\n\n\n
Para programar un mensaje a una fecha espec\u00edfica, usa el par\u00e1metro scheduleDate<\/code>:<\/p>\n\n\n\ncurl -X POST 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms' \\
-H 'Content-Type: application\/json' \\
-H 'Authorization: Basic YOUR_AUTH_TOKEN' \\
-d '{
\"to\": [\"34666555444\"],
\"from\": \"TEST\",
\"message\": \"Mensaje programado\",
\"scheduleDate\": \"20250215142000\"
}'
<\/code><\/pre>\n\n\n\nEsto enviar\u00e1 el SMS el 15 de febrero de 2025 a las 14:20:00 UTC.<\/strong><\/p>\n\n\n\nUsar variables personalizadas en los SMS<\/h3>\n\n\n\ncurl -X POST 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms' \\
-H 'Content-Type: application\/json' \\
-H 'Authorization: Basic YOUR_AUTH_TOKEN' \\
-d '{
\"to\": [\"34666555444\"],
\"from\": \"TEST\",
\"message\": \"Hola {name}\",
\"sub\": [{\"name\": \"Juan\"}]
}'
<\/code><\/pre>\n\n\n\n\ud83d\udccc El receptor ver\u00e1:<\/strong> \"Hola Juan\"<\/code><\/p>\n\n\n\n
\n\n\n\nConsultar el estado de un SMS enviado<\/h2>\n\n\n\n
Para verificar el estado de un mensaje enviado, usa su ID<\/code>:<\/p>\n\n\n\ncurl -X GET 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms\/XXXXXXXXXXXXX' \\
-H 'Content-Type: application\/json' \\
-H 'Authorization: Basic YOUR_AUTH_TOKEN'
<\/code><\/pre>\n\n\n\n\ud83d\udccc Sustituye XXXXXXXXXXXXX<\/code> por el ID del mensaje.<\/strong><\/p>\n\n\n\n
\n\n\n\nBuenas pr\u00e1cticas en el uso de la API SMS con Shell<\/h2>\n\n\n\n
No expongas tu Authorization Token<\/code><\/strong> en c\u00f3digo p\u00fablico. Usa variables de entorno:<\/p>\n\n\n\nexport AUTH_TOKEN=\"TU_TOKEN\"
<\/code><\/pre>\n\n\n\nImplementa reintentos en caso de fallos:<\/strong><\/p>\n\n\n\nfor i in {1..3}; do
response=$(curl -s -X POST 'https:\/\/dashboard.360nrs.com\/api\/rest\/sms' -H 'Authorization: Basic YOUR_AUTH_TOKEN' -d '{}')
echo \"Intento $i: $response\"
[[ \"$response\" == *\"202 ACCEPTED\"* ]] && break
sleep 5
done
<\/code><\/pre>\n\n\n\nValida los n\u00fameros antes de enviarlos:<\/strong><\/p>\n\n\n\nif [[ \"$numero\" =~ ^[0-9]{10,15}$ ]]; then
echo \"N\u00famero v\u00e1lido: $numero\"
else
echo \"N\u00famero inv\u00e1lido.\"
fi
<\/code><\/pre>\n\n\n\n
\n\n\n\n<\/p>\n\n\n\n
El uso de Shell<\/code> y cURL<\/code> para enviar SMS mediante la API de 360NRS proporciona una soluci\u00f3n simple pero extremadamente poderosa para automatizar comunicaciones. Esta integraci\u00f3n resulta especialmente \u00fatil en entornos donde se requiere el env\u00edo de notificaciones automatizadas, como servidores, sistemas de monitoreo y aplicaciones empresariales. Gracias a su flexibilidad, es posible programar env\u00edos masivos, personalizar los mensajes con variables din\u00e1micas y consultar en tiempo real el estado de los SMS enviados.<\/p>\n\n\n\nUna de las grandes ventajas de este m\u00e9todo es su compatibilidad con cualquier sistema basado en Linux, sin necesidad de instalar software adicional. Esto lo hace ideal para administradores de sistemas, desarrolladores y empresas que buscan optimizar sus flujos de trabajo sin depender de interfaces gr\u00e1ficas. Adem\u00e1s, al utilizar cURL<\/code>, se mantiene un control total sobre las peticiones HTTP, permitiendo capturar respuestas y gestionar errores de manera eficiente.<\/p>\n\n\n\nSin embargo, como en cualquier integraci\u00f3n con APIs, es fundamental seguir buenas pr\u00e1cticas para garantizar un uso seguro y eficiente del servicio. Proteger el Authorization Token<\/code> es clave para evitar accesos no autorizados, as\u00ed como validar correctamente los n\u00fameros de tel\u00e9fono antes de enviarlos para evitar fallos en la API. Tambi\u00e9n es recomendable implementar un sistema de reintento en caso de errores temporales o respuestas no esperadas, asegurando la entrega efectiva de los mensajes.<\/p>\n\n\n\nCon esta gu\u00eda, ya tienes las bases para implementar el env\u00edo de SMS desde Shell de manera profesional. Desde aqu\u00ed, puedes mejorar la integraci\u00f3n a\u00f1adiendo bases de datos para gestionar contactos, automatizar campa\u00f1as de mensajer\u00eda o incluso desarrollar sistemas de notificaciones en tiempo real. Las posibilidades son enormes y con las herramientas adecuadas, puedes hacer que la comunicaci\u00f3n automatizada sea una parte esencial de tu infraestructura digital.<\/p>\n\n\n\n
Tambi\u00e9n te puede interesar<\/strong>:<\/p>\n\n\n\n\n
![\"API](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2025\/03\/API-SMS-400x290.jpg\")
<\/a><\/div>\n\n API de env\u00edo de SMS<\/a><\/h4>\nCon nuestra API SMS, puedes integrar f\u00e1cilmente el env\u00edo de mensajes de texto en tu aplicaci\u00f3n o sistema, ya sea en PHP, Java, Python u otros lenguajes de programaci\u00f3n. Optimiza la comunicaci\u00f3n con tus clientes a trav\u00e9s de una soluci\u00f3n robusta, flexible y altamente escalable. Automatiza tu comunicaci\u00f3n con una API dise\u00f1ada para ofrecer entrega r\u00e1pida y confiable.\nAPI SMS <\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n![\"Enviar](\"https:\/\/www.360nrs.com\/blog\/wp-content\/uploads\/2025\/02\/Enviar-SMS-con-Node.js-400x267.jpg\")
<\/a>\nAPI para enviar SMS con Node.js<\/a><\/p><\/div><\/div>\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