Habilitar el envío de mensajes de texto (SMS) a dispositivos móviles en Websphere Commerce

Este articulo muestra como habilitar el envío de mensajes SMS (Short Message Service) en la plataforma Websphere Commerce, haciendo uso de un SMS Gateway (Clickatell™). Websphere Commerce provee un Sistema de Mensajería el cual puede interactuar en distintos canales (en este caso con teléfonos celulares) para la notificación de los distintos eventos que ocurren en el sistema.

Oscar Escobar, Ingeniero en Informática, IBM

Oscar Escobar es Ingeniero en Informática egresado del Instituto Politécnico Nacional (México). Cuenta con una amplia experiencia en el desarrollo de aplicaciones utilizando Tecnologias Web 2.0, así como en el desarrollo de Aplicaciones Empresariales en la plataforma Java, enfocándose principalmente en el Sector Financiero. Actualmente se desempeña en la Unidad de Software Group de IBM México, como IT Specialist enfocado en los productos Websphere Application Server, Websphere Commerce y Websphere Portal.



07-10-2011

Visión General del Sistema de Mensajería de Websphere Commerce

El Sistema de Mensajería de Websphere Commerce permite controlar la manera en que los Administradores, Clientes, Sistemas Externos y Centros de Distribución son notificados de distintos eventos que ocurren. El Sistema de Entrada (mensajes recibidos de aplicaciones externas hacia Websphere Commerce) y el Sistema de Salida (mensajes enviados desde Websphere Commerce a Sistemas Externos) están soportados.

Sistema de mensajería de salida

  • Soporta distintos transportes: correo electrónico, archivos, HTML, Websphere MQ, Websphere InterChange Server, HTTP, Webservices sobre HTTP, Webservices sobre JMS, SMS-HTTP y SMS-WS
  • Soporta diferentes formatos: Texto plano, HTML, i-mode, XML
  • Ofrece una serie de mensajes de salida ya establecidos

Sistema de mensajería de entrada

  • Adaptadores que pueden recibir mensajes de diferentes transportes
    • El adaptador MQ recibe mensajes en formato XML de Websphere MQ
    • Adaptador que recibe mensajes XML y SOAP sobre HTTP
  • Los Adaptadores ejecutan comandos y devuelven respuestas
Arquitectura del Sistema de Mensajería
Arquitectura del Sistema de Mensajería
Arquitectura del Sistema de Mensajería de Salida
Arquitectura del Sistema de Mensajería de Salida

Los mensajes de entrada son utilizados para actualizar a Websphere Commerce con datos de una aplicación externa, como por ejemplo la actualización en el inventario de productos. Por otro lado, los mensajes de salida típicamente notifican a usuarios u otras aplicaciones de cambios en Websphere Commerce, como por ejemplo: una nueva orden, una promoción ó el restablecimiento de una contraseña.

Habilitando el Sistema de Mensajería por el transporte SMS amplía el acceso multicanal, ofreciendo capacidades de dispositivos móviles en WebSphere Commerce.

Transporte SMS

  • Implementado con el adaptador JCA
  • Únicamente de salida
  • Configurado en la consola de administración
  • Requiere un proveedor de mensajería (SMS Gateway)
    • HTTP API
    • Especificación Web Services 3.0

El Servicio de Mensajería SMS requiere un proveedor para poder ser habilitado. Algunos proveedores que soportan HTTP incluyen:

El método de transporte mostrado en este artículo será SMS-HTTP utilizando Clickatell™ como SMS Gateway. Como se mencionó anteriormente, este tipo de comunicación será en un solo sentido, es decir Websphere Commerce podrá enviar mensajes de salida, pero no podrá recibir mensajes de entrada.

Parámetros a configurar en el transporte SMS-HTTP
AtributoDescripción
APIKey El nombre del parámetro del identificador de API
APIValue El identificador de la API de servicio exclusivo asociado a la cuenta
CharacterLimit El número máximo de caracteres de un mensaje. El valor predeterminado es 160
CustomParameters Parámetros adicionales a pasar a la API HTTP.
Nota: Estos parámetros de URL deben codificarse manualmente
Endpoint La ubicación de URL de la API HTTP del servicio de telecomunicaciones
MaxRecipients El número máximo de destinatarios enviados a la pasarela en una sola solicitud. Para las pasarelas que no dan soporte al sistema de mensajería masivo, el valor debe establecerse en 1
MessageKey El nombre de parámetro del identificador de Message
MessageValue El mensaje predeterminado si no se sustituye por un archivo JSP personalizado
Password La contraseña utilizada para la autenticación con el servicio. Las contraseñas se almacenan como valores cifrados utilizando la clave del comerciante
PasswordKey El nombre de parámetro del identificador de Password
RecipientDelimiter El carácter delimitador para varios destinatarios en el parámetro recipient
RecipientKey El nombre de parámetro del identificador de Recipient
RecipientValue El número de destino de los destinatarios
SenderKey El nombre de parámetro del identificador de Sender
SenderValue El nombre o número del remitente
usePostMethod Indica si se utiliza el método HTTP-POST. Si el valor es false, se utiliza el método HTTP-GET
UserNameKey El nombre de parámetro del identificador de UserName
UserNameValue La identificación de UserName para el servicio

