Peticiones Mensatek

Implementación del
servicio de envío
masivo de mensajes
SMS – HTTP/s API -

Versión: 4.1

Descripción:

Fecha:

funcionamiento del servicio de SMS PUSH

Uso Público

Página 1 de 9

1. DESCRIPCIÓN
Mediante este sistema se consigue la comunicación entre los servidores de
MENSATEK y otros servidores externos, utilizando el protocolo HTTP ó HTTPs para el
envío de mensajes masivosSMS. El proceso básico de comunicación es el siguiente:
MENSATEK recibe la petición GET o POST del servidor externo según los parámetros
especificados a continuación y procesa la petición.

2. SERVIDORES PARA PETICIÓN
Las peticiones se pueden realizar por HTTP o HTTPs (conexión segura) y los
parámetros pueden ser enviados en peticiones GET o POST.
Datos peticiones HTTP:
Servidor:http://api.mensatek.com/v4/ (para puerto 80 –puerto HTTP por defecto-)
Servidor http://api.mensatek.com:3377/v4/ (para puerto 3377)
Puerto: 80 ó 3377 (utilice 3377 si piensa que puede conectarse a través de proxies).
Datos peticiones HTTP:
Servidor: https://api.mensatek.com/v4/ (para puerto 443 -SSL por defecto-)
Servidor https://api.mensatek.com:3378/v4/ (para puerto 3378)
Puerto: 443 ó 3378(utilice 3378 si piensa que puede conectarse a través de proxies).

3. FUNCIONES: FUNCIÓN ENVÍO DE MENSAJES
Ejemplo: http://api.mensatek.com/v4/enviar.php?Correo=xxxx&Passwd=xxxx&....

Objetivo: ENVÍA MENSAJES SMS
PARÁMETROS ESPECIFICADOS.

CON

EL

USUARIO/CONTRASEÑA

Y

Nota: Es conveniente codificar las peticiones url, por ejemplo:
- en php:"?Correo=".urlencode(Correo)."&Passwd=".urlencode(Passwd).

- en java:
"?Correo="+URLEncoder.encode(Correo)+"&Passwd="+URLEncoder.encode(Passwd)

- …etc…
Parámetros GET o POST:
Correo: String con el correo del usuario que envía (en MENSATEK).
Página 2 de 9

Passwd: String con la contraseña del usuario que envía (en MENSATEK).
Destinatarios: Móvil/Móviles al/a los que se envía el mensaje, de la forma
PrefijoTelefono(Ej:346000000
ó
para
varios
destinatarios
346000000;3519760000;443450000)
separados
por
punto
y
coma
';'
Mensaje: Mensaje que se envía (muy recomendado utilizar funciones urlencode).
Remitente: (Por defecto "") Es el teléfono, nombre de la empresa o persona que envía.
Si se deja en blanco se enviará como remitente el teléfono móvil o remitente por
defecto registrado por el usuario que envíaen Mensatek. ATENCIÓN: Si es
alfanumérico el Máximo es de 11 caracteres.
Fecha: Fecha en la que queda programado el envío, el mensaje se enviará en esa
fecha. Por defecto "" que significa enviar inmediatamente. Formato: Año-Mes-dia
hora:minuto. La referencia horaria es GMT+1 (Zona horaria de España).
Flash: 0=No, 1=Sí
Report: 0=No, 1=Sí (recibir report por correo electrónico)
Profesional:0=No, 1=Sí (por compatibilidad con versiones anteriores de la API) Ya no
se utiliza, sustituido por ‘Descuento’
Descuento: 0=No, 1=Sí. Se envía el mensaje con un descuento del 15%.
Puede ser:
• Descuento por firma: Descuento=1 y añadir, al final del mensaje
(MENSATEK.ES)
• Descuento por remitente: Descuento=1, el sistema utiliza, de forma automática,
MENSATEK.ES como remitente si no se haañadido al final del mensaje. Es el
único descuento posible en caso de Tipo WAP_PUSH
EmailReport: Correo electrónico que recibirá el report. Si no se utiliza y se ha
seleccionado Report=1, se enviará al correo registrado como usuario en
MENSATEK.(ATENCIÓN: Debe ser un correo válido).
Tipo: SMS (mensaje de texto) o WAP_PUSH (mensaje Wap Push). Por defecto SMS.
Si el mensaje es WAP PUSH, elparámetro Mensaje debe contener la descripción del
contenido a descargar.
WPLINK: Si el Tipo es WAP_PUSH, debe contener únicamente la dirección del link
WAP que se enviará al móvil y que permitirá la descarga del contenido (imagen,
melodías, vídeos, etc..) en el móvil. El formato del link debe ser:
http://servidorwap/contenido

Referencia: Parámetro que se utiliza como referencia para el...