RECEPCIÓN DE MENSAJES POR SERVICIO WEB

Transcripción

1 RECEPCIÓN DE MENSAJES POR SERVICIO WEB

2 Tabla de contenido Respuesta de mensajes de palabras clave... 3 Autorespuesta... 3 Autorespuesta por Web Service... 3 Recepción de mensajes de palabras clave... 4 Ejemplo: Data Ejemplo: Data Recepción de mensajes de palabra clave formato pipes ( )... 5 WebService Push... 5 Qué es?... 5 Qué quiere decir?... 5 Cómo lo logramos?... 5 Cómo recibe los mensajes?... 6 Ejemplo... 6 Consideraciones técnicas... 7 Soporte Técnico

3 Respuesta de mensajes de palabras clave La respuesta a los mensajes recibidos se puede obtener de 2 maneras. Autorespuesta La respuesta se guarda cuando se crea la palabra clave Autorespuesta por Web Service Con esta opción obtenemos la respuesta través de un archivo alojado en su sitio web. Esto le permite generar respuestas dinámicas según sus necesidades. La url para obtener la respuesta se define cuando se crea una palabra clave, es necesario que especifique el archivo en la url. Ejemplo file.php <?php echo Gracias por utilizar nuestro servicio, eres nuestro cliente numero: $numero_cliente ;?> 3

4 Recepción de mensajes de palabras clave 1. Su aplicación deberá generar la siguiente estructura de texto xml: <USER>usuario</USER> //Usuario de MasMensajes <PASS>password</PASS> //contraseña de MasMensajes <SERVICE>3</SERVICE> //3 = Serv. recepción de mensajes de palabras clave <DATA>1..2</DATA> //1 = Todos, 2 = Por palabra clave <KEYWORD>palabra</KEYWORD> //palabra clave a buscar </SMSWSS10> Nota: Los tags de KEYWORD solo se agregan si el DATA es igual a 2 ya que este llevara la palabra clave a buscar. Ejemplo: Data 1 <USER>usuario</USER> <PASS>password</PASS> <SERVICE>3</SERVICE> <DATA>1</DATA> </SMSWSS10> Ejemplo: Data 2 <USER>usuario</USER> <PASS>password</PASS> <SERVICE>3</SERVICE> <DATA>2</DATA> <KEYWORD>palabra</KEYWORD> </SMSWSS10> 2. Este texto puede enviarse de dos maneras por su aplicación: a) En un archivo de texto o extensión xml b) En una variable llamada xml 3. La aplicación deberá subir el archivo o enviar la variable xml por http usando el método POST a la dirección: 4. El sistema contestará con la lista de mensajes pedidos en DATA de la siguiente manera: : Gracias por la invitación: palabra La cual contiene: Numero celular que envío el mensaje Gracias por la invitación Mensaje enviado Palabra Palabra clave filtro Si no hubo elementos el sistema contesta: EMPTY Si hubo un error en el archivo enviado el sistema contesta: ERROR 4

5 Recepción de mensajes de palabra clave formato pipes ( ) 1. Su aplicación obtiene información de su base de datos o registro de cliente. 2. Su aplicación deberá generar la siguiente estructura de texto xml: <USER>usuario</USER> //Usuario de mas mensajes <PASS>password</PASS> //Password de mas mensajes <SERVICE>10</SERVICE> //10 = Serv. recepción de mensajes de palabras clave formato //pipe ( ) <DATA>2</DATA> <KEYWORD>palabra</KEYWORD> <FROM></FROM> <TO></TO> </ SMSWSS10> Nota: Los tags de KEYWORD solo se agregan si el DATA es igual a 2 ya que este llevara la palabra clave a buscar. Las etiquetas <FROM></FROM> y <TO></TO> son opcionales. Si se envía <FROM> </FROM> y se omite <TO></TO>, retorna los registros con fecha de recepción desde la fecha definida en la etiqueta FROM hasta la fecha actual. Si se envía <TO> </TO> y se omite <FROM></FROM>, retorna los registros con fecha de recepción desde el más antiguo hasta la fecha definida en la etiqueta TO. Tanto en la etiqueta < FROM > como en la etiqueta <TO> es opcional el parámetro de la hora. Ejemplo: Si se envía <FROM> </FROM>, el sistema lo toma desde el primer segundo de ese día: <FROM> :00:00</FROM> 2. Este texto puede enviarse de dos maneras por su aplicación: a) En un archivo de texto o extensión xml b) En una variable llamada xml 3. La aplicación deberá subir el archivo o enviar la variable xml por http usando el método POST a la dirección: WebService Push Qué es? WebService Push es un servicio que ofrece Mas Mensajes, con la finalidad de brindar la información de sus mensajes de palabras clave en tiempo real directamente en su página web. Qué quiere decir? Que nosotros le damos la posibilidad de que los mensajes que lleguen a su cuenta de Mas Mensajes lleguen a su página de forma automática. Cómo lo logramos? Es muy sencillo, solo tiene que dar de alta una dirección URL a donde desea recibir los mensajes automáticamente y así usted podrá manejar esta información. 5

6 Cómo recibe los mensajes? Los datos del mansaje se envían a la URL por el método GET, donde le enviamos celular, mensaje y palabra clave. Ejemplo Damos de alta la URL a la cual deseamos que nos lleguen los mensajes de palabras clave Nota: Es necesario especificar el archivo que recibirá los mensajes. Cuando llegue un mensaje a su cuenta con alguna palabra clave que haya registrado anteriormente, por ejemplo PALABRA Saludos amigo, este se enviará a la URL de la siguiente manera: amigo&palabra=palabra&fecha=hora y fecha de recibido Dónde: Celular: Es el numero celular que ha enviado el mensaje. Sms: Es el texto que se recibió omitiendo la palabra clave. Palabra: Palabra clave. Fecha: Hora y fecha del mensaje recibido con el siguiente formato: YYYY-MM-DD HH:MM:SS ejemplo: :13:05 De esta manera usted podrá tomar este mensaje y procesarlo de la manera que más lo necesite en su web. 6

7 Consideraciones técnicas Las adecuaciones de su sistema de información para el funcionamiento con MasMensajes deberán ser realizadas por su integrador de TI o un experto en la materia. MasMensajes puede dar soporte en cuanto al desarrollo vía telefónica o por correo electrónico. Soporte Técnico Tecnología y Soluciones Aplicadas S.A. de C.V. Brasilia 107 Col. La Fuente Aguascalientes, Ags. CP Tel. ext. 117, 119 y 120 7