Академический Документы
Профессиональный Документы
Культура Документы
VPN
Gateway
SMS
Multicarrier
XML
smpp
HTTP
WS
EmpresaCliente
Pgina 1 de 6
SMS MO
REQUEST:
Recibido un MO que debe ser reenviado al "Integrador Externo" el GW Telefnica enviar por
HTTP la siguiente informacin:
<?xml version="1.0"?>
<MORequest>
<Servicio Id=string/>
<Telefonomsisdn=string IdTran=number/>
<Contenido>Text</Contenido>
</MORequest>
Pgina 2 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 :
<?xmlversion="1.0"?>
<MORequest>
<Servicio Id=20500.personal.ar/>
<Telefonomsisdn=1129292929IdTran=12345678/>
<Contenido>Quiero conocer el saldo de mi producto 2944</Contenido>
</MORequest>
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:
<?xmlversion="1.0" encoding="ISO-8859-1"?>
<MTRequest>
<Proveedor Id=EMOBILE Password=ps29292/>
<Servicio Id=20500.movistar.ar ContentType=0/>
<Telefonomsisdn=1138945612 IdTran=12345678/>
<Contenido>Elpassword es: 78dgydfgd6</Contenido>
Pgina 3 de 6
</MTRequest>
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
Texto plano
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 4 de 6
<MTResponse>
<Transaccion estado=number IdTran=number Fecha=datetime/>
<Texto>string</Texto>
</MTResponse>
Donde Cdigo y Texto son cdigos de respuesta segn la tabla siguiente.
Cdigo Estado
Texto Estado
Ok
Usuario/Password Invlida
XML Invlido
Ejemplo:
<MTResponse>
<Transaccion estado=0IdTran=12345678Fecha=2005-02-01 20:40:30/>
<Texto>OK : Transaccion Exitosa</Texto>
</MTResponse>
Pgina 5 de 6
'<MTRequest>
<Proveedor Id="IdPartner" Password="UsrPassword"/>
<Servicio Id="5050.movistar.ar" ContentType="0"/>
<Telefonomsisdn="117272727" IdTran="39"/>
<Contenido>Test de Envio de Texto Plano</Contenido>
</MTRequest>
'
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.
Pgina 6 de 6