Enviar SMS con Java - Ejemplos y Guía Completa
Ejemplos de código en Java para la API SMS de LabsMobile
A continuación se presentan los ejemplos de código de programación en lenguaje Java para enviar mensajes SMS a través de la API de la plataforma LabsMobile.
Esta documentación está diseñada para que puedas conectar tus aplicaciones con la plataforma LabsMobile y automatizar el envío de mensajes SMS. El principal objetivo de la integración de estas aplicaciones es el envío de mensajes SMS y comunicaciones relacionadas.
Consejo Recomendamos utilizar nuestra API SMS http/POST en formato JSON para cualquier integración con la plataforma LabsMobile. Pero tenemos otras versiones API que puedes utilizar según tu entorno y requisitos.
Con estos ejemplos podrás realizar la integración de las siguientes funcionalidades:
- Enviar mensajes SMS de forma individual o masiva.
- Consultar el saldo de tu cuenta.
- Recibir las notificaciones de confirmaciones de entrega y/o error que corresponden a los mensajes enviados.
- Obtener notificación y datos de los mensajes recibidos en los números virtuales contratados.
A tener en cuenta
La API SMS de LabsMobile utiliza una URL base común para todas las peticiones: https://api.labsmobile.com.
Es altamente recomendable emplear una URL que incluya el protocolo HTTPS en cualquier versión de la API.
La autenticación se realiza con el nombre de usuario y un token API, myUsername:myToken. Debes crear el token API desde la sección Configuración API de tu cuenta.
Enviar SMS con http/POST
Aquí tienes un ejemplo de código en lenguaje Java para enviar mensajes SMS utilizando la API SMS http/POST que utiliza el formato JSON para las variables de intercambio de información.
Como puedes observar, necesitas crear una estructura en formato JSON que contenga todos los parámetros necesarios para el envío y realizar una llamada HTTP/POST con estos datos en el cuerpo de la solicitud.
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
import com.mashape.unirest.http.exceptions.UnirestException;
public class App {
public static void main(String[] args) throws UnirestException {
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://api.labsmobile.com/json/send")
.header("Content-Type", "application/json")
.basicAuth("myUsername", "myToken")
.header("Cache-Control", "no-cache")
.body(
"{\"message\":\"Your verification code is 123\", \"tpoa\":\"Sender\",\"recipient\":[{\"msisdn\":\"12015550123\"}]}")
.asString();
System.out.println("Status code: " + response.getBody());
}
}
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
import com.mashape.unirest.http.exceptions.UnirestException;
public class App {
public static void main(String[] args) throws UnirestException {
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://api.labsmobile.com/json/send")
.header("Content-Type", "application/json")
.basicAuth("myUsername", "myToken")
.header("Cache-Control", "no-cache")
.body(
"{\"message\":\"Don't miss our Sale! Use code XXXX123 for 20% off.\", \"tpoa\":\"Sender\",\"recipient\":[{\"msisdn\":\"12015550123\"},{\"msisdn\":\"12015550124\"},{\"msisdn\":\"12015550125\"}]}")
.asString();
System.out.println("Status code: " + response.getBody());
}
}
{
"subid": "65f33a88ceb3d",
"code": "0",
"message": "Message has been successfully sent."
}
{
"subid": "65f7f7041385d",
"code": "35",
"message": "The account has no enough credit for this sending"
}
Es posible consultar todos los códigos de error en Documentación API, códigos de error.
Para obtener más detalles sobre los parámetros disponibles y las opciones de configuración, consulta la documentación oficial en:
Enviar SMS con http/GET
Este es un ejemplo de código en lenguaje Java para enviar mensajes SMS utilizando la API SMS http/GET.
Como podrás observar, debes pasar una serie de variables GET en la misma URL y realizar una llamada HTTP. Es importante codificar todos los valores como URL utilizando la función URLEncoder.encode().
Importante La API SMS http/GET transmite las credenciales (username y token API) sin cifrar y de forma no segura. Recomendamos utilizar esta API GET sólo cuando sea totalmente imprescindible y utilizar en su lugar la API SMS http/POST.
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
import com.mashape.unirest.http.exceptions.UnirestException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
public class App {
public static void main(String[] args) throws UnirestException, UnsupportedEncodingException {
String username = "myUsername";
String token = "myToken";
String message = "Your verification code is 123";
String[] msisdn = {"12015550123"};
String url = "https://api.labsmobile.com/get/send.php?username=" +
URLEncoder.encode(username, "UTF-8") +
"&password=" + URLEncoder.encode(token, "UTF-8") +
"&message=" + URLEncoder.encode(message, "UTF-8") +
"&msisdn=" + URLEncoder.encode(String.join(",", msisdn), "UTF-8");
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get(url).asString();
System.out.println("Status code: " + response.getBody());
}
}
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
import com.mashape.unirest.http.exceptions.UnirestException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
public class App {
public static void main(String[] args) throws UnirestException, UnsupportedEncodingException {
String username = "myUsername";
String token = "myToken";
String message = "Don't miss our Sale! Use code XXXX123 for 20% off.";
String[] msisdn = {"12015550123,12015550124,12015550125"};
String url = "https://api.labsmobile.com/get/send.php?username=" +
URLEncoder.encode(username, "UTF-8") +
"&password=" + URLEncoder.encode(token, "UTF-8") +
"&message=" + URLEncoder.encode(message, "UTF-8") +
"&msisdn=" + URLEncoder.encode(String.join(",", msisdn), "UTF-8");
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get(url).asString();
System.out.println("Status code: " + response.getBody());
}
}
{
"subid": "65f33a88ceb3d",
"code": "0",
"message": "Message has been successfully sent."
}
{
"subid": "65f7f7041385d",
"code": "35",
"message": "The account has no enough credit for this sending"
}
Es posible consultar todos los códigos de error en Documentación API, códigos de error.
Para obtener más detalles sobre los parámetros disponibles y las opciones de configuración, consulta la documentación oficial en:
Consulta de saldo de una cuenta
Con este ejemplo de código en Java se puede consultar el saldo de la cuenta utilizando la API SMS de LabsMobile
Mediante una llamada a este endpoint, puedes obtener información sobre la cantidad de créditos disponibles en tu cuenta de LabsMobile. La conexión se establece a través de una solicitud HTTP/GET con autenticación en el encabezado de la conexión HTTP.
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
import com.mashape.unirest.http.exceptions.UnirestException;
public class App {
public static void main(String[] args) throws UnirestException {
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://api.labsmobile.com/json/balance")
.header("Content-Type", "application/json")
.basicAuth("myUsername", "myToken")
.header("Cache-Control", "no-cache")
.body("")
.asString();
System.out.println("Status code: " + response.getBody());
}
}
{"code":0,"credits":"10"}
Consulta la documentación completa en:
Recibir estado de mensajes enviados
Este script de ejemplo recibe una llamada por parte de la plataforma LabsMobile cuando un mensaje SMS enviado cambia de estado. Para implementar esta solución, es esencial configurar los parámetros adecuados, la URL de confirmación en el parámetro ackurl en la petición o la URL por defecto en la Configuración API de tu cuenta.
Por tanto, es necesario publicar un script como este en tu sistema para que nuestra plataforma llame a la URL cuando ocurra un cambio de estado en cualquiera de los mensajes enviados.
El código de ejemplo obtiene los parámetros de la URL utilizando la variable global $_GET y luego asigna estos parámetros a variables locales.
import static spark.Spark.*;
public class App {
public static void main(String[] args) {
port(3000);
get("/", (req, res) -> {
String acklevel = req.queryParams("acklevel");
String credits = req.queryParams("credits");
String msisdn = req.queryParams("msisdn");
String status = req.queryParams("status");
String subid = req.queryParams("subid");
String timestamp = req.queryParams("timestamp");
System.out.println("Variable acklevel: " + acklevel);
System.out.println("Variable credits: " + credits);
System.out.println("Variable msisdn: " + msisdn);
System.out.println("Variable status: " + status);
System.out.println("Variable subid: " + subid);
System.out.println("Variable timestamp: " + timestamp);
return "";
});
}
}
Consulta la documentación completa en:
Recepción de mensajes SMS
Una vez contratado un número virtual, podrás recibir mensajes vía API en una URL específica mediante una llamada HTTP/GET a un script de tu sistema. Cada mensaje recibido invocará la URL, transmitiendo todos sus datos en variables en formato JSON
Para activar esta funcionalidad se debe informar la URL de recepción de mensajes en la Configuración de tu cuenta.
Es necesario configurar un endpoint en tu sistema para que la plataforma LabsMobile llame a este script cuando se reciba un SMS en cualquiera de los números virtuales contratados.
El código de ejemplo obtiene los parámetros de la URL utilizando la variable global $_GET y luego asigna estos parámetros a variables locales
import static spark.Spark.*;
public class App {
public static void main(String[] args) {
port(3000);
get("/", (req, res) -> {
String inbound_number = req.queryParams("inbound_number");
String service_number = req.queryParams("service_number");
String msisdn = req.queryParams("msisdn");
String message = req.queryParams("message");
String timestamp = req.queryParams("timestamp");
System.out.println("Variable inbound_number: " + inbound_number);
System.out.println("Variable service_number: " + service_number);
System.out.println("Variable msisdn: " + msisdn);
System.out.println("Variable message: " + message);
System.out.println("Variable timestamp: " + timestamp);
return "";
});
}
}
Consulta la documentación completa en:
Empieza Ahora a Enviar SMS con Java
Enviar SMS desde tu aplicación Java es fácil y rápido. Sigue estos pasos sencillos para crear tu cuenta, preparar el entorno y comenzar a enviar mensajes a tus clientes mediante la API de LabsMobile.
Paso 1: Crea tu Cuenta en LabsMobile
Regístrate. Visita la página oficial de LabsMobile: Crear cuenta. Confirma tu cuenta a través del correo de verificación que recibirás.
Accede a tu Panel de Control. Inicia sesión con tu usuario y contraseña. Dirígete a la sección “Configuración API” para obtener tu token API, necesarios para integrar tu aplicación JAVA.
Paso 2: Elige un método de integración
Selecciona entre:
- API http/POST (recomendado)
- API http/GET
- API Mail
Consulta y adapta el código de ejemplo que puedes encontrar en esta página.
Paso 3: Envía tu Primer SMS
Añade las credenciales. Personaliza el código JAVA con el username y token API de tu cuenta.
Crea y Personaliza tu Mensaje. Define el número de destino, el remitente y el contenido del mensaje. Opcionalmente activa el modo simulado para no consumir créditos con tus primeros envíos. Consulta todas las opciones y parámetros de envío en la página de documentación del método de integración elegido.
Envía y Verifica. Envía el mensaje y revisa el estado en el panel de control (en el apartado de Histórico) para confirmar su correcta entrega.
Importancia del Envío de SMS en Aplicaciones Java
Las aplicaciones Java destacan por su capacidad de ofrecer soluciones robustas y escalables. Integrar el envío de SMS es un componente clave para potenciar la comunicación y mejorar la interacción con los usuarios. Aquí te contamos por qué es fundamental:
Comunicación Directa y Efectiva
Los SMS garantizan que los usuarios reciban información relevante en tiempo real, sin depender de notificaciones en aplicaciones o correos electrónicos.
Mejora de la Experiencia del Usuario
Las aplicaciones que ofrecen notificaciones instantáneas generan una experiencia más personalizada y satisfactoria para los usuarios finales.
Versatilidad en Diferentes Sectores
Desde comercio electrónico hasta banca y servicios de entrega, el envío de SMS puede aplicarse a múltiples industrias para notificaciones, alertas y recordatorios.
Confiabilidad en la Entrega
Los SMS son independientes de la conexión a Internet y compatibles con cualquier dispositivo móvil. Garantizan que los mensajes se entreguen incluso en entornos de baja conectividad y con métricas de entrega.
Beneficios de Integrar SMS en Aplicaciones Java
Integrar SMS en tus aplicaciones Java proporciona una ventaja competitiva que mejora tanto la funcionalidad como el rendimiento de tu software. Descubre los beneficios clave:
Aumenta la Seguridad con 2FA
Los SMS permiten implementar autenticación de dos factores (2FA), fortaleciendo la seguridad y reduciendo el fraude.
Automatización y Eficiencia
Los SMS automatizados gestionan tareas como recordatorios de citas, confirmaciones de pedidos y actualizaciones de estado, ahorrando tiempo y costos operativos.
Mayor Fidelización de Clientes
Una comunicación rápida y personalizada a través de SMS mejora la relación con los usuarios y su lealtad hacia tu aplicación.
Fácil Integración Técnica
Java ofrece bibliotecas y APIs listas para integrar servicios de envío de SMS con LabsMobile, lo que facilita una implementación rápida y sin complicaciones.
Escalabilidad sin Límites
El envío masivo de SMS permite escalar campañas de marketing, alertas o notificaciones, adaptándose al crecimiento de tu negocio.
¡Optimiza tu Aplicación Java con SMS!
Incorpora el envío de SMS en tu aplicación Java y transforma la manera en que te comunicas con tus usuarios. Contáctanos para obtener más detalles sobre esta solución tecnológica.
Recursos de soporte
Recomendamos consultes y tengas en cuenta los siguientes recursos de soporte en tu integración:
- Descripción, manual y ejemplos de código de la API de envío SMS
- Guía técnica de un proceso de validación o autenticación OTP por SMS
- Todas las versiones y funcionalidades de la API de LabsMobile
- Tutorial primeros pasos de una integración API
- Crea una cuenta de prueba
- Recomendaciones y buenas prácticas en cualquier integración
- Plugins, módulos y extensiones
- ¿Necesitas ayuda? Contacta con nuestros técnicos
