To send SMS through the platform, the client will launch us a request to the website indicated above, using certain parameters (text to send, phone number, recipient, sender, etc.), and we will send a response confirmation that everything went well, or an error response if it hasn't.
Available configuration options, url that should be used and which parameters it admits, are detailed below.
To create the URL, the client must make a GET call to the following address:
https://gateway.nrsgateway.com/send.php
Call parameters:
text
Message body. Length must be maximum 160 characters if not specified as multipart (check parameter 'parts'). The text must be coded in UTF-8
to
Mobile phone number of the message recipient. Prefix must be included (e.g.: In Spain 34666666666). This field allows you to specify multiple recipients, this requires phone numbers to be separated by a space (e.g.: 34666666666 34666666667 34666666668)
from
Sender Text (optional), this label will consist of 15 numbers or 11 alphanumeric characters.
username
Client Code (registered mobile number in NRS Gateway)
password
Customer password for nrsgateway.com
coding
The possible values are 0 and 8. The value 0 for normal mailings with GSM7 coding and 160 characters per message and the value 8 for UCS2 coding (UTF16) and 70 characters per message.
dlr-mask(optional)
To receive delivery confirmations, always leave it at 8. Otherwise, do not specify this parameter.
fSend (optional)
Date message sent. If scheduled messages need to be sent, the mailing date can be specified by stating the date format YYYYmmddHHiiss (e.g.: 20130215142000 would be 15 February 2013 at 14:20). If mailing is immediate this parameter does not have to be specified
parts(optional)
Enter the maximum number of parts that your message will be split into. This variable defaults to 1, so if its value is not specified and the message sent contains more than 160 characters, the sending will fail. Bear in mind that concatenated messages can only contain up to 153 characters per part, and every part is billed as if it were a single message. Our server will use the minimum parts needed to send, even when the number of parts specified is greater than needed. On the other hand, if it is smaller, the mailing will fail with, error 105.
trsec (optional)
The possible values are 1 and 0. When it is set to 0, which is the default value, the server will not modify any character present on the message. On the other hand, when value is set to 1, the server will replace invalid characters in GSM7 coding for valid ones, applying the following translation table: 'á' => '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'
Call example:
The password (password) and the client code (username) will be provided by the company. It should be mentioned that in order to increase system security, the client must specify the IP from where it will connect, only sending from the IP specified by the client will be allowed.
Here you can see the response from our platform upon an SMS mailing request:
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
When an error occurs, an error description will be returned.