Para poder enviar SMS a través de la plataforma, el cliente nos lanzará una petición a la web indicada posteriormente, usando ciertos parámetros (texto a enviar, número de teléfono destinatario, remitente, etc.), y nosotros le devolveremos una respuesta de confirmación de que todo ha ido bien, o una respuesta de error en caso contrario.
A continuación se detallará las opciones de configuración disponibles, la URL a la que se debe llamar, y los parámetros que admite.
Para generar la URL el cliente deberá hacer una llamada GET a la siguiente dirección:
https://gateway.nrsgateway.com/send.php
Parámetros de la llamada:
text
Texto del mensaje. Como máximo puede tener 160 caracteres si no se especifica que el mensaje sea multiparte (ver parámetro 'parts'). El texto tiene que estar codificado en UTF-8
to
Número de teléfono móvil destinatario del mensaje. Debe incluir el prefijo (Ej: En España 34666666666). Este campo permite indicar múltiples destinatarios, para ello hay que separar los números de teléfono por un espacio (Ej: 34666666666 34666666667 34666666668)
from
Texto del Remitente (opcional), esta etiqueta se compondrá de 15 números o 11 caracteres alfanuméricos.
username
Código del cliente (número de móvil registrado en NRS Gateway)
password
Clave de acceso del cliente en nrsgateway.com
coding
Los posibles valores son 0 y 8. El valor 0 para envíos normales con codificación GSM7 y 160 caracteres por mensaje y el valor 8 para codificación UCS2 (UTF16) y 70 caracteres por mensaje.
dlr-mask(opcional)
Para recibir confirmaciones de entrega dejarlo siempre en 8, en caso de no necesitarlo no hay que especificar este parámetro.
fSend (opcional)
Fecha en envió del mensaje. Si se necesita enviar mensajes programados se puede especificar la fecha de envío indicando la fecha en formato YYYYmmddHHiiss (Ej: 20130215142000 sería el 15 de febrero de 2013 a las 14:20). En caso de envío inmediato no se tiene que especificar este parámetro.
parts(opcional)
Indica el número máximo de partes en que se dividirá el mensaje para su envío. Esta variable tiene valor 1 por defecto, por lo que si no se especifica y se envía un mensaje de más de 160 caracteres para codificación 0, el mensaje fallará. Hay que tener en cuenta que los mensajes concatenados solo pueden tener 153 caracteres por parte y que cada parte se tarifica como un envío. El servidor solo utilizará el mínimo de partes necesaria para realizar el envío del texto aunque el número de partes especificado sea superior al necesario. En caso de que el número de partes sea inferior al necesario para el envío del texto, el envío fallará con el error 105.
trsec (opcional)
Los valores posibles son 1 y 0. Con el valor 0 el servidor no modifica ningún carácter del mensaje, este es el valor por defecto. Con el valor 1 el servidor se encarga de modificar los caracteres comunes no validos en GSM7 a caracteres validos con la siguiente tabla de traducción: 'á' => 'a', 'í'=>'i', 'ó'=>'o', 'ú'=>'u', 'ç'=>'Ç', 'Á'=>'A', 'Í'=>'I', 'Ó'=>'O', 'Ú'=>'U', 'À'=>'A', 'È'=>'E', 'Ì'=>'I', 'Ò'=>'O', 'Ù'=>'U', 'º' => '', 'ª' => '', 'Õ' => 'O', 'õ' => 'o', 'â' => 'a', 'ê' => 'e', 'î'=>'i', 'ô'=>'o', 'û'=>'u', 'Â'=>'A', 'Ê'=>'E', 'Î'=>'I', 'Ô'=>'O', 'Û'=>'U', 'ã' => 'a', 'Ã' => 'A'
Ejemplo de llamada:
La clave de acceso (password) y el código del cliente (username) serán proporcionados por la empresa. Hay que comentar que con objeto de aumentar la seguridad del sistema, el cliente deberá indicar la IP desde donde se va a conectar, solo se permitirán envíos de la IP indicada por el cliente.
Como se observa, la respuesta que devuelve la plataforma ante una petición de envío de SMS tendrá la siguiente sintaxis:
https://gateway.plusmms.net/send.php?username=tu_user &password=tu_login&to=3465467445+34627455334+34627545454&text=Prueba+de+envio&from=TEST&coding=0&dlr-mask=8
En caso de error se devolverá una descripción del motivo del error.