{"id":5010,"date":"2022-11-16T09:55:00","date_gmt":"2022-11-16T09:55:00","guid":{"rendered":"https:\/\/www.360nrs.com\/blog\/?p=5010"},"modified":"2025-03-18T16:45:21","modified_gmt":"2025-03-18T16:45:21","slug":"api-enviar-sms-java","status":"publish","type":"post","link":"https:\/\/www.360nrs.com\/blog\/api-enviar-sms-java\/","title":{"rendered":"API para enviar SMS con Java"},"content":{"rendered":"\n

<\/p>\n\n\n\n

El env\u00edo de SMS es una funcionalidad clave para muchas aplicaciones que buscan comunicarse de forma directa y efectiva con sus usuarios.<\/p>\n\n\n\n

Gracias a la API de 360nrs<\/strong>, puedes integrar esta capacidad en tus proyectos escritos en Java<\/strong> de manera sencilla y eficiente.<\/p>\n\n\n\n

En este art\u00edculo, exploraremos c\u00f3mo realizar el env\u00edo de SMS utilizando Java con ejemplos pr\u00e1cticos y detallaremos los par\u00e1metros m\u00e1s importantes de la API.<\/p>\n\n\n\n

\n\n\n\n

Conoce nuestra a la API JAVA SMS<\/h2>\n\n\n\n

La API de 360nrs permite el env\u00edo de SMS mediante solicitudes HTTP POST a una URL espec\u00edfica. Para garantizar la seguridad, utiliza autenticaci\u00f3n mediante tokens. En el siguiente ejemplo pr\u00e1ctico, veremos c\u00f3mo enviar un SMS y gestionar respuestas del servidor, incluyendo mensajes aceptados, errores y detalles adicionales.<\/p>\n\n\n\n

\n\n\n\n

Ejemplo: Enviar SMS con Java API<\/h2>\n\n\n\n

Este ejemplo muestra c\u00f3mo configurar una solicitud HTTP POST para enviar un SMS mediante la API de 360nrs.<\/p>\n\n\n\n

C\u00f3digo de ejemplo<\/h3>\n\n\n\n

Descripci\u00f3n<\/strong>: El c\u00f3digo se conecta al endpoint de la API, env\u00eda los datos necesarios en formato JSON y procesa la respuesta.<\/p>\n\n\n\n

import java.io.DataOutputStream;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.URL;
import java.net.HttpsURLConnection;

public class App {
    public static void main(String[] args) {
        try {
            \/\/ Definir la URL de la API
            URL url = new URL(\"https:\/\/dashboard.360nrs.com\/api\/rest\/sms\");
            HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
            
            \/\/ Configuraci\u00f3n de la solicitud HTTP
            connection.setRequestMethod(\"POST\");
            connection.setRequestProperty(\"Authorization\", \"Basic YOUR_AUTH_TOKEN\");
            connection.setRequestProperty(\"Accept\", \"application\/json\");
            
            \/\/ Cuerpo de la solicitud
            String requestBody = \"{ \\\"to\\\": [\\\"34666555444\\\"], \\\"from\\\": \\\"TEST\\\", \\\"message\\\": \\\"SMS text message\\\" }\";
            
            \/\/ Enviar la solicitud
            connection.setDoOutput(true);
            DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
            wr.writeBytes(requestBody);
            wr.flush();
            wr.close();
            
            \/\/ Leer la respuesta
            BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
            String inputLine;
            StringBuffer response = new StringBuffer();
            
            while ((inputLine = in.readLine()) != null) {
                response.append(inputLine);
            }
            in.close();
            
            \/\/ Imprimir la respuesta
            System.out.println(response.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
<\/code><\/pre>\n\n\n\n
\n\n\n\n
Respuestas posibles del servidor<\/h2>\n\n\n\n
Respuesta exitosa (HTTP 202)<\/h3>\n\n\n\n
Cuando el mensaje se env\u00eda correctamente, la API devuelve el c\u00f3digo 202 (ACCEPTED)<\/strong> junto con un JSON detallado.<\/p>\n\n\n\n
{
  \"campaignId\": 100000,
  \"sendingId\": 100001,
  \"result\": [
    {
      \"accepted\": true,
      \"to\": \"34666555444\",
      \"id\": \"XXXXXXXXXXXXX\",
      \"parts\": 1,
      \"scheduledAt\": null,
      \"expiresAt\": null
    }
  ]
}
<\/code><\/pre>\n\n\n\n
Respuesta parcial (HTTP 207)<\/h3>\n\n\n\n
Si algunos mensajes fallan, el c\u00f3digo 207 (MULTI-STATUS)<\/strong> proporciona detalles sobre los n\u00fameros aceptados y los rechazados.<\/p>\n\n\n\n
{
  \"campaignId\": 100000,
  \"sendingId\": 100001,
  \"result\": [
    {
      \"accepted\": true,
      \"to\": \"34666555444\",
      \"id\": \"XXXXXXXXXXXXX\",
      \"parts\": 1,
      \"scheduledAt\": null,
      \"expiresAt\": null
    },
    {
      \"accepted\": false,
      \"to\": \"34\",
      \"error\": {
        \"code\": 102,
        \"description\": \"No valid recipients\"
      }
    }
  ]
}
<\/code><\/pre>\n\n\n\n
Respuesta de error (HTTP 400)<\/h3>\n\n\n\n
Si la solicitud contiene errores, se devuelve un mensaje de error con detalles.<\/p>\n\n\n\n
{
  \"error\": {
    \"code\": 102,
    \"description\": \"No valid recipients\"
  }
}
<\/code><\/pre>\n\n\n\n
\n\n\n\n
Par\u00e1metros de la solicitud<\/h2>\n\n\n\n
A continuaci\u00f3n, se explican los principales par\u00e1metros que puedes utilizar en la solicitud:<\/p>\n\n\n\n
Par\u00e1metro<\/th>Tipo<\/th>Obligatorio<\/th>Descripci\u00f3n<\/th><\/tr><\/thead>
message<\/strong><\/td>string<\/td>S\u00ed<\/td>Texto del mensaje (m\u00e1ximo 160 caracteres para mensajes no multiparte).<\/td><\/tr>
to<\/strong><\/td>array<\/td>S\u00ed<\/td>N\u00famero(s) de tel\u00e9fono de destino, con prefijo internacional (Ejemplo: 34666666666).<\/td><\/tr>
from<\/strong><\/td>string<\/td>S\u00ed<\/td>Remitente del mensaje (m\u00e1ximo 15 n\u00fameros o 11 caracteres alfanum\u00e9ricos).<\/td><\/tr>
encoding<\/strong><\/td>string<\/td>No<\/td>Codificaci\u00f3n del mensaje: gsm<\/code> (default) o utf-16<\/code>.<\/td><\/tr>
scheduleDate<\/strong><\/td>string<\/td>No<\/td>Fecha y hora programada para el env\u00edo en formato UTC (YYYYMMDDHHMMSS).<\/td><\/tr>
parts<\/strong><\/td>integer<\/td>No<\/td>N\u00famero m\u00e1ximo de partes del mensaje. Default: 1.<\/td><\/tr>
campaignName<\/strong><\/td>string<\/td>No<\/td>Nombre de la campa\u00f1a asociada al env\u00edo.<\/td><\/tr>
notificationUrl<\/strong><\/td>string\/array<\/td>No<\/td>URL donde se recibir\u00e1n notificaciones de entrega.<\/td><\/tr>
certified<\/strong><\/td>boolean<\/td>No<\/td>Define si el SMS es certificado (coste adicional).<\/td><\/tr>
otpConfig<\/strong><\/td>object<\/td>No<\/td>Configuraci\u00f3n para c\u00f3digos OTP, incluyendo longitud, alfanum\u00e9rico y validez.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n
Consideraciones importantes<\/h2>\n\n\n\n
    \n
  1. Autenticaci\u00f3n<\/strong>: Reemplaza \"YOUR_AUTH_TOKEN\"<\/code> con tu token de autenticaci\u00f3n proporcionado por 360nrs.<\/li>\n\n\n\n
  2. Formato de n\u00fameros<\/strong>: Aseg\u00farate de incluir el prefijo internacional para todos los n\u00fameros de tel\u00e9fono.<\/li>\n\n\n\n
  3. Codificaci\u00f3n<\/strong>: Si usas caracteres especiales o mensajes largos, configura adecuadamente el par\u00e1metro encoding<\/code>.<\/li>\n\n\n\n
  4. Errores comunes<\/strong>: Revisa cuidadosamente los errores devueltos para realizar ajustes en los par\u00e1metros de la solicitud.<\/li>\n<\/ol>\n\n\n\n
    <\/p>\n\n\n\n
    <\/p>\n\n\n\n
    Ejemplos pr\u00e1cticos de implementaci\u00f3n de SMS con Java<\/h2>\n\n\n\n
    A continuaci\u00f3n, te presentamos varios ejemplos pr\u00e1cticos para diferentes escenarios comunes al implementar el env\u00edo de SMS con Java<\/strong> utilizando la API de 360nrs<\/strong>. Cada caso incluye el c\u00f3digo necesario y una breve descripci\u00f3n de su funcionalidad.<\/p>\n\n\n\n
    \n\n\n\n
    Enviar un SMS b\u00e1sico a un \u00fanico destinatario<\/h3>\n\n\n\n
    Descripci\u00f3n<\/strong>: Este ejemplo env\u00eda un mensaje sencillo a un \u00fanico n\u00famero de tel\u00e9fono.<\/p>\n\n\n\n
    import java.io.DataOutputStream;
    import java.io.BufferedReader;
    import java.io.InputStreamReader;
    import java.net.URL;
    import java.net.HttpsURLConnection;

    public class SingleSMS {
        public static void main(String[] args) {
            try {
                URL url = new URL(\"https:\/\/dashboard.360nrs.com\/api\/rest\/sms\");
                HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
                connection.setRequestMethod(\"POST\");
                connection.setRequestProperty(\"Authorization\", \"Basic YOUR_AUTH_TOKEN\");
                connection.setRequestProperty(\"Accept\", \"application\/json\");
                
                \/\/ Cuerpo de la solicitud
                String requestBody = \"{ \\\"to\\\": [\\\"34666555444\\\"], \\\"from\\\": \\\"TEST\\\", \\\"message\\\": \\\"Hola, este es un mensaje de prueba\\\" }\";
                connection.setDoOutput(true);
                DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
                wr.writeBytes(requestBody);
                wr.flush();
                wr.close();
                
                \/\/ Leer la respuesta
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();
                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();
                
                System.out.println(\"Respuesta del servidor: \" + response.toString());
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
    <\/code><\/pre>\n\n\n\n
    \n\n\n\n
    2. Enviar un SMS a m\u00faltiples destinatarios<\/h3>\n\n\n\n
    Descripci\u00f3n<\/strong>: Este ejemplo env\u00eda el mismo mensaje a varios n\u00fameros de tel\u00e9fono.<\/p>\n\n\n\n
    public class MultiRecipientSMS {
        public static void main(String[] args) {
            try {
                URL url = new URL(\"https:\/\/dashboard.360nrs.com\/api\/rest\/sms\");
                HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
                connection.setRequestMethod(\"POST\");
                connection.setRequestProperty(\"Authorization\", \"Basic YOUR_AUTH_TOKEN\");
                connection.setRequestProperty(\"Accept\", \"application\/json\");
                
                \/\/ Cuerpo de la solicitud con m\u00faltiples destinatarios
                String requestBody = \"{ \\\"to\\\": [\\\"34666555444\\\", \\\"34666777888\\\"], \\\"from\\\": \\\"TEST\\\", \\\"message\\\": \\\"Mensaje para m\u00faltiples destinatarios\\\" }\";
                connection.setDoOutput(true);
                DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
                wr.writeBytes(requestBody);
                wr.flush();
                wr.close();
                
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();
                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();
                
                System.out.println(\"Respuesta del servidor: \" + response.toString());
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
    <\/code><\/pre>\n\n\n\n
    \n\n\n\n
    3. Enviar un SMS programado<\/h3>\n\n\n\n
    Descripci\u00f3n<\/strong>: Programa el env\u00edo de un mensaje para una fecha y hora espec\u00edfica en formato UTC.<\/p>\n\n\n\n
    public class ScheduledSMS {
        public static void main(String[] args) {
            try {
                URL url = new URL(\"https:\/\/dashboard.360nrs.com\/api\/rest\/sms\");
                HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
                connection.setRequestMethod(\"POST\");
                connection.setRequestProperty(\"Authorization\", \"Basic YOUR_AUTH_TOKEN\");
                connection.setRequestProperty(\"Accept\", \"application\/json\");
                
                \/\/ Programar un SMS
                String requestBody = \"{ \\\"to\\\": [\\\"34666555444\\\"], \\\"from\\\": \\\"TEST\\\", \\\"message\\\": \\\"Mensaje programado\\\", \\\"scheduleDate\\\": \\\"20231130143000\\\" }\";
                connection.setDoOutput(true);
                DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
                wr.writeBytes(requestBody);
                wr.flush();
                wr.close();
                
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();
                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();
                
                System.out.println(\"Respuesta del servidor: \" + response.toString());
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
    <\/code><\/pre>\n\n\n\n
    \n\n\n\n
    4. Enviar un SMS con un mensaje largo (multiparte)<\/h3>\n\n\n\n
    Descripci\u00f3n<\/strong>: Divide un mensaje largo en varias partes autom\u00e1ticamente. Se debe especificar el n\u00famero m\u00e1ximo de partes permitidas.<\/p>\n\n\n\n
    public class MultipartSMS {
        public static void main(String[] args) {
            try {
                URL url = new URL(\"https:\/\/dashboard.360nrs.com\/api\/rest\/sms\");
                HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
                connection.setRequestMethod(\"POST\");
                connection.setRequestProperty(\"Authorization\", \"Basic YOUR_AUTH_TOKEN\");
                connection.setRequestProperty(\"Accept\", \"application\/json\");
                
                \/\/ Mensaje largo que se dividir\u00e1 en m\u00faltiples partes
                String requestBody = \"{ \\\"to\\\": [\\\"34666555444\\\"], \\\"from\\\": \\\"TEST\\\", \\\"message\\\": \\\"Este es un mensaje muy largo que requiere ser dividido en m\u00faltiples partes autom\u00e1ticamente.\\\", \\\"parts\\\": 3 }\";
                connection.setDoOutput(true);
                DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
                wr.writeBytes(requestBody);
                wr.flush();
                wr.close();
                
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();
                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();
                
                System.out.println(\"Respuesta del servidor: \" + response.toString());
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
    <\/code><\/pre>\n\n\n\n
    \n\n\n\n
    5. Enviar un SMS con una URL de notificaci\u00f3n<\/h3>\n\n\n\n
    Descripci\u00f3n<\/strong>: Recibe actualizaciones sobre el estado de entrega del SMS en una URL espec\u00edfica.<\/p>\n\n\n\n
    public class SMSWithNotification {
        public static void main(String[] args) {
            try {
                URL url = new URL(\"https:\/\/dashboard.360nrs.com\/api\/rest\/sms\");
                HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
                connection.setRequestMethod(\"POST\");
                connection.setRequestProperty(\"Authorization\", \"Basic YOUR_AUTH_TOKEN\");
                connection.setRequestProperty(\"Accept\", \"application\/json\");
                
                \/\/ Notificaci\u00f3n de entrega en una URL espec\u00edfica
                String requestBody = \"{ \\\"to\\\": [\\\"34666555444\\\"], \\\"from\\\": \\\"TEST\\\", \\\"message\\\": \\\"Mensaje con notificaci\u00f3n\\\", \\\"notificationUrl\\\": \\\"https:\/\/miweb.com\/sms-notification\\\" }\";
                connection.setDoOutput(true);
                DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
                wr.writeBytes(requestBody);
                wr.flush();
                wr.close();
                
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();
                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();
                
                System.out.println(\"Respuesta del servidor: \" + response.toString());
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
    <\/code><\/pre>\n\n\n\n
    \n\n\n\n
    Estos ejemplos cubren distintos escenarios que puedes adaptar f\u00e1cilmente seg\u00fan tus necesidades. Cada implementaci\u00f3n muestra c\u00f3mo aprovechar las funcionalidades avanzadas de la API de 360nrs<\/strong> para gestionar el env\u00edo de SMS con Java<\/strong>.<\/p>\n\n\n\n
    <\/p>\n\n\n\n
    Ejemplos de servicios y aplicaciones <\/h2>\n\n\n\n
    Ejemplos de servicios y aplicaciones donde la integraci\u00f3n de SMS y JAVA puede ser \u00fatil.<\/p>\n\n\n\n
    1. Notificaciones de alertas en sistemas de monitoreo<\/h3>\n\n\n\n
    Aplicaci\u00f3n<\/strong>: Servicios como Nagios<\/strong>, Zabbix<\/strong> o sistemas personalizados de monitoreo pueden integrar el env\u00edo de SMS para alertar sobre problemas cr\u00edticos en servidores, aplicaciones o infraestructura.<\/p>\n\n\n\n
    Caso de uso<\/strong>:<\/p>\n\n\n\n