SDK SMS JAVA - Función envío de mensajes SMS

1. Descripción

Esta API Java te ofrece unas clases para poder realizar los envíos de SMS integrados en cualquier aplicación Java y en cualquier plataforma que disponga de una máquina virtual Java: Windows, Linux, Unix, Mac, etc...
Sólo tendrás que instanciar estas clases para poder de forma sencilla realizar envíos de SMS, obtener el saldo, lista de remitentes, etc...

2. Documentación

Localización de la librería JDescomSMS:
Copie la librería JDescomSMS.jar en una carpeta de su sistema para que pueda ser incluida dentro del Classpath de su línea de ejecución java.

 

Llamadas a la librería JDescomSMS para realizar un envío de SMS desde una aplicación Java.

Importación de clases :

import JDescomApi.*;
 

Creación del objeto e inicialización:

JDescomSendSMS JD
send;JDsend=new JDescomSendSMS();
 

Configurar datos de autenticación:

JDsend.autenticacion(usuario,clave,remitente,email_notificacion);
 

 

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
usuario Nombre de usuario de Descom SMS su usuario String
clave Su contraseña en Descom SMS Su contraseña String
remitente texto del remitente que quiere para enviar sus mensajes. (opcional)
Texto del remitente, 11 caracteres máximo. De ser un remitente disponible o registrado en su cuenta de Descom SMS.
String
email_notificación Email de Notificación configurado en su cuenta de Descom SMS (opcional)
Email de notificación para recibir las notificaciones de entrega por cada SMS. Debe estar registrado en su cuenta de Descom SMS.
String


 Configurar datos de envío:

//Número máximo de SMS por mensaje
JDsend.setMaxNumSMS(1);
//Establece el modo de envio en función del saldo disponible 
JDsend.setModoEnvio(1);
 


Añadir mensajes a enviar:

JDsend.AddMensaje(id,numero,texto,remitente_individual);
 

Donde:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
id Texto inicial Identificador del mensaje msg, id, etc... String
numero Número de teléfono destinatario del
mensaje
Teléfono en formato:
acceso internacional + cod. país + teléfono
Ejemplo: 0034666555444
String
Texto Texto del mensaje Texto del mensaje String
remitente_individual Remitente sólo para este mensaje es opcional. String


Por cada mensaje a enviar se ha de llamar a esta función con los datos de Identificador, Destino y Texto.

 

Envío de mensajes a plataforma:

JDsend.SendSMS(idenvio);
 

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
idenvio Texto identificador para el envío de todos los mensajes.
Sirve para agrupar los envíos y poder visualiar el informe agrupado.
texto alfanumérico de hasta 35 caracteres.
Si lo deja en blanco se generará uno aleatorio
String


Con esta función se establece la comunicación con nuestra plataforma y se procede a realizar la autenticación y posterior envío de mensajes.

LLAMADAS A LA LIBRERÍA PARA OBTENER LOS RESULTADOS DEL ENVÍO

Una vez enviados los mensajes estas funciones nos devolverán el resultado de autenticación y envío.

Número de mensajes enviados:

JDsend.getTotalMensajesEnviados();
 JDsend.getTotalMensajesEnviados_ok;
 JDsend.getTotalMensajesEnviados_error;
 

 

Resultado de la autenticación:

 JDsend.getResultado();
 

Si el resultado es 1 la autenticación es correcta, en caso contrario en .Comentario está la causa
del fallo de la autenticación.

Comentario de la autenticación:

JDsend.getComentario();
 


Saldo restante en la cuenta:

JDsend.getSaldo();
 


Para los mensajes enviados tenemos un iterador de mensajes

JDsend.getMensajesIterator();
 


Este iterador nos devolverá objetos de clase JDescomMensaje, donde para cada mensaje tenemos:

msg.getId();
 msg.getResultado();
 msg.getNumero();
 msg.getTexto();
 msg.getComentario();
 

Si el resultado es 1 el envío del mensaje es correcto, en caso contrario en .Comentario está la causa del fallo del envío.

Una vez finalizado el envío se ha de reinicializar la clase para borrar la bandeja de salida y reiniciar contadores:

JDsend.DeleteMensajes();
 

 

3. Ejemplos

Descargue un ejemplo en Java y sus fuentes para ver como implementar sus aplicaciones con nuetra librería JDescomSMS.

 

Pulse el botón de lanzar nuestra aplicación usando Java™ Web Start (descargar JDK 6).

jws-launch-button

Para ejecutar nuestro ejemplo en su sistema, debe de disponer algún JDK instalado. Si no lo tiene puede descargarlo de: JDK 6

Copie nuestras dos librerías, JDescomSMS_Ejemplo.jarJDescomSMS.jar en una carpeta de su sistema, por ejemplo, C:\tmp.

  • En entorno Windows, ejecute: 
    java   -classpath C:\tmp\JDescomSMS_Ejemplo.jar;C:\tmp\JDescomSMS.jar      JDescomSMS_Ejemplo
  • En entrono Linux,Unix, Mac, ejecute: 
    java   -classpath C:\tmp\JDescomSMS_Ejemplo.jar:C:\tmp\JDescomSMS.jar      JDescomSMS_Ejemplo

Esto le abrirá una ventana desde donde podrá probar el envío de mensajes con su usuario en Descom SMS.

 

 

4. Gráfico