| Envío de
SMS mediante interfaz HTTP
Esta es la manera con la que podrá enviar desde sus páginas
web SMS a teléfonos móviles, desde un simple formulario hasta
una compleja web desde la que los usuarios puedan enviar los SMS
contando cada uno con su propia cuenta.
Usted a través de su página web tendrá que enviar la
información necesaria para el envío de mensajes SMS al FrontEnd de la plataforma a través de un servidor seguro y esta
se encargará de enviar el mensaje SMS.
Descarga de ejemplos de página Web para enviar mensajes: ejemplo en PHP , ejemplo en ASP.
URL:
https://seguro.descom.es/telapp/descomMensajes/descomxmens.php
Petición de envío
Para poder enviar mensajes, deberán de acceder al servidor seguro
a la URL arriba indicada proporcionando la siguiente información
en formato POST:
Parámetros POST:
usuario: ID del Cliente
clave: Contraseña de acceso a la plataforma
remitente: Texto del remitente personalizado
*
mens: Trama de envío múltiple
<Mensajes>
<Total>3</Total>
<Control>1</Control>
<Mensaje>
<Id>0</Id>
<Destino>0034111222333</Destino>
<Texto>50727565626173</Texto>
</Mensaje>
<Mensaje>
<Id>1</Id>
<Destino>0034222333444</Destino>
<Texto>4F74726120507275656261</Texto>
</Mensaje>
<Mensaje>
<Id>2</Id>
<Destino>0034444555666</Destino>
<Texto>4D61732050727565626173</Texto>
</Mensaje>
</Mensajes>
Donde:
Total: Número total de mensajes a enviar
en la trama
Control: Dependiendo del saldo, enviar todos
los mensajes posibles, o no enviar ninguno.
Por cada mensaje a enviar:
Id: identificador numérico del mensaje
en la trama
Destino: Teléfono destino con formato
internacional "0034666555888"
Texto: Texto del mensaje a enviar en formato
Hexadecimal
Los valores ingresados deberán cumplir los siguientes valores,
para ser enviadas como parte de la petición:
Nombre
Parámetro |
Descripción |
Posibles Valores |
Tipo de
Dato |
| usuario |
ID del cliente |
ID del cliente |
String |
| clave |
Contraseña de acceso a la plataforma |
Contraseña |
String |
| remitente |
Remitente personalizado* |
Una cadena alfanumérica hasta 11 caracteres |
String |
| control |
Control de mensajes dependiendo del saldo |
0 - Si saldo es insuficiente, no enviar ningún
mensaje
1 - Si saldo es insuficiente, enviar tantos mensajes como saldo exista
|
String |
| destino |
Número de teléfono destinataria del
mensaje |
Teléfono en formato:
acceso internacional + cod. país + teléfono Ejemplo:
0034666555444 |
String |
| texto |
Texto del mensaje |
Texto del mensaje en formato hexadecimal |
Hexadecimal |
* Puede personalizar sus envíos con un remitente personalizado
para cada SMS,
puede usar su número de móvil registrado en formato no internacional
(ej: 609111222) o una cadena de texto, en este caso deberá consultar
antes con descommensajes@descom.es
para configurar su remitente.
La información retornada será recibida en formato XML, conteniendo
la siguiente estructura:
<RXEnvio>
<Autentificacion>
<Usuario/>
<Time/>
<Resultado/>
<Comentario/>
<Saldo/>
<Versión/>
</Autentificacion>
<Mensajes>
<Mensaje>
<Id/>
<Resultado/>
<Comentario/>
</Mensaje>
</Mensajes>
</RXEnvio>
Donde:
RXEnvio : Elemento de Cabecera que contendrá
dos elementos : Autentificación y Mensajes:
A su vez el elemento Autentificación
contendrá los siguientes elementos:
Usuario : Nombre del Usuario en valor hexadecimal
Time : Time Stamp
Resultado : Devuelve el resultado de la Autentificación
0 : Autentificación fallida
1 : Autentificación correcta
Comentario : Comentario devuelto por el servidor
con el resultado de la autentificación
Saldo : Saldo en número de mensajes
que le queda al cliente después de haber enviado los mensajes.
Versión : Control de versión
de
El elemento Mensajes contendrá a su
vez tantos elementos Mensaje como mensajes
que hayan enviado.
ID : Identificativo de mensaje
Resultado : Resultado del envío del
mensaje:
0 envío fallido
1 envío correcto
Comentario : Comentario enviado por el servidor
con el resultado del envío.
|