SDK ASP, integrar el envío de SMS en las aplicaciones y desarrollos

 1. Descripción

El Interfaz ASP te permite enviar mensajes a teléfonos móviles, desde tu página web, utilizando desde un simple formulario hasta un sitio web avanzado con múltiples usuarios accediendo.

Tu página web tendrá que enviar la información necesaria para el envío de mensajes SMS al FrontEnd de la plataforma Descom SMS, a través de un servidor seguro, y esta se encargará de enviar el mensaje SMS.

2. Documentación

La clase dms_class.asp

La clase class_dms.asp, le permite integrar un su página Web el envío de mensajes SMS a teléfonos móviles. La clase tiene las propiedades y funciones necesarias para poder llevar a cabo está labor.

¿Como llamar a la Clase?

Incluiremos en nuestro código una llamada a la clase:

 <!--#include file="<strong>PATH</strong>\class_dms.asp"-->

Siendo PATH, el directorio donde se encuentre la clase class_dms.php

Para crear una instancia de la clase, lo haremos de la siguiente forma:

 set sms = new dms_send 

En este caso el objeto sms, tendrá todas la propiedades necesarias para realizar el envío.

 

Métodos y Funciones de la Clase

Métodos

  • mailError; en caso de un error, la clase nos enviará un mail a la cuenta que especifiquemos en este campo, indicandonos este hecho. Dejelo vacio si no requiere de estas notificaciones.
  • MaxSizeMessage; Es el tamaño máximo del mensaje que la clase va a manejar. Dejelo a Cero para no limitar el tamaño del mensaje.
  • autentificacion; Le permite configurar los datos de su cuenta y obtenr información de está.
  • mensajes; Este método le permite agregar los mensajes a enviar por SMS y tras ser enviado, revisar su estado.

Método Autentificacion

Este método, a su vez tiene los siguientes sub métodos:

  • username; donde le especificaremos el nombre de usuario de la cuenta en Descom con la que deseamos enviar los SMS.
  • autentificacion; es la contraseña de la cuenta con la que realizaremos el envío.
  • saldo; trás enviar los mensajes u obtener el saldo, en esta propiedad podremos ver el saldo actual de la cuenta.
  • error; Una variable Booleana que nos devolverá si la cuenta a autenticado o no en la plataforma de envíos de SMS.
  • mensajeerror; En caso de error, este campo nos devuelve la descripción del error.

Método Mensajes

Este método, nos permite agregar los mensajes en el envío y su posterior analisis de los resultados acarecidos.

Para agregar un mensaje, empleramos la siguiente función del método mensajes:

mensaje.add key, destino, mensaje, remitente

Esta es la explicación de los argumento de está función:

  • key; debe ser una clave única que nosotros asignemos, en cada envío solo podrá haber una única clave para cada mensaje.
  • destino;Teléfono destino con formato internacional "0034666555888"
  • mensajes; Texto del mensaje que deseamos enviar.
  • remitente; nos permite definir el remitente del mensaje, dejelo vación si quiere que aparezca el predeterminado.

Una vez enviemos los mensajes, si deseamos ver el resultado del envío de cada mensajes, llamaremos a la función mensajes.enviados.

Está función nos retornará una matriz con todos los mensajes que hemos intentado enviar. Cada elemento de está matriz, dispone de las siguiente propiedades:

  • key; será la misma key que asignamos al agregar el mensaje.
  • destino;Teléfono destino con formato internacional "0034666555888"
  • mensajes; Texto del mensaje que deseamos enviar.
  • error; Una variable Booleana que nos devolverá siel mensaje ha sido enviado o no.
  • mensajeerror; En caso de error, este campo nos devuelve la descripción del mismo.

 

Funciones

La clase proporciona las siguientes funciones:

  • Send; está función se encargará de enviar los mensjaes que previamente hemos agregado.
  • getSaldo; si únicamente queremos conocer el saldo actual sin enviar ningún mensaje, llamaremos a está función.

 

3. Ejemplos

Descarga nuestros ejemplos: ejemplo en ASP.

A continuación exponemos un pequeño ejemplo de uso de la clase:

<!--#include file="class_dms.asp"--> 
<%
'Configurar Envío SMS
set sms = new dms_send
'sms.mailError="Esta dirección de correo electrónico está siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo."
sms.autentificacion.username=usuario
sms.autentificacion.passwd=clave
'Componer Mensajes
sms.mensajes.add "1","003400000000","mensaje de prueba,""
'Enviar SMS
sms.Send
'Comprobando envío
if sms.autentificacion.error then    
    'Cuenta no autentificada    
    response.write("<font class='textoERR'>" & sms.autentificacion.mensajeerror & "</font>")
else    
    'Cuenta autentificada    
    response.write("<table align='center'><tr><td class='texto1'>Saldo: </td><td class='texto1'>" & sms.autentificacion.saldo & "</td></tr>")    
    'Lectura de los estados de envío de los mensajes    
    for each msg in sms.mensajes.enviados    
        if msg.error then          
            'Mensaje no enviado          
            response.write("<tr><td class='texto1'>Mensajes " & msg.key & " (" & msg.destino & "):</td><td class='textoERR'>" & msg.mensajeerror & "</td></tr>")     
        else          
            'Mensaje enviado           
            response.write("<tr><td class='texto1'>Mensajes " & msg.key & " (" & msg.destino & "):</td><td class='textoOK'>" & msg.mensajeerror & "</td></tr>")     
        end if
    next
    response.write("</table>")
end if
%>

4. Gráfico

interfaz ASP