Procedimiento.

Acceder a la consola de Administración de Websphere Commerce, utilizando un usuario administrador. (ya sea a nivel sitio o a nivel tienda).

Dentro del menú Configuration, elegir la opción Transports

Activar el transporte SMS HTTP

Configurar el transporte SMS HTTP, ingresando los parámetros del Gateway SMS (Para este ejemplo, se utilizó Clickatell™)

La siguiente imagen es parte de la consola de Administración de Clickatell™, solo se muestra para fines informativos y para ver la correspondencia de los parámetros entre la consola de Websphere Commerce y la de Clickatell™. Previamente se tuvo que crear una cuenta y comprar créditos para poder hacer uso de la API.

Asignar el tipo de mensaje al transporte SMS HTTP

En el menú Configuration, ingresar a la opción Message Types

Agregar un nuevo mensaje, especificando el tipo de mensaje (dependiendo de la acción que queremos notificar) el método de transporte SMS HTTP (previamente configurado) y el formato del dispositivo como SMS messages

Por último, presionamos Finalizar en la pantalla de Resumen

Para que los cambios tengan efecto, es necesario reiniciar la instancia de Websphere Commerce.

Nota. Los simuladores de dispositivos móviles no son capaces de recibir mensajes SMS, por lo que si se quiere realizar la prueba de la configuración, es necesario contar con el dispositivo móvil de manera física. Una prueba sencilla que se puede realizar (fuera del Sistema de Mensajería de Websphere Commerce) es realizando una petición en un navegador de Internet, con la siguiente URL.

http://api.clickatell.com/http/sendmsg?api_id=3265188&user=oescobar&text=Hello+Websphere+Commerce+SMS&queue=1&concat=2&password=somePassword&to=some_phone

Si el envío es satisfactorio, (además de recibir el mensaje en nuestro celular) nos muestra la siguiente pantalla, con el ID que fue asignado por el envío del mensaje.


Con el paso anterior, nos aseguramos que la API de nuestro Gateway SMS está funcionando correctamente y podrá enviar los mensajes que son generados desde Websphere Commerce. Ahora, nosotros también podemos monitorear los mensajes que han sido enviados, archivados y cuales están pendientes. Esto es posible hacerlo en la consola Administrativa de Websphere Commerce en el menú Monitoring.

Por último para que nuestros clientes reciban notificaciones de los eventos que previamente configuramos, es necesario crear una nueva cuenta en la tienda en linea y habilitar el envío de mensajes a nuestro teléfono celular.

Creación de la cuenta

Comprar un producto y hacer checkout

Con este pasó recibiremos un mensaje SMS a nuestro dispositivo móvil con el número de orden que fue asignado a nuestra compra.

Conclusión

En este articulo se mostró como integrar el Sistema de Mensajería de Websphere Commerce, utilizando el método de transporte SMS con un Gateway SMS. Websphere Commerce provee un Sistema de Mensajería el cual puede interactuar en distintos canales (en este caso con teléfonos celulares) para la notificación de los distintos eventos que ocurren en el sistema.

Referencias

IBM WebSphere Commerce 7 Product Documentation
http://publib.boulder.ibm.com/infocenter/wchelp/v7r0m0/index.jsp

Clickatell™
http://www.clickatell.com

Configuration of transport services used for a message (En inglés)
http://publib.boulder.ibm.com/infocenter/wchelp/v7r0m0/index.jsp?topic=%2Fcom.ibm.commerce.integration.doc%2Frefs%2Frcvomin4.htm

Enabling and configuring the SMS transport (En inglés)
http://publib.boulder.ibm.com/infocenter/wchelp/v7r0m0/index.jsp?topic=%2Fcom.ibm.commerce.integration.doc%2Ftasks%2Ftcvsmstransenconf.htm

Comentarios

developerWorks: Ingrese

Los campos obligatorios están marcados con un asterisco (*).


¿Necesita un IBM ID?
¿Olvidó su IBM ID?


¿Olvidó su Password?
Cambie su Password

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


La primera vez que inicie sesión en developerWorks, se creará un perfil para usted. La información en su propio perfil (nombre, país/región y nombre de la empresa) se muestra al público y acompañará a cualquier contenido que publique, a menos que opte por la opción de ocultar el nombre de su empresa. Puede actualizar su cuenta de IBM en cualquier momento.

Toda la información enviada es segura.

Elija su nombre para mostrar



La primera vez que inicia sesión en developerWorks se crea un perfil para usted, teniendo que elegir un nombre para mostrar en el mismo. Este nombre acompañará el contenido que usted publique en developerWorks.

Por favor elija un nombre de 3 - 31 caracteres. Su nombre de usuario debe ser único en la comunidad developerWorks y debe ser distinto a su dirección de email por motivos de privacidad.

Los campos obligatorios están marcados con un asterisco (*).

(Por favor elija un nombre de 3 - 31 caracteres.)

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


Toda la información enviada es segura.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=90
Zone=WebSphere
ArticleID=764002
ArticleTitle=Habilitar el envío de mensajes de texto (SMS) a dispositivos móviles en Websphere Commerce
publish-date=10072011