Acceso Area de ClienteArea Cliente LLamanos al 965 861 024965 861 024

SDK: Responder SMS

sdk-httpxml-a

 

1. Descripción

En este caso, el SMS respuesta al mensaje recibido se genera automáticamente, su contenido se construye dinámicamente en función del texto del mensaje recibido y es posible devolver un texto definido en la configuración del servicio o bien una URL.

El script genera la respuesta de forma inmediata y en texto plano; para otro tipo de respuestas, consultar Responder SMS Recibidos.

 

SDKRecibir-Respuesta-Automatica

2. Documentación

Recibimos un mensaje completo, incluyendo el número de móvil y el código de identificación del mensaje.

Podemos pasar el mensaje completo a través de un único parámetro "p1" o bien pasar cada palabra del mensaje como parámetros independientes "p1", "p2","p3"...

Recomendamos pasar el mensaje completo como parámetro "p1" a no ser que necesitemos parámetros individuales por cada palabra del mensaje.

Parámetros

En el Script de recepción de mensajes deberemos obtener como parámetros POST los siguientes datos:

Parámetro Descripción Posibles Valores Tipo de
Dato
m1

Número de móvil de quien manda el SMS en formato internacional

Numérico
id identificador unico del mensaje recibido.
Numérico
p1 Mensaje estrito en el SMS Alfanumérico

p1,p2,p3,... Cada parámetro contiene una plabra independiente del mensaje escrito en el SMS

 

3. Ejemplos

ASP


Recibimos los parámetros y
respondemos en texto plano.
Requisitos:
----- 
Ficheros: 
Fuentes

PHP


Recibimos los parámetros y
respondemos en texto plano.
Requisitos
-----
Ficheros 
Fuentes

 

4. Gráfico

sdk-httpxml-a
1. Descripción

Mediante esta API podrás contestar a cualquier mensaje recibido en tu cuenta. La contestación será enviada a nuestro servidor para ser entergada como un SMS en el destinatario original del mensaje.

La respuesta a los mensajes recibidos se realiza a través de una url, con o sin servidor seguro. Esta información contiene la información requerida para la respuesta del mensaje.

2. Documentación

URL

https://seguro.descom.es/telapp/descomMensajes/descomrespmo.php

 

Petición de envío

Para poder enviar los mensajes de respuesta, deberás acceder al servidor seguro a la URL arriba indicada proporcionando la siguiente información en formato POST:

 

Parámetros POST:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
Usuario Identificador de Usuario en Descom SMS Nombre de usuario Hexadecimal
clave Contraseña de acceso Contraseña Hexadecimal
destino Número de teléfono Móvil de mensaje a responder Teléfono en formato:
acceso internacional + cod. país + teléfono Ejemplo: 0034666555444
Numérico
id Identificador numérico del mensaje a responder Valor numérico que puede obtener de la página de mensajes No respondidos Numérico
texto Texto del mensaje de respuesta a enviar a destino Texto del mensaje de respuesta a enviar a Destino. Como máximo 160 caracteres.  

 

Los valores 'id' y 'destino' los puedes obtener de la lista de mensajes recibidos no respondidos en la Categoría asíncrona el página Web de la plataforma de su cuenta.

 

Respuesta

La información retornada será recibida en formato XML, conteniendo la siguiente estructura:

Estructura básica XML de respuesta:

Etiqueta Raiz: <RXEnvio>

Esta etiqueta debe envolver todos los datos XML de la llamada.

<RXEnvio>  Tus datos....  </RXEnvio>

Definición de trama de respuesta:

<RXEnvio>
<Autentificacion>
    <Usuario/>
    <Time/>
    <Resultado/>
    <Comentario/>
</Autentificacion>
<Mensajes>
   <Mensaje>
     <Id/>
     <Resultado/>
     <Comentario/>
   </Mensaje>
</Mensajes>
 </RXEnvio>
 


Donde:

Nombre
Parámetro
Descripción Posibles Valores Tipo de
Dato
Usuario Identificador de Usuario en Descom SMS Nombre de usuario Alfanumérico en Hexadecimal
Resultado Resultado de la autentificación en Descom SMS 1-> autentificación correcta
0->Fallo en la autentificación 
Numérico
Comentario Texto descriptivo del resultado de la autentificación   Alfanumérico
Saldo Saldo actual en Descom SMS de tu cuenta   Numérico

 

Por cada mensaje contestado, el elemnto <Mensaje> contiene.

Parámetro Descripción Posibles Valores Tipo de
Dato
Id

Identificador del mensaje respondido

  Numérico
Resultado Resultado del envio del mensaje 0 -> envío fallido
1 -> envío correcto
Numérico
Comentario Comentario enviado por el servidor con el resultado del envío.    

 

Ejemplos de Respuesta:

 <?xml version="1.0" encoding="UTF-8"?>
 <!--Secuencia de respuesta del Servidor a un envio del cliente-->
 <!--En este caso, envio Correcto-->
 <RXEnvio>
  <Autentificacion>
    <Usuario>user</Usuario>
    <Time>0402031550417</Time>
    <Resultado>1</Resultado>
    <Comentario>Autentificacion satisfactoria</Comentario>
  </Autentificacion>
  <Mensajes>
    <Mensaje>
      <Id>112233</Id>
      <Resultado>1</Resultado>
      <Comentario>Mensaje Respondido</Comentario>
    </Mensaje>
  </Mensajes>
 </RXEnvio>
 

<?xml version="1.0" encoding="UTF-8"?>
 <!--Secuencia de respuesta del Servidor a un envio del cliente-->
 <!--En este caso, envio Incorrecto-->
 <RXEnvio>
 <Autentificacion>
    <Usuario>user</Usuario>
    <Time>0402031550417</Time>
    <Resultado>1</Resultado>
    <Comentario>Autentificacion satisfactoria</Comentario>
 </Autentificacion>
 <Mensajes>
  <Mensaje>
    <Id>112233</Id>
    <Resultado>0</Resultado>
    <Comentario>Mensaje no Respondido</Comentario>
  </Mensaje>
 </Mensajes>
 </RXEnvio>
 

 <?xml version="1.0" encoding="UTF-8"?>
 <!--Secuencia de respuesta del Servidor a un envio del cliente-->
 <!--En este caso, la autentificacion es erronea,no se envia nada-->
 <RXEnvio>
 <Autentificacion>
    <Usuario>user</Usuario>
    <Time>040203100417</Time>
    <Resultado>0</Resultado>
 <Comentario>Autentificacion erronea</Comentario>
 </Autentificacion>
 </RXEnvio>
 

3. Ejemplo

Fuentes

4. Gráfico