Pgina 1 de 6

Especificaciones Integracin SMS para Clientes XML sobre HTTP INTRODUCCIN El objetivo del presente documento es especificar las posibilidades para lograr la interconexin entre los sistemas de los clientes corporativos. Esta interconexin tiene dos modalidades bsicas, el intercambio de archivos o un nico post para envo masivo de SMS (bulk); y una serie de posts HTTP para intercambio de mensajes individuales, como se describe a continuacin.

La plataforma de servicios de Telefnica es de naturaleza asncrona (store and forward). Todos los servicios que se trafican desde carriers o hacia carriers son almacenados y luego despachados hacia sus clientes. Por cada accin solicitada por un cliente de un carrier la plataforma de Telefnica genera un identificador de transaccin nico (IdTran) asociado a esa transaccin. El objetivo de ese IdTran es garantizar que los servicios dados a los clientes correspondan con las limitaciones legales / operativas impuestas por los distintos carriers a Telefnica. Estas limitaciones se reflejan en los servicios expuestos a los socios externos por medio del IdTran nico. Esto en ambos protocolos de integracin. Para lo que son transacciones interactivas la relacin de los MOs con los MTs debe ser en relacin uno es a dos a lo ms (1 MO por 2 MTs). Esta relacin se cambiara en caso de que un carrier lo requiera y en los tiempos que el carrier exija que se realice el cambio a Telefnica. La tendencia en los operadores es tener una relacin 1 MO por 1 MT, el integrador debe tener esto presente.

Operador

Celular

Gateway SMS

Multicarrier

VPN

smpp

HTTP

XML

WS

Empresa-

Cliente

Pgina 2 de 6

PROTOCOLO XML sobre HTTP

El protocolo XML sobre HTTP trabaja usando los servicios de Internet. A continuacin se describen los casos posibles presentes en este escenario. La implementacin se basa en el uso de HTTP/XML y es totalmente asincrnico.

SMS MO REQUEST: Recibido un MO que debe ser reenviado al "Integrador Externo" el GW Telefnica enviar por HTTP la siguiente informacin:

Text

Pgina 3 de 6

Donde: Servicio ID: Es el servicio y carrier desde donde se origin el mensaje. Este servicio deber ser devuelto en la transaccin MT tal cual se enva. Telfono MSISDN: Telfono del usuario. Telfono IdTran : Id de transaccin, generado por Telefnica y utilizado para mantener identificadas las cadenas de eventos generadas por este MO, numrico. Contenido : Contenido del SMS MO, mensaje enviado por un usuario desde su telfono celular.

Ejemplo :

Quiero conocer el saldo de mi producto 2944

RESPONSE: A este request el servidor del "Integrador Externo" deber responder con un cdigo 200 HTTP. Cualquier otra respuesta ser considerada errnea y, si el servicio contempla una notificacin de error, se le enviar un MT al usuario con un texto como Servicio no disponible por el momento.

SMS MT REQUEST: Para el envo de MT desde el servidor del "Integrador Externo" a un usuario, el "Integrador Externo" har el siguiente request HTTP con contenido XML:

Elpassword es: 78dgydfgd6

Pgina 4 de 6

Donde: Proveedor ID: Nombre de identificacin del proveedor. Provisto por Telefnica Proveedor Password: Password del proveedor. Provisto por Telefnica Servicio ID: Cdigo de identificacin del servicio y carrier. El MT es una o varias respuestas al MO-SMS de entrada, el campo servicio deber corresponder en forma exacta con este. Servicio ContentType: Descriptor del tipo de contenido en el mensaje. Los mensajes podrn consistir en texto plano, ringtones monofnicos, logo de operador, Wap Push, otros. El mensaje de tipo binario (Content Type=1) a enviar se deber pasar en codificacin hexadecimal.

Content Type Descripcin

0 Texto plano

1 Binario, formateado en hexadecimal

2 Enviar como WapPush

3 EnvaWapPush usando PPG

Telefnica solo convierte el binario formateado a hexadecimal solo al momento de enviar para el caso de los Content Type=1. Telfono / MSISDN: Telfono al que se le enviar el mensaje. Este telfono debe corresponder al telfono que gener el MO, no se deben agregar formatos de numeracin o quitar ceros o modificar el nmero en forma alguna respecto al envo del MO. Telfono IdTran: IdTran del MO que origina este MT , obligatorio. Este identificador debe ser enviado y es la caracterstica que limita el trfico entre los clientes y los integradores externos. La cantidad de MTs que se pueden enviar en funcin de un MO generado es por defecto dos (2) en la plataforma. Contenido: Mensaje a enviar para la comunicacin. RESPONSE:

Pgina 5 de 6

La respuesta de Telefnicaante un MTRequest seria:

string

Donde Cdigo y Texto son cdigos de respuesta segn la tabla siguiente.

Cdigo Estado Texto Estado

0 Ok

1 Usuario/Password Invlida

2 XML Invlido

3 Otro, ver texto en transaccin

Ejemplo:

OK : Transaccion Exitosa

Pgina 6 de 6

Ejemplo en Unix para enviar un MT-SMS va un POST XML usando Curl: '

Test de Envio de Texto Plano

' En este ejemplo se ve el programa curl de unix enviando un MT-SMS va un POST XML a la URL_PARTNER que es asignada por Telefnica y al puerto 80, que tambin es asignado por Telefnica. El IdPartner, el UsrPassword, el PORT TCP y el URL_PARTNER son asignados por Telefnica. Ntese que el formato de envo debe respetar el MO-SMS recibido va XML, en cuando al Serviciod Id , Telfono MSISDN y el IdTran , esos valores vienen en el MO-SMS entregado en el XML al partner y deben ser devueltos tal cual a la plataforma de Telefnica para su adecuado Ruteo. Preguntas Frecuentes P. Por qu hace falta una direccin URL para conectarse tanto en Movilgate como en elCliente para la mensajera? R. Porque el protocolo es asncrono, y los mensajes de tipo MTRequest y MORequest son independientes entre si. Movilgate debe comunicarse con el cliente para enviar elMORequest, y luego de procesar el mensaje, el cliente debe conectarse a Movilgate P. Envo un mensaje a la URL de Movilgate y la respuesta no es de transaccin exitosa. El XML est bien formado. Qu sucede? R.Revise los headers de la transaccin, estos tienen informacin acerca de los erroresdetectados. Para todos los otros casos extraordinarios no enmarcados en este documento se debe tratar con la Gerencia Comercial.