SMS Gateway HTTP request variables


This file specifies variables which can be used in SMS Gateway http request

Formal Syntax:

%number% = National or local number  
%name% = Number name  
%binary% = Data must be base64 encoded and DCS will be set to 8bit data  
%ip% = IP address of the sender  
%data% %body% = Actual data  
%udh% = UDH if required - specify UDH without the length (calculated automatically) base64 encoded  
%pid% = PID if required  
%dcs% = DCS if required - DCS is created automatically according to binary and data content (7bit, 8bit, unicode) - if not binary is specifed and data contain 8bit chars UTF-8 is assumed and unicode will be used  
%reply% = Reply address - UDH II  
%sender% = Original sender email address  
%authenticated% = Indicates if sender is authenticated  
%msgid% = Message-ID to be used  
%user% %pass% %id% = User, pass and id used for authentication if required  
%maxmsgs% = Max messages (SAR)  
%sender_phonealias% = Sender alias  
%parts% = The number of messages in total  
;len = The ;len parameter attribute adds the length character to any variable, usually used for UDH, eg. %udh;len;hex%.The ;len attribute puts the length of the parameter value to the beginning of the parameter, as required for proper UDH handling by Clickatell gateway. It can be used for any parameter such as %body;len%.  
;hex ;b64 = The ;hex parameter attribute encodes the parameter to hexadecimal format. The ;b64 parameter attribute encodes the parameter to the base64 format. Both attributes are applicable to all HTTP parameters and can be used if required but the remote gateway.  
;unicode = The ;unicode parameter attribute encodes the parameter to Unicode format.  
;entity = The ;entity parameter attribute encodes all non-ascii chars into � form  
;isunicode ;isascii ;isbinary ;value = The set of query parameter modifiers ;isunicode, ;isascii, ;isbinary, ;value allows to select from the following attribute modifiers based on the encoding of a parameter, or to append a custom value= parameter only if a condition (isunicode, isascii, isbinary) is met. ;value returns value attribute (key stripped from %-%)  
%condition% = The dummy variable %condition% is replaced with empty string as the request is processed, and as such is suitable for creating conditional expressions, e.g.: %condition;isunicode;value=&unicode=1%.  
 

Examples:

IceWarp HTTP Gateway http://server/sms/?user=XXX&pass=YYY&number=%number%&data=%data%&udh=%udh%&binary=%binary%&pid=%pid%&dcs=%dcs%&sender=%sender%&msgid=%msgid%
O2 CZ HTTP Gateway https://smsconnector.cz.o2.com/smsconnector/getpost/GP?action=send&baID=XXX&toNumber=%number%&text=%data;charset=ASCII//translit%
Clickatell HTTP Gateway http://api.clickatell.com/http/sendmsg?user=XXX&password=YYY&api_id=XXX&to=%number%%condition;isascii;value=&text=%%condition;isunicode;value=&text=%%condition;isbinary;value=&data=%%data;isascii%%data;hex;isunicode;unicode;value=&unicode=1%%data;hex;isbinary;value=&udh=%%udh;len;hex;isbinary%&concat=%parts%
Routo HTTP Gateway http://smsc5.routotelecom.com/SMSsend?user=XXX&pass=YYY&number=%number%&message=%data%&type=LongSMS
MDtech HTTP Gateway http://openapi.mdtechcorp.com:20000/openapi/?destinatingAddress=%number%&username=XXX&password=XXX&SMS=%data;entity%&originatingAddress=XXX&type=1
SMSCELL http://web.smscel.com.br/sms/painel/models/getsmscparty.php?user=XXX&password=YYY&codpessoa=ZZZ&to=%number%&msg=%data%&enviarimediato=S
Human - BR http://system.human.com.br/GatewayIntegration/msgSms.do?dispatch=send&account=XXX&code=YYY&to=%number%&msg=%data%