ndice de contenido

Introduccin .................................................................................................................. 2 Servicio de mensajera online a travs de compaas de telefona celular ................... 3 Movistar .................................................................................................................... 3 Personal ..................................................................................................................... 4 Claro .......................................................................................................................... 5 Aplicacin Android SMSGratisArgentina .................................................................... 6 Tecnologa IP SMS [2] ................................................................................................. 8 Adhoc ........................................................................................................................ 9 SMSMasivos ............................................................................................................. 9 MovilGate.................................................................................................................. 9 Gua para la implementacin de aplicaciones de mensajera SMS a travs de una aplicacin Java ............................................................................................................ 11 Gua para la implementacin de Servicios Web para recibir mensajes desde una aplicacin Java ............................................................................................................ 13 ANEXO 1 ................................................................................................................... 16 SMS Masivos .............................................................................................................. 16 Anexo 2: presupuesto e informacin correspondiente de las compaas consultadas 32 Movil Gate............................................................................................................... 32 SMS Masivos .......................................................................................................... 33 Ad Hoc diseo y contenidos.................................................................................... 37 Referencias ................................................................................................................. 38

Introduccin
El servicio de mensajes cortos o SMS (Short Message Service) es un servicio disponible en los telfonos celulares que permite el envo de mensajes de texto entre equipos mviles. Enviar mensajes de texto SMS tiene muchas ventajas. Es discreto, ms barato que hacer una llamada, toma menos tiempo y puede ser enviado y recibido en cualquier momento. En los ltimos aos el uso de SMS se ha multiplicado de manera exponencial gracias al crecimiento tecnolgico, bajo costo de los equipos y servicios de telefona celular. Dos tercios de la poblacin mundial tienen acceso a los SMS (ms de 4 billones de personas) lo que ha convertido a estos simples mensajes de texto en una herramienta de comunicacin de alcance masivo. Es por esta razn que hoy en da los mensajes que viajan por la red GSM suelen ser enviados por sistemas de computadora. Algunas empresas utilizan los servicios para enviar promociones y notificaciones a sus usuarios. Otras utilizan la tecnologa para ofrecer suscripciones a servicios de descarga de contenidos de texto o multimedia. En la industria los SMS se utilizan para controlar maquinaria de forma remota e incluso existen aplicaciones de home automation para activar aspersores o abrir portones automticos utilizando una central GSM ubicada dentro de una residencia. Con la aparicin de los celulares Smart el alcance de los SMS se ha expandido. Puede enviarse informacin posicional, climtica y notificaciones de aplicaciones, entre otras utilizando la misma tecnologa que antes enviaba solo texto escrito manualmente por el usuario. Adicionalmente, se pueden utilizar celulares Smart para obtener informacin y mantener una base de datos la cual puede ser consultada a travs de SMS o de aplicaciones de computadora sin necesidad de invertir una gran suma de dinero. Este trabajo es el resultado de haber implementado un sistema de comunicacin va SMS a travs de aplicaciones desarrolladas en Java, las cuales pueden extender su funcionalidad para obtener informacin de una base de datos y enviarla por medio de mensajes de texto. Para la implementacin se evaluaron distintas opciones provistas por las compaas de telefona celular argentinas, aplicaciones Android y servicios de compaas de comunicacin masiva a travs de GSM online. En este documento se encuentra detallada la evaluacin de las mismas y una gua de implementacin de aplicaciones Java utilizando la tecnologa ms adecuada.

Servicio de mensajera online a travs de compaas de telefona celular

Movistar Movistar Argentina ofrece un servicio de SMS online que permite:

Enviar y recibir mensajes en cualquier PC. Guardar o Eliminar tus contactos. Consultar tus mensajes recibidos y enviados. Crear tus grupos (amigos, trabajo, colegio y ms) para poder enviar y responder un mensaje de una nica vez a todos. Consultar en cualquier momento la ayuda. Cambiar tus datos personales. Definir de quin desea recibir e mails. Enviar mensajes a clientes Movistar (Pblico). Definir si desea recibir mensajes desde la web (Pblico).

Este servicio es exclusivo para clientes Movistar y se accede desde la web a travs del sitio de la compaa [1]. El precio del servicio SMS Online y Email Full es de $0,49 por mensaje enviado/recibido con impuestos incluidos por cualquiera de los mencionados servicios.

Figura 1: Interfaz de usuario del sistema SMS Online de Movistar Argentina. Adicionalmente, la compaa dispone de un servicio para enviar sms desde e-mail. La direccin de los usuarios es: nmero de telfono(sin 0 y sin 15)@movistar.net.ar. Este servicio tiene una demora despreciable y tiene un costo de $0.45 para la lnea receptora. Las operadoras Personal y Claro disponen del mismo servicio.
Personal

Personal Argentina ofrece el servicio de SMS online que permite enviar Mensajes de Texto a
una lnea Personal desde el sitio web de la compaa sin necesidad de tener cuenta de usuario. El Servicio se encuentra disponible para todos los mercados, a nivel nacional. Para hacer uso del Servicio desde el sitio web no se requiere que el emisor sea cliente de Personal, sin embargo, el receptor de SMS online deber disponer de una lnea habilitada de Personal, con el servicio Mensajes Personal (SMS) activo. Este servicio no representa costos para el receptor al recibir un SMS pero si se cobra una pequea tarifa al contestar los mensajes ya que se cobra el uso del servicio.

Figura 2: Interfaz de usuario del sistema SMS Online de Personal Argentina.

Claro

Claro Argentina permite nicamente a sus usuarios acceder al servicio aunque la autentificacin que solicita es la de un nmero Claro como remitente.

Figura 3- Interfaz de usuario del sistema SMS Online de Personal Argentina.

Aplicacin Android SMSGratisArgentina

Es una aplicacin para smartphones para enviar mensajes de texto de forma gratuita para el emisor. Esta aplicacin permite Enviar mensajes de texto Gratis a usuarios de cualquier compaa de Argentina. Los sms se envian utilizando Wi-fi o un plan de datos. Importar los contactos directamente desde la agenda. Recibir los mensajes de respuesta directamente en SMS Argentina (similar al registro de conversaciones de whatsapp). Modo conversacin con el historial de todos los mensajes enviados y recibidos. Widgets para tener acceso inmediato a los contactos favoritos. Los contactos reciben siempre el mensaje, sin importar si no tienen smartphone o internet, ya que reciben un mensaje de texto tradicional.

Figura 4- Interfaz de usuario de la aplicacin para smartphones SMSGratisArgentina. Actualmente los SMS son enviados mediante las webs de cada una de las empresas. La aplicacin realiza la accin que hara un usuario comn al enviar un SMS mediante la web de la empresa, pero de manera automatizada. Por esta razn para enviar SMS a Personal y Claro se solicita un captcha (el mismo que se solicita en la web de personal/claro). Los costos corren por cuenta de la lnea receptora de los mensajes.

El sistema no es confiable ya que segn las pruebas realizadas los SMS enviados no fueron recibidos por los destinatarios aunque, los mismos pueden haber bloqueado la recepcin de los SMS con pago revertido.

Tecnologa IP SMS [2]

Para enviar o recibir un gran nmero de mensajes SMS vale la pena considerar el uso de Internet. Por medio de ella o por medio de una red IP privada es posible conectarse directamente con el Centro de SMS del operador GSM (SMSC). El SMSC es responsable de recibir, almacenar y enviar los mensajes SMS en una red de telefona GSM. La conexin directa a este servicio provee grandes beneficios tales como: enviar y recibir un gran nmero de mensajes en un periodo de tiempo muy corto. modificar el nmero telefnico del emisor. monitorear la disponibilidad del servicio. brindar una solucin ms barata, ms rpida y ms confiable cuando se trabaja con grandes volmenes de mensajes que la solucin alternativa que implica tener un dispositivo GSM conectado a la computadora.

Uno de los sistemas que brinda el servicio mencionado es Ozeki Message Service. Ozeki es una aplicacin de SMS Gateway que le permite a los usuarios y a sus aplicaciones enviar y recibir mensajes SMS a dispositivos mviles a travs de una computadora. Posee una interfaz fcil de usar y una excelente arquitectura interna. La aplicacin puede utilizar un celular GSM conectado a la computadora o tecnologa IP SMS para transmitir y recibir los mensajes. Ozeki Message Server funciona en los sistemas operativos Windows XP, Windows Vista, Windows 7, Windows Server 2003 y Windows Server 2008 de Microsoft. Este sistema permite a los usuarios conectarlos directamente con el SMSC proveedor a travs de Internet o de una red privada utilizando TCP/IP.

Figura 4 - Conexin IP SMS para enviar y recibir grandes volmenes de mensajes SMS. Para utilizar este sistema, en primera instancia se debe firmar un contrato con el proveedor de servicios GSM para obtener el acceso directo a su SMSC. Luego se obtiene la informacin requerida por el sistema Ozeki: direccin IP, nmero de puerto, nombre de usuario y password para acceder al servicio. Se debe configurar un protocolo SMS para permitir el envo y recepcin de mensajes SMS y establecer una VPN.

Ozeki soporta protocolos UCP-EMI [3], SMPP [4] y CIMD2 [5] pudiendo combinarlos segn las necesidades del usuario.

Figura 6 - Arquitectura de un sistema SMS Gateway El sistema permite a los desarrolladores integrar la funcionalidad de mensajera SMS en sus aplicaciones de manera sencilla. Algunos servicios que proveen la tecnologa IP SMS en Argentina son Adhoc diseo y contenidos[6], SMSMasivos[7] y MovilGate[8]. (*)
Adhoc ofrece servicios de mensajera SMS a un costo bajo aunque no poseen una demo

gratuita para probar el sistema a travs de aplicaciones, para esto la compaa solicita la compra de un pack de al menos 1000 SMS. El servicio puede probarse desde el sitio web de la compaa con un usuario demo que permite enviar 20 SMS de forma gratuita. SMSMasivos ofrece los servicios de mensajera SMS de nmero corto (similar a los servicios de descarga o recepcin de contenido) y nmero largo (un numero celular convencional) y brinda la posibilidad de solicitar un usuario demo que permite enviar hasta 25 SMS de forma gratuita a travs de su web o mediante una aplicacin que establezca una coneccin con el servicio web que ellos mismos proveen. MovilGate ofrece el servicio pero no una demo para realizar pruebas. A diferencia de las dems compaas, para utilizar el servicio se debe abonar un costo de instalacin y uso de su sistema de integracin (Servicio web). Debido a que los servicios provistos por Adhoc y MovilGate requeran inversin inicial para poder probar su funcionalidad se procedi a contactar a SMSMasivos para generar el usuario demo y comenzar el desarrollo.
_____________________________________________________________________________ *Al final de este documento y como anexo se encuentran los presupuestos e informacin correspondiente a las Compaas mencionadas.

Junto con los datos de autentificacin de usuario se obtiene la gua de uso API SMS(*), una plataforma web autoadministrable para el envo masivo de SMS. En la misma se encuentran las distintas opciones de envo HTTP. HTTP en bloque (Varios mensajes al mismo tiempo). Servicio web. E-mail. y opciones de consulta de saldo y recepcin de SMS nicamente a travs de HTTP. Esto ltimo puede hacerse de forma asincrnica, mediante una consulta al sistema o puede desarrollarse un servicio web que permita al sistema de la compaa hacer un push de los mensajes entrantes para evitar que se ejecute constantemente una consulta de los mensajes recibidos. Existen dos tipos de servicio, nmero corto y nmero largo. La diferencia est dada por quien comienza la conversacin. En nmero largo la conversacin es iniciada por el cliente de SMSMasivos, es decir, quien paga por el servicio. De esta forma pueden enviarse notificaciones a distintos celulares va SMS. Los nmeros receptores pueden contestar al nmero emisor nicamente cuando hayan recibido un mensaje previamente. Numero corto en cambio permite que la conversacin sea iniciada por cualquier celular y la aplicacin puede contestar slo cuando recibe un SMS. Generalmente estos servicios son utilizados en los sistemas de suscripciones de contenido SMS, en los cuales para recibir datos diariamente se debe enviar un SMS para dar el alta en el sistema. Cada mensaje de alta recibido almacena el nmero del emisor del SMS en una base de datos de clientes y luego, cada 24 horas, se enva un mensaje de contenido. Estos sistemas ofrecen informacin en texto como por ejemplo, horscopo, chistes, noticias deportivas, entre otras o descarga de aplicaciones o msica. Cabe destacar que el comportamiento de ambos servicios a nivel aplicacin es el mismo. Para probar la funcionalidad de los servicios provistos por la compaa se desarroll una aplicacin Java sencilla para poder enviar y recibir SMS desde una PC. En principio utilizaron los servicios web WSDL a travs de dos clases provistas por SMSMasivos pero luego, por inconvenientes tcnicos por parte de la empresa, se implement la funcionalidad a travs de HTTP utilizando los mtodos POST y GET. Los detalles de las implementaciones se encuentran a continuacin.

________________________________________________________________________ (*) La gua de uso se encuentra como anexo de este documento en la pgina12.

10

Gua para la implementacin de aplicaciones de mensajera SMS a travs de una aplicacin Java
Para poder utilizar los servicios de SMSMasivos a travs de una computadora se implement la interfaz de usuario sencilla de la figura 7.

Figura 7 - Interfaz de usuario del sistema de envo y recepcin de SMS. Al presionar el botn Enviar, luego de controlar los valores de los campos, se enva una peticin HTTP al sitio de la compaa con los siguientes parmetros: nombre de usuario y clave para ingresar al sistema nmero del destinatario mensaje a enviar parmetro booleano de testeo siendo 0 una prueba de conexin al sistema sin enviar el SMS y 1 para enviar el mensaje. En ambos casos se recibe la respuesta del servidor notificando la conexin establecida. El cdigo de esta funcionalidad es el siguiente: public String enviarSMS(String nro, String txt) { String charset = "ISO-8859-1"; String servicio = "http://servicio.smsmasivos.com.ar/enviar_sms.asp"; String destino = nro; String texto = txt;

11

String test = "1"; String queryString = ""; try { queryString = "?api=1"; queryString += "&usuario="+ URLEncoder.encode(usuario, charset); queryString += "&clave="+ URLEncoder.encode(clave, charset); queryString += "&tos="+ URLEncoder.encode(destino, charset); queryString += "&texto="+ URLEncoder.encode(texto, charset); //queryString += "&test="+ test; // Este Random evita que las URL entren en Cach queryString += "&random="+ URLEncoder.encode(new Random().nextInt(9999999) +"", charset); String resultado = MyHttpRequest.httpRequest(servicio, queryString); if( (resultado!=null) && (resultado.trim().equals("OK")) ){ return ("Envo Exitoso " + resultado); }else{ return(resultado); } } catch (Exception e) { System.out.println("Error desconocido: "+ e.getMessage()); } return null; }
El objeto MyHttpRequest realiza el llamado a la URL y obtiene la respuesta del servidor de SMSMasivos. Esta clase ha sido provista por la compaa. Para implementar la funcionalidad de recepcin de mensajes, cada vez que se presiona el botn Recibir se obtienen todos los mensajes recibidos ordenados por fecha. El cdigo de esta funcionalidad es similar al mostrado anteriormente aunque cambian algunos parmetros. Para obtener los mensajes en tiempo real se desarroll un servicio web cuya direccin IP o URL de servidor y puerto, deben ser informados al servicio tcnico de la compaa para poder recibir los SMS entrantes en la aplicacin. La implementacin de este servicio web se detalla en la siguiente seccin.

12

Gua para la implementacin de Servicios Web para recibir mensajes desde una aplicacin Java
En primera instancia se debe crear un nuevo proyecto Web de Java. Como muestra la figura 8, el tipo de proyecto debe ser Web Application.

Figura 8 - Creacin de un nuevo proyecto Web de Java.

Una vez creado el proyecto se debe crear el servicio web haciendo clic derecho sobre el proyecto creado y seleccionar New -> Web Service, tal como se indica en la figura 9.

13

Figura 9 - Creacin de un nuevo servicio web.

El siguiente fragmento de cdigo se genera automticamente al crear el servicio web. @WebService(serviceName = "ejemplo") public class ejemplo { /** * This is a sample web service operation */ @WebMethod(operationName = "hello") public String hello(@WebParam(name = "name") String txt) { return "Hello " + txt + " !"; } }

14

Para recibir los mensajes SMS desde una computadora es necesario crear un nuevo mtodo web o modificar el creado automticamente de la siguiente manera: @WebMethod(operationName = "mensajes") public String getMensaje(@WebParam(name = "numero") String nroemisor, @WebParam(name = "mensaje")String txtmensaje) { String rta = handler.enviarSMS(nroemisor, "mensaje recibido, esta es la respuesta"); return rta; } En este ejemplo, por cada mensaje entrante en la aplicacin se responde automticamente un SMS con el texto "mensaje recibido, esta es la respuesta". El nmero del celular emisor del SMS se almacena en la variable nroemisor y el mensaje recibido se almacena en la variable txtmensaje. Actualmente este servicio web est almacenado en la siguiente direccin: sp1.pladema.net:8734/servicioRecepcion/receptorSMS. Con el cdigo anterior se puede implementar un sistema de informacin por SMS similar al desarrollado por el Gobierno de la Nacin para obtener informacin sobre el padrn electoral, o el sistema de estacionamiento medido del Municipio de Tandil. En estos sistemas se enva un SMS a un servidor con un texto especfico. El sistema procesa el texto recibido y brinda una respuesta al emisor. Esto puede implementarse modificando el cdigo anterior y utilizando una base de datos. Las modificaciones deben realizarse antes de enviar la respuesta al nmero emisor como indica el siguiente ejemplo de cdigo: @WebMethod(operationName = "mensajes") public String getMensaje(@WebParam(name = "numero") String nroemisor, @WebParam(name = "mensaje")String txtmensaje) { //A: Procesar el String txtmensaje para obtener los datos relevantes del mensaje recibido. // B: Ejecutar una consulta a la base de datos con los datos de A y almacenar el resultado en una variable de tipo string. // C: crear un nuevo string con el texto del mensaje a enviar y los datos obtenidos en B. String respuesta = handler.enviarSMS(nroemisor, /*String obtenido en C*/); return respuesta; } SMSMasivos provee una gua de uso para acceder a sus servicios, la misma se encuentra a continuacin, en el Anexo 1.

15

ANEXO 1

SMS Masivos
una nueva forma de comunicacin

Gua de uso

API SMS
Plataforma Web auto administrable

para el envo masivo de sms

--------------------------------------------------------------------// Instructivo versin 4.00 ---------------------------------------------------------------------

16

 ndice
Envo de mensajes va http (en tiempo real)........................................................................................................................... Pg. 03

Envo de mensajes va Web Service (en tiempo real).......................................................................................Pg. 05 Envo de mensajes va http (en bloque, mtodo POST)
..........................................................................

Pg. 06

Comprobacin del proceso de un envo en bloque ..........................................................................................Pg. 08

Envo de mensajes va correo electrnico (SMTP) ..................................................................................................Pg. 10
Recepcin de mensajes va HTTP .............................................................................................................................. ...........................................Pg. 11
Consulta de saldo va HTTP ..................................................................................................................................................................................................Pg. 13

Consulta de vencimiento del paquete va HTTP

......................................................................................................... Pg.

13

Consulta de mensajes enviados va HTTP .....................................................................................................................................Pg. 13 Consulta de la fecha del servidor ..........................................................................................................................................................................Pg. 14 Seguridad con HTTPS (SSL) y filtrado IP ............................................................................................................................. ................Pg. 15

Contacto directo con el rea de soporte: soporte@smsmasivos.com.ar

17

 Envo de mensajes va http (en tiempo real)

La aplicacin que desee enviar mensajes SMS a travs de SMS Masivos deber hacer un llamado HTTP con mtodo GET a la siguiente direccin: http://servicio.smsmasivos.com.ar/enviar_sms.asp?api=1

Los parmetros son:

USUARIO: Nombre de usuario que le otorg SMS Masivos (obligatorio) CLAVE: Contrasea del usuario que le otorg SMS Masivos (obligatorio) TOS: Nmero de telfono mvil al que se le desea enviar el mensaje (con cdigo de rea) (obligatorio)

Nota para Argentina: los nmeros van sin el CERO y sin el 15. TEXTO: Mensaje que se desea enviar (mximo 160 caracteres) (obligatorio). Los caracteres permitidos son: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!?#$%()*+, -./:;=@ y el espacio API: Variable fija de valor 1 para indicar que las respuestas regresarn como texto plano (obligatorio) TEST: Indica si se desea que se validen los datos del mensaje pero que no se enve (opcional, debe colocarse un 1)

Ejemplo de llamado:
http://servicio.smsmasivos.com.ar/enviar_sms.asp?api=1&usuario=DEMO500&clave=DEMO50 0&tos=1144445555&texto=Mensaje

Pgina para testeo sencillo de la API: http://servicio.smsmasivos.com.ar/ver_probar_api.asp

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

18

Las respuestas posibles son: Si el mensaje est correcto y se puso en la bandeja de salida responde OK. Si el mensaje tuvo algn error puede responder:
NMERO DE CELULAR: el texto del mensaje es muy largo (mximo 160 caracteres) NMERO DE CELULAR: el texto del mensaje contiene caracteres invlidos

NMERO DE CELULAR: el texto del mensaje contiene un campo personalizable que no ha sido com-pletado (ejemplo: *1*)
NMERO DE CELULAR: el nmero de celular es muy corto NMERO DE CELULAR: el nmero de celular es muy largo NMERO DE CELULAR: se han agotado los NNNN SMS contratados

NMERO DE CELULAR: el contrato para enviar SMS ha expirado el XXXX de XXXMES NMERO DE CELULAR: probando sin enviar (este mensaje indica que el mensaje est OK pero no se coloc en la bandeja de salida por recibir el parmetro TEST en 1)

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

19

 Envo de mensajes va Web Service (en tiempo real)

La aplicacin que desee enviar mensajes SMS a travs de SMS Masivos puede importar el siguiente Web Service: WSDL: http://servicio.smsmasivos.com.ar/ws/SMSMasivosAPI.asmx?WSDL

Test del Web Service: http://servicio.smsmasivos.com.ar/ws/SMSMasivosAPI.asmx

Los parmetros y respuestas posibles son idnticas al envo va HTTP normal.

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

20

 Envo de mensajes va http (en bloque, mtodo POST)

La aplicacin que desee enviar mensajes SMS a travs de SMS Masivos deber hacer un llamado HTTP con mtodo POST a la siguiente direccin: http://servicio.smsmasivos.com.ar/enviar_sms_bloque.asp Los parmetros son:
USUARIO: nombre de usuario que le otorg SMS Masivos (obligatorio) CLAVE: contrasea del usuario que le otorg SMS Masivos (obligatorio)

SEPARADORCAMPOS: carcter que separar los campos del bloque. Puede ser tab o bien coma (coma es el valor predeterminado). BLOQUE: con este formato (urlencoded, obligatorio)
Si el SEPARADORCAMPOS fuese coma sera: idinterno,destino,texto{enter} idinterno,destino,texto{enter} idinterno,destino,texto

Si el SEPARADORCAMPOS fuese tab sera: Idinterno{tab}destino{tab}texto{enter} Idinterno{tab}destino{tab}texto{enter} Idinterno{tab}destino{tab}texto TEST: indica si se desea que se validen los datos del mensaje pero que no se enve (opcional, debe colocarse un 1)

Bloque se conforma con varias lneas, una por mensaje a enviar, con el siguiente formato:
IdInterno: el valor idinterno puede contener nmeros y/o letras. Es el id con el que luego se podr consultar el status del envo. Es un nmero de referencia del cliente (no de SMS Masivos).

Si no se cuenta con un idinterno debe colocarse lo mismo que en destino. Destino: nmero al cual ir el SMS (10 dgitos para Argentina). Texto: mensaje de 160 caracteres como mximo. El texto puede contener comas, no hace falta hacer-les un escape.

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

21

Ejemplo de llamado:
http://servicio.smsmasivos.com.ar/enviar_sms_bloque.asp?usuario=UUUUU&clave=CCCCCC&b loque=XXX%2C1161880001%2CTexto+1%0D%0AYYY%2C1161880002%2CTexto+2%0D%0A

Esto mismo funciona por GET o por POST. El llamado responde OK al terminar de tomar todos los datos. Si alguna de las lneas tiene formato incorrecto es ignorada.

Pgina para testeo sencillo de la API: http://servicio.smsmasivos.com.ar/ver_probar_api_bloque.asp

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

22

 Comprobacin del proceso de un envo en bloque

Una vez hecho un llamado con el mtodo Envo de mensajes va http (en bloque, mtodo POST) se pue-de consultar el estado del procesamiento de cada uno de los mensajes. Puede consultarse por IdInterno o bien por Fecha.

Ejemplo de llamado, consulta por IdInterno:

http://servicio.smsmasivos.com.ar/obtener_respuestaapi_bloque.asp?usuario=UUUUU&clave= CCCCCC&idinterno=XXX

El parmetro idinterno puede contener nmeros y/o letras.

Ejemplo de llamado, consulta por Fecha (la fecha corresponde al momento del proceso):
http://servicio.smsmasivos.com.ar/obtener_respuestaapi_bloque.asp?usuario=UUUUU&clave= CCCCCC&fecha=20101231175015

El parmetro fecha tiene formato YYYYMMDDHHNNSS. Tener en cuenta que esta bsqueda se hace en relacin a la fecha de nuestro servidor. Se puede consultar la misma utilizando el servicio Consulta de la fecha del servidor

Parmetros extra:
SOLONOLEIDOS: flag que indica si queremos obtener los estados no ledos o todos (opcional). Valores posibles: 0 (default) o 1 para activar el flag.
MARCARCOMOLEIDOS: flag que indica si queremos marcar como ledos los estados que vamos a obtener (opcional). Valores posibles: 0 (default) o 1 para activar el flag.

Las respuestas posibles son: El formato es de lneas separadas con enter y campos separados por tabs.
IdInterno {tab} Fecha {tab} Respuesta de la api {enter} IdInterno {tab} Fecha {tab} Respuesta de la api {enter} IdInterno {tab} Fecha {tab} Respuesta de la api {enter}

En ambos casos, por fecha o por idinterno responde una cadena con el texto PENDIENTE si no hay resultados del proceso an.
www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

SMS Masivos | Gua de uso API | Versin 4.00

23

El campo Fecha tiene formato YYYYMMDDHHNNSS. El campo Respuesta de la api responde OK si el mensaje ya fue procesado y el envo fue correcto. Responde con el texto del mensaje de error. Igual que la API de envo unitario (ver en Envo de mensa-jes va http (en tiempo real) dems referencias y mensajes de error). Ejemplo si an no tengo respuesta: PENDIENTE Ejemplo ok: OK XXX{tab}20110927110505{tab}OK Ejemplo con un ERROR y un envo exitosor: XXX{tab}20110927110505{tab}1161880001: el nmero recibi un mensaje idntico hace menos de 48 horas (no se har el envo).{enter} YYY{tab}20110927110505{tab}OK

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

24

 Envo de mensajes va correo electrnico (SMTP)

La aplicacin que desee enviar mensajes SMS a travs de SMS Masivos deber enviar un correo electrnico a la direccin api@smsmasivos.com.ar

En el asunto se colocarn todos los parmetros, siendo:

USUARIO: nombre de usuario que le otorg SMS Masivos (obligatorio) CLAVE: contrasea del usuario que le otorg SMS Masivos (obligatorio)

NUMERO: nmero de telfono mvil al que se le desea enviar el mensaje (con cdigo de rea) (obligatorio) Nota para Argentina: los nmeros van sin el CERO y sin el 15. TEXTO: mensaje que se desea enviar (mximo 160 caracteres) (obligatorio). Los caracteres permitidos son: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!?#$%()*+,
-./:;=@ y el espacio

Ejemplo de asunto: USU500 CLAVE500 1155556666 Octavio Gomez, no se olvide que hoy vence su factura. Si el mensaje tuvo algn error se enviar por correo electrnico al remitente del email. Son los mismos que se mencionan en el envo va HTTP.

10

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

25

 Recepcin de mensajes va HTTP

La aplicacin que desee recibir mensajes SMS a travs de SMS Masivos deber hacer un llamado HTTP con mtodo GET a la siguiente direccin: http://servicio.smsmasivos.com.ar/obtener_sms_entrada.asp

Los parmetros son:

USUARIO: nombre de usuario que le otorg SMS Masivos (obligatorio) CLAVE: contrasea del usuario que le otorg SMS Masivos (obligatorio)

ORIGEN: nmero de telfono mvil del cual se desean conocer las respuestas (opcional). De no infor-marse devolver todas las respuestas recibidas. FORMATO: predeterminadamente el sistema devuelve en formato de texto separado por tabs y enters. Si en formato enviamos excel devolver en formato xls compatible (opcional). SOLONOLEIDOS: flag que indica si queremos obtener los mensajes no ledos o todos(opcional). Valores posibles: 0 (default) o 1 para activar el flag.
MARCARCOMOLEIDOS: flag que indica si queremos marcar como ledos los mensajes que vamos a obtener (opcional). Valores posibles: 0 (default) o 1 para activar el flag.

Ejemplo de llamado (formato de texto separado por tabs):

http://servicio.smsmasivos.com.ar/obtener_sms_entrada.asp?usuario=DEMO500&clave=DEM O500

Respuesta:
1155554444{tab}Cuarto mensaje{tab}2001-12-20 13:35:14{tab}1004{enter} 1155554666{tab}Tercer mensaje{tab}2001-12-20 13:35:10{tab}1003{enter} 1153354666{tab}Segundo mensaje{tab}2001-12-20 13:35:10{tab}1002{enter} 1155554644{tab}Primer mensaje{tab}2001-12-20 13:35:10{tab}1001{enter}

y as siguiendo! El formato de la fecha es AAAA-MM-DD HH:MM:SS Los mensajes vienen ordenados por fecha de recepcin descendente (lo ms nuevo arriba, lo ms antiguo, abajo).

11

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

26

Ejemplo de llamado para traer las respuestas de un nmero en particular (formato de texto separado por tabs):
http://servicio.smsmasivos.com.ar/obtener_sms_entrada.asp?usuario=DEMO500&clave=DEM O500&origen=1155554666

Respuesta:
1155554666{tab}Tercer mensaje{tab}2001-12-20 13:35:10{tab}1003{enter} Si no hubiera mensajes en la bandeja de entrada el archivo vuelve vaco.

Ejemplo de llamado para traer las respuestas no ledas y marcarlas como ledas para la prxima vez (formato de texto separado por tabs):
http://servicio.smsmasivos.com.ar/obtener_sms_entrada.asp?usuario=DEMO500&clave=DEM O500&origen=1155554666

Ejemplo de llamado (formato de excel): http://servicio.smsmasivos.com.ar/obtener_sms_entrada.asp?formato=excel

Ejemplo de llamado para traer las respuestas de un nmero en particular (formato de excel):
http://servicio.smsmasivos.com.ar/obtener_sms_entrada.asp?usuario=DEMO500&clave=DEMO 500&formato=excel&origen=1155554666

12

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

27

 Consulta de saldo va HTTP

Se usa en los planes prepagos para saber la cantidad de SMS que an podemos enviar con nuestro usuario.

Los parmetros son: USUARIO: nombre de usuario que le otorg SMS Masivos (obligatorio) CLAVE: contrasea del usuario que le otorg SMS Masivos (obligatorio)

Ejemplo de llamado: http://servicio.smsmasivos.com.ar/obtener_saldo.asp?usuario=DEMO500&clave=DEMO500

Consulta de vencimiento del paquete va HTTP

Se usa en los planes prepagos para saber la fecha de vencimiento del paquete contratado. Los parmetros son: USUARIO: nombre de usuario que le otorg SMS Masivos (obligatorio) CLAVE: contrasea del usuario que le otorg SMS Masivos (obligatorio)

Ejemplo de llamado:
http://servicio.smsmasivos.com.ar/obtener_vencimiento_paquete.asp?usuario=DEMO500&cla ve=DEMO500

Consulta de mensajes enviados va HTTP

Se usa en los planes abiertos para saber la cantidad de SMS que se han enviado en el mes en curso.

Los parmetros son: USUARIO: nombre de usuario que le otorg SMS Masivos (obligatorio) CLAVE: contrasea del usuario que le otorg SMS Masivos (obligatorio)

Ejemplo de llamado: http://servicio.smsmasivos.com.ar/obtener_envios.asp?usuario=DEMO500&clave=DEMO500

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

13

SMS Masivos | Gua de uso API | Versin 4.00

28

 Consulta de la fecha del servidor

Se usa para consultar la fecha actual del servidor. Devuelve el resultado en formato YYYY-MM-DD HH:mm:SS (Ej: 2012-12-09 18:35:58) No requiere parmetros.

Ejemplo de llamado: http://servicio.smsmasivos.com.ar/get_fecha.asp?iso=1

14

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

29

 Seguridad con HTTPS (SSL) y filtrado IP

Todas las comunicaciones HTTP pueden ser utilizadas por HTTPS tambin. Adicionalmente si la integracin se realizar desde un servidor con IP fija podemos hacer que los accesos sean permitidos exclusivamente desde dicha IP. Comunquese con nuestro departamento de soporte para establecer esta regla de firewalling.

15

SMS Masivos | Gua de uso API | Versin 4.00

www.smsmasivos.com.ar Dto. Comercial: comercial@smsmasivos.com.ar Soporte tcnico: soporte@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

30

SMS Masivos
una nueva forma de comunicacin

www.smsmasivos.com.ar

31

Anexo 2: presupuesto e informacin correspondiente de las compaas consultadas

Las compaas SMSMasivos y Ad Hoc presentan su presupuesto mediante archivos PDF mientras que Movil Gate lo hizo a travs del siguiente e-mail.
Movil Gate

Presupuesto vlido por 30 das SET FEE INiSET FEE INTEGRACION FEE MANTENIMIENTO SEGUN ESCALA: Hasta 10.000 SMS Desde 10.001 a 50.000 SMS Desde 50.001 a 300.000 SMS $ 9.000,00

$ $ $

1.800,00 2.500,00 3.800,00

Para nuestros nuevos clientes hay un 10% de descuento en el set up. El set fee integracin contiene el uso del servicio web a utilizar lo que hace que el costo inicial sea un 90% ms costoso que el de las otras dos empresas. La siguiente informacin corresponde a las empresas SMSMasivos y Ad Hoc, cuyo servicio de mensajera SMS se llama SMStart.

32

Presupuesto SMS Masivos

una nueva forma de comunicacin

SMS Masivos
33

******************************************************************
SMS masivos es una plataforma Web autoadministrable para el envo y recepcin de Mensajes de Texto, una solucin ideal para empresas, instituciones y profesionales que deseen utilizar un nuevo e innovador canal de comunicacin con sus clientes, empleados y proveedores.

Cuente con la posibilidad de personalizar los mensajes para cada destinatario, realizar envos programados en fecha y hora, integracin API y cobertura a nivel nacional e internacional desde cualquier PC o dispositivo mvil con acceso a Internet. ******************************************************************

Por qu motivo hoy el sms es una herramienta eficiente para la comunicacin?

Porque hoy en da el celular es nuestro compaero las 24hs. Porque el 93% de las poblacin Argentina tiene celular.

Porque todos los telfonos mviles soportan SMS. Porque el 95% de los SMS son ledos por los clientes (un porcentaje ms elevado en comparacin al mailing). Porque el mensaje tiene llegada en cualquier lugar y en cualquier momento.
Porque el uso del SMS como herramienta de comunicacin corporativa es poco utilizada lo que lo convierte en algo novedoso, sumado al impacto que genera el mensaje debido a

la personalizacin.

Componentes del servicio:

Envo de SMS a grupos de contactos o de forma individual. Programacin de fecha, hora y grupo destinatario de los SMS.

Envo de manera simultnea de mensajes personalizados a varios nmeros a la vez. Agenda online, almacenaje de sus listas de contactos. Simple importacin de sus bases de datos para crear Grupos de Contactos.
Acceso a su cuenta de usuario y envo desde cualquier Pc o dispositivo con acceso a Internet.

Modificacin o descarte de los SMS que todava no han llegado a la fecha programada de envo. Visualizacin de la bandeja de SMS enviados para verificacin y control. Visualizacin de envos programados, mensajes enviados y pendientes de envo desde la bandeja de salida. Recepcin de las respuestas de los clientes, con la posibilidad de responderles nuevamente visualizando un historial de la comunicacin (similar a un chat).
www.smsmasivos.com.ar info@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

SMS Masivos | Plataforma de envo de SMS

34

 Planes
// Plan Abierto:
Consta de un abono mensual, el cul se acredita en SMS a su cuenta mes a mes. Una vez consumidos los SMS incluidos en el pack, podr seguir enviando mensajes libremente a precio excedente. Contrate el plan que mejor se adapte a sus necesidades.

Packs Disponibles Pack M 500 Pack M 1.500 Pack M 4.000 Pack M 10.000

Cantidad de Precio del Pack SMS Excedente SMS Incluidos 500 1500 4000 10.000 $ 240 $ 490 $ 1.200 $ 2.500 $ 0,48 $ 0,33 $ 0,30 $ 0,25

Las tarifas son nicamente para SMS dentro de Argentina.

Incluye salida por IP internacional.

Por ms de 100.000 SMS consultar planes a medida. Los precios no incluyen IVA (21%).

// Plan Prepago:
Brinda la posibilidad de administrar los consumos de acuerdo a su necesidad, sin abono mensual. Se habilitar la cantidad de SMS contratados y finalizar el servicio cuando se cumpla el vencimiento del pack o cuando se haya consumido la totalidad de los mensajes (lo que primero suceda).

Packs Disponibles Pack P 500 Pack P 1.500 Pack P 4.000

Cantidad de SMS Incluidos 500 1500 4000

Precio Pack x 1 mes $ 275 $ 660 $ 1.450

Precio Pack x 3 mes $ 310 $ 760 $ 1.700

Las tarifas son nicamente para SMS dentro de Argentina. Incluye salida por IP internacional

Por ms de 4.000 SMS consultar planes a medida. Los precios no incluyen IVA (21%

Para enviar SMS convertidos a voz a telfonos fijos, solicita la carpeta de SMS a VOZ en www.smsmasivos.com.ar

Integracin con Sms Masivos

Envo y recepcin de mensajes va HTTP: La aplicacin que desee enviar y recibir mensajes SMS a travs de SMS Masivos deber hacer un llamado HTTP con mtodo GET a una direccin Web que ser proporcionada.
Envo de mensajes va correo electrnico (SMTP): La aplicacin que desee enviar mensajes SMS a travs de SMS Masivos deber enviar un correo electrnico a la direccin api@smsmasivos.com.ar

Envo de mensajes mediante un Excel

www.smsmasivos.com.ar info@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

SMS Masivos | Plataforma de envo de SMS

35

 Algunos de nuestros Clientes

Formas de pago
Transferencia Bancaria Medios de pago:

Solicite una Demo

Complete el formulario de Contacto en nuestra Web y solicite una demo sin cargo para probar integralmente la aplicacin de envo de SMS.

Contacto
Pgina web: www.smsmasivos.com.ar
comercial@smsmasivos.com.ar Dto. Comercial: Soporte tcnico:

E-mail: info@smsmasivos.com.ar
soporte@smsmasivos.com.ar

Telfono: (54) 11-4793-8746

SMS Masivos | Plataforma de envo de SMS

www.smsmasivos.com.ar info@smsmasivos.com.ar Tel. /Fax: +(54) 11-4793-8746

36

Ad Hoc diseo y contenidos

37

Referencias

[1] Sitio Web de Movistar , servicio SMS online. http://www.smsfull.com/sms21/inicio.html ltima vez accedido el 9 de febrero de 2014. [2] Tecnologa IP SMS fuente: http://www.ozeki.hu/index.php?owpn=507 ltima vez accedido el 9 de febrero de 2014. [3] Especificacin del protocolo EMI: http://www.nowsms.com/discus/messages/1/EMI_UCP_Specification_40-8156.pdf ltima vez accedido el 9 de febrero de 2014. [4]Especificacin del protocolo SMPP http://www.nowsms.com/discus/messages/1/SMPP_v3_4_Issue1_2-24857.pdf ltima vez accedido el 9 de febrero de 2014. [5]Especificacin del protocolo SMPP http://www.advox.se/download/protocols/Cimd_SC80.pdf ltima vez accedido el 9 de febrero de 2014. [6] Ad Hoc Diseo y Contenido http://www.adhocsite.com.ar/index3.html ltima vez accedido el 9 de febrero de 2014. [7] SMSMasivos http://smsmasivos.com.ar/ ltima vez accedido el 9 de febrero de 2014. [ 8] MovilGate http://www.movilgate.com/ ltima vez accedido el 9 de febrero de 2014.

38