1

PUSH MSISDN HTTP MODE

Technical Documentation

PUSH MSISDN HTTP

2

Contents

I Introduction...................................................................................p. 03

II Set up of a client account for http push mode......................p. 04

III Use of the API…… .........................................................................p. 05

1 - Credit information............................................................................... p. 05 2 - Send an SMS to one recipient ............................................................. .p. 06 3 - Send an SMS to various recipients ………………………………………......................p. 09 4 - Checking the number of characters and the number of SMS………………………..p. 12 5 - Shifted scheduling ............... ...... ...... …………………………...... ...... ............p. 12 6 - Directories management. .. ..... .... .... ......... ...... ...... ...... ...... ............p. 13 7 - Download of the sending reports.... ...... ...... …………………..... ...... ............p. 16 8 – Blacklist ............................................................................................p. 17 9 - Return of acknowledgments……............................................................. p. 17 10 - Return of sms sent by clients.................................................................p. 18

11 - Checking phone numbers ...................................................................p. 19 12 - Add numbers to the blacklist ...............................................................p. 21 13 - Delete numbers from the blacklist ........................................................p. 23 14 - Download of the blacklist……................................................................p. 24 15 - Sendings in non latin alphabet.............................................................p. 24

IV ANNEXES.................................................................. p. 25

1 - Error Code Table ............................................................................... .p. 25 2 - Authorized characters in SMS are the GSM ones………………………………………… . .p. 27 3 - Table to transcode a GET or POST request …………………………………………………………......... p. 32 4 - Technical Support .............................................................................. .p. 32 DixData - 19 Chemin des Travails - 06800 Cagnes-sur-Mer RCS Marseille B 443 014 238 –

PUSH MSISDN HTTP

3

Sarl au capital de 108 000€ Siret 44301423800028 - TVA Intra FR39443014238

PUSH MSISDN HTTP

4

I - Introduction The document is divided into 3 parts:

- The first part deals with the creation of a message sending account

- The second part presents the sending of messages

- The third part contains the annexes

If you have technical questions please contact support at the following address: support@iSendPro.com

Technical support is available every day of the week from 9 am to 1 pm and from 2 pm to 5pm (GMT+1).

PUSH MSISDN HTTP

5

II – Set up of a client account for http push mode

It is necessary to have a valid account with credit.

For each message sent, one credit will be used.

• Information needed to create an account:

- Company name

- Lastname Firstname

- Phone number

- Email

- IP adresse(s) to authorize

• Information given in return:

- Login

- Password

PUSH MSISDN HTTP

6

III – Use of the API Call to the API can be done using http or https protocol. The request must be encoded in ISO-8859-15

Note: The keyId is available on your website access in the “My account” section.

1 – Credit information

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&credit=[CREDIT]

Argument Value Resul credit 1 Remaining credits in euros excl VAT credit 2 Remaingin credits in number of SMS

Example with credit=1:

<?xml version="1.0" encoding="ISO-8859-15"?>

<state>

<credit>108.16</credit>

</state>

Example with credit=2:

<?xml version="1.0" encoding="ISO-8859-15"?>

<state>

<credit>108.16</credit>

<quantity>2704</quantity>

</state>

PUSH MSISDN HTTP

7

2 - Send an SMS to one recipient

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num=[NUM]

• Change the sender id The sender id must be an alphanumeric string between 4 and 11 characters. Accepted characters are numbers between 0 and 9, letters between A and Z and space. It cannot be only numbers.

The following data has to be added to the query: &senderid=[SENDER_ID]

The request becoming:

http://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num=[NUM] &senderid=[SENDER_ID]

• Tracking the sending

The tracker must be an alphanumeric string up to 50 characters.

This tracker will be returned to defined query for the operators notifications and returned SMS (page13)

The following data has to be added to the query : &tracker=[TRACKER]

The request becoming:

http://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num=[NUM] &senderid=[SENDER_ID]&tracker=[TRACKER]

• Long SMS

The long SMS allows to exceed the limit of 160 characters by sending a message consisting of several SMS.

For technical reasons, the concatenated SMS limit is 153 characters.

Number of SMS Concatenated

Number of characters

1 160 2 306 3 459 4 612 5 765 6 918

PUSH MSISDN HTTP

8

The following data has to be added to the query:

&smslong=[NB_SMS_CONCATENED]

The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num= [NUM]&senderid=[SENDER_ID]&smslong=[NB_SMS_CONCATENED]

If the length of the message exceeds the maximum length allowed for the specified number of concatenated SMS messages, an error will be returned.

Example: &smslong=5 but the length of the message transmitted corresponds to 6 SMS then an error will be returned.

In order not to have this error message and obtain a dynamic calculation of the number of SMS then it is necessary to set:

&smslong=999

PUSH MSISDN HTTP

9

• Data format

Data Format Examples keyid string a296464ce012b8ab710a sms string Hello, how are you ?

num 11 numeric 33601020304 ou 40701020304 senderid alphanumeric MyCompany tracker alphanumeric myAccount_myId smslong 1-3 numeric 1

A return is made following this request indicating the success or failure of the delivery.

A code 0 is returned in case of success (Cf Annexes for the other codes). Success example:

<?xml version="1.0" encoding="ISO-8859-1"?> <state> <code>0</code> <tel>33601020304</tel> <message>Your message has been sent</message> </state>

Failure example:

<?xml version="1.0" encoding="ISO-8859-1"?> <state> <code>6</code> <message>You must set a valid phone number</message> </state>

The message must not exceed 160 characters otherwise the message will not be sent and an error will be returned. If you use the GET method, special characters can not be contained in the message to be sent. They must be transcoded. Encoding involves replacing special characters with the% character followed by the code ASCII of the character to be encoded in hexadecimal notation. For example, the "+" character should be replaced with "% 2B". (See Annex URL Transcoding Table).

PUSH MSISDN HTTP

10

3 - Send an SMS to var ious recipients This solution makes it possible to send a message up to 500 different recipients per request, thus allowing an increase in the speed of the mailings. Phone numbers are placed in numX variables where X is an integer from 1 to 500 at most. If the message is identical for all the recipients, it must be set only once in the sms data. If the message is different for each recipient then the messages are placed in smsX variables where X is an integer from 1 to 500. In this case the smsX message will be sent to the recipient numX Technical constraints specific to GET requests can generate errors if the total query is too long. To counter this, either switch to POST mode or reduce the number of multiple recipients.

Note: It is imperative that all the numbers of the same request are destined for the same country.

The examples of scripts in php downloadable at the end of document, use the protocol POST. The sending of messages takes place with the following requests for a different message for each recipient:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms1=[SMS1]&num1= [NUM1]&sms2=[SMS2]&num2=[NUM2]…&sms50=[SMS50]&num50=[NUM50]

Sending messages is done with the following queries for an identical message for all recipients:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num1= [NUM1]&num2=[NUM2]…&num50=[NUM50]

• Change the sender id

The sender id must be an alphanumeric string between 4 and 11 characters. Accepted characters are numbers between 0 and 9, letters between A and Z and space. It cannot be only numbers. The following data has to be added to the query:

&senderid=[SENDER_ID] The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&senderid= [SENDER_ID]&sms=[SMS]&num1=[NUM1]&num2=[NUM2]…&num50=[NUM50]

PUSH MSISDN HTTP

11

• Tracking the sending

The tracker must be an alphanumeric string up to characters.

This tracker will be sent back to the specified queryl for the operators acknowledgments and returned SMS (page13).

The tracker is relative to each sending, it will be necessary to associate the trackerX with numX

The following data has to be added to the query :

&trackerX=[TRACKERX] Example:

http://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms1=[SMS1]&num1= [NUM1]&tracker1=[TRACKER1]&sms2=[SMS2]&num2=[NUM2]&tracker2= [TRACKER2]…&sms50=[SMS50]&num50=[NUM50]&tracker50=[TRACKER50]

• Long SMS

The long SMS allows to exceed the limit of 160 characters by sending a message consisting of several SMS. For technical reasons, the concatenated SMS limit is 153 characters.

Number of SMS Concatenated

Number of characters

1 160 2 306 3 459 4 612 5 765 6 918

The following data has to be added to the query : &smslong=[NB_SMS_ CONCATENED]

The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num= [NUM]&senderid=[SENDER_ID]&smslong=[NB_SMS_CONCATENED]

If the length of the transmitted message exceeds the maximum length allowed for the specified number of concatenated SMS messages, an error will be returned. Example: &smslong=5 but the length of the message transmitted corresponds to 6 SMS then an error will be returned.

PUSH MSISDN HTTP

12

In order not to have this error message and obtain a dynamic calculation of the number of SMS then it is necessary to inform:

&smslong=999 Data Format Examples

keyid string a296464ce012b8ab710a sms string Hello, how are you ?

num 11 numeric 33601020304 ou 40701020304 senderid alphanumeric MyCompany tracker alphanumeric myAccount_myId smslong 1-3 numeric 1

A return is made following this request indicating the success or failure of the delivery. A code 0 is returned in case of success.(Cf Annexes for the other codes) Sucess example:

<?xml version="1.0" encoding="ISO-8859-1"?> <state> <state1> <code1>0</code1> <tel1>0601020304</tel1> <message1> Your message has been sent </message1> </etat1> … <etat50> <code50>0</code50> <tel50>0601020304</tel50> <message50> Your message has been sent </message50> </state50> </state>

Failure example:

<?xml version="1.0" encoding="ISO-8859-1"?> <state> <code>3</code>

<message>identification failed</message> </state>

PUSH MSISDN HTTP

13

It is imperative that the length of the message does not exceed 160 characters otherwise the message will not be sent and an error message will be returned to you. If you use the GET method, special characters can not be contained in the message to be sent. They must be transcoded. Encoding involves replacing special characters with the% character followed by the code ASCII of the character to be encoded in hexadecimal notation. For example, the "+" character should be replaced with "% 2B". (See Annex URL Transcoding Table).

4 – Checking the number of characters and the number of SMS Before sending your messages, it is possible to control the number of characters and the number of sms associated. The following data has to be added to the query:

&counting=1 No credit will be withdrawn. The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num= [NUM]&senderid= [SENDER_ID]&smslong=[NB_SMS_CONCATENED]&counting=1

Example of an answer: <?xml version="1.0" encoding="ISO-8859-1"?> <state> <tel>0601020304</tel> <nb_sms>2</nb_sms> <nb_character>234</nb_character> </state>

5 – Shifted scheduling You can set a delayed shipment date. The following data has to be added to the query:

&sending_date=[AAAA-MM-JJ HH :MM] The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sms=[SMS]&num= [NUM]&senderid=[SENDER_ID]&smslong=[NB_SMS_CONCATENED] &sending_date=[AAAA-MM-JJ HH :MM]

Example : To send on the november 25th of 2016 at 16h30, the data sending_date would be 2016-11-25 16:30

PUSH MSISDN HTTP

14

6 – Directories management Create a directory

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&directoryEdit=create&directoryName=[DirectoryName]

Data Format Examples keyid String a296464ce012b8ab710a directoryEdit String create

directoryName String Mydirectory

In return, you get an id associated to your new directory. Example:

<?xml version="1.0" encoding="ISO-8859-1"?> <state> <code>100</code> <directoryId>39565</directoryId> <message>Your directory has been created!</message> </state>

Add contacts to a directory The telephone numbers are placed in the numerical variables where X is an integer from 1 to 500 maximum according to the quantity of numbers to be added

The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&directoryEdit=add& directoryId=[directoryId]&num1=[NUM1]…&num50=[NUM50]

Data Format Examples keyid String a296464ce012b8ab710a directoryEdit String add directoryId Numeric 78946 num 11 Numeric 33601020304 or 33701020304

PUSH MSISDN HTTP

15

Example:

<?xml version="1.0" encoding="ISO-8859-1"?> <state> <state1> <code1>103</code1> <directoryId>39565</directoryId> <tel1>0601020304</tel1> <message1>Your data has been added to the directory!</message1> </state1> <state2> <code2>103</code2> <directoryId>39565</directoryId> <tel2>0601020305</tel2> <message2>Your data has been added to the directory!</message2> </state2> </state>

Delete contacts from a directory The telephone numbers are placed in the numerical variables where X is an integer from 1 to 500 maximum according to the quantity of numbers to be deleted

The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&directoryEdit=del& directoryId=[directoryId]&num1=[NUM1]…&num50=[NUM50]

Data Format Examples keyid String a296464ce012b8ab710a directoryEdit String del directoryId Numeric 78946 num 11 Numeric 33601020304 or 33701020304

PUSH MSISDN HTTP

16

Example:

<?xml version="1.0" encoding="ISO-8859-1"?> <state> <state1> <code1>103</code1> <directoryId>39565</directoryId> <tel1>0601020304</tel1> <message1>Your data has been deleted!</message1> </state1> <state2> <code2>103</code2> <directoryId>39565</directoryId> <tel2>0601020305</tel2> <message2> Your data has been deleted!</message2> </state2> </state>

PUSH MSISDN HTTP

17

7 – Download of the sending reports

Sending reports can be downloaded in a csv file conteing all the details on given period.

The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&sendingReport=1&starting_date=[AAAA-MM-JJ HH:MM]&ending_date=[AAAA-MM-JJ HH:MM]

Data Format Examples keyid String a296464ce012b8ab710a

sendingReport 1 numeric 1 starting_date Date 2016-11-02 09:00 ending_date Date 2016-11-17 17:45

The columns in the file will be:

Data Format Examples Sending date 1 numeric 01/07/2016 12:18

Sender id alphanumeric iSenPro Recipient 11 numeric 33601020304 Message String Special offer, 10% off

Information String SFR: SMS sent

Details String Message for 0033601020304 has Status String 0 ou ACK ou etc

SMS return String Thank you Channel String High Quality

Price numeric 0,044 STOP numeric 0

Tracker String mytracker123 Note: For performance reasons, the file can not exceed 200 000 lines, otherwise an error message will be raised.

PUSH MSISDN HTTP

18

8 - Blacklist

A list of phone numbers to which messages are not sent is handled. The numbers are added at the request of the operators or our partners. All messages sent to blacklisted clients are not routed. In this case, error code 11 is returned to the request.

9 - Return of the acknowledgments For each message sent, an acknowledgment can be returned. The sending of this data is done by the following http request:

www.your_address.com/your_page?tel=[TEL]&libelle=[LIBELLE]&statut= [STATUT]&code_erreur=[CODE_ERREUR]&date=[DATE]&heure=[HEURE]&id=[ID] &operateur=[OPERATEUR]&tracker=[TRACKER]

Format des variables

Data Format Examples tel 10 numeric 0661457895 libelle String The message has been sent statut 1 numeric 0 -> ok and 2 -> error code_erreur 3 numeric 108 cf annexes

date AAAA-MM-JJ 2012-08-12 heure HH:MM:SS 11:15:45 id numeric 35986 tracker alphanumeric myAccount_myId

Example :

www.mysite.com/recup.php?tel=0612345678&libelle=Message%a%destination %de%0612345678%portant%le%numero%040318143520%a%ete%recu %le%2012-08-12%a%14:35:28&statut=0&code_erreur=000&date=2012-08-12 &heure=15:07:12&id=35986&tracker=compte12_5874

PUSH MSISDN HTTP

19

Process by your webpage

It is necessary to develop a web page that will process the received data. This page should display only the result of the processing, ie the word "validation" if the processing was indeed done and the word "problem" if not and especially not having any html structures. The webpage can be in php, jsp or asp, it does not matter. To send the data it is necessary that you provide us a url not protected by passwords. It will be like: www.your_address.com/your_page

Note: If your webpage does not return the “validation” message, 3 more attempts to send the acknowledgment will be made the next days at 2:00 am.

10 - Return of sms sent by clients When sending, customers can answer with an SMS that will be processed by our platform.

It is possible to receive these messages via the following request:

www.your_address.com/your_page?tel=[TEL]&id_retour=[ID_RETOUR] &msg_sms=[MSG_SMS]&tracker=[TRACKER]

Data Format Examples

tel 11 numeric 33661457895

id_retour numeric 5454646 unique id associated to the last SMS sent to the client

msg_sms String STOP SMS Answer from the client

tracker alphanumeric myAccount_myId Example:

www.mysite.com/recup.php?tel=33612345678&id_retour=545454545 &msg_sms=STOP%20SMS&tracker=account12_5874

PUSH MSISDN HTTP

20

Process by your webpage

It is necessary to develop a web page that will process the received data. This page should display only the result of the processing, ie the word "validation" if the processing was indeed done and the word "problem" if not and especially not having any html structures. The webpage can be in php, jsp or asp, it does not matter. To send the data it is necessary that you provide us a url not protected by passwords. It will be of the form:

www.your_address.com/your_page

Note: If the sender id is changed, if the clients answer the SMS directly, an error will be reported to them because the sender id will not be recognized by their operator and their reply will not be transmitted to you. Note: the return SMS is not provided on every country, please ask your contact to know if it is available on the desired country.

11 – Checking phone numbers Please ask your contact about the pricing.

The request is:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&getHLR=1&num1 =[NUM]_&num50=[NUM50]

Phone numbers are placed in the numX variables where X is an integer from 1 to 500 maximum.

Data Format Exa

keyid String a296464ce012b8ab710a numX 10 numeric 0601020304 ou 0701020304 getHLR 1 numeric 1

The XML return with one number in the request is like:

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<tel>[NUM]</tel>

<operator>[OPERATEUR]</operator>

</state>

PUSH MSISDN HTTP

21

Or like this with various numbers in the request:

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<state1>

<tel1>[NUM]</tel1>

<operator1>[OPERATEUR]</operator1>

</state1>

…

<state50>

<tel50>[NUM]</tel50>

<operator50>[ OPERATEUR]</operator50>

</state50>

</state>

Where [NUM] is the phone number set in the request. The possible values for [OPERATEUR] are:

Valeur Signification INVALIDE invalid number INVALIDE-LISTE NOIRE invalid number and blacklisted INTE International valid number

PUSH MSISDN HTTP

22

Examples:

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<state1>

<tel1>33611111111</tel1>

<operator1>INVALIDE</operator1>

</state1>

…

<state50>

<tel50>33622222222</tel50>

<operator50>INTE</operator50>

</state50>

</state>

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<tel>33612345678</tel>

<operator>INVALIDE-LISTE NOIRE</operator>

</state>

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<tel>33614345678</tel>

<operator>INTE</operator>

</state>

12- Add numbers to the blacklist The request is:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&setBlackList=1&num1 =[NUM]…&num50=[NUM50]

Phone numbers are placed in the numX variables where X is an integer from 1 to 500 maximum.

PUSH MSISDN HTTP

23

Data Format Exa

keyid String a296464ce012b8ab710a numX 11 numeric 33601020304 or 34701020304 setBlackList 1 numeric 1

The XML return with one number in the request is like:

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<tel>[NUM]</tel>

<blackList>[RES]</blackList>

</state> Or like this with various numbers in the request:

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<state1>

<tel1>[NUM]</tel1>

<blackList1>[RES]</blackList>

</state1>

…

<state50>

<tel50>[NUM]</tel50>

<blackList50>[RES]</blackList50>

</state50>

</state>

Where [NUM] is the phone number set in the request. The possible values for [RES]

are:

Valeur Signification OK The phone number has been added to the blacklist NOK The phone number has NOT been added to the blacklist

Only the valid phone numbers can be added to the blacklist.

PUSH MSISDN HTTP

24

13- Delete numbers from the blacklist The request is:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&delBlackList=1&num1 =[NUM]…&num50=[NUM50]

Phone numbers are placed in the numX variables where X is an integer from 1 to 500 maximum.

Data Format Exa

keyid String a296464ce012b8ab710a numX 11 numeric 33601020304 or 34701020304 delBlackList 1 numeric 1

The XML return with one number in the request is like:

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<tel>[NUM]</tel>

<blackList>[RES]</blackList>

</state> Or like this with various numbers in the request:

<?xml version="1.0" encoding="ISO-8859-1"?>

<state>

<state1>

<tel1>[NUM]</tel1>

<blackList1>[RES]</blackList>

</state1>

…

<state50>

<tel50>[NUM]</tel50>

<blackList50>[RES]</blackList50>

</state50>

</state>

PUSH MSISDN HTTP

25

Where [NUM] is the phone number set in the request. The possible values for [RES]

are:

Valeur Signification OK The phone number has been deleted from the blacklist NOK The phone number has NOT been deleted from the blacklist

Only the valid phone numbers can be deleted to the blacklist. 14 – Download of the blacklist

Sending reports can be downloaded in a csv file contening the blacklist.

The request becoming:

http(s)://www.isendpro.com/cgi-bin/?keyid=[KEYID]&getBlackList=1

Data Format Examples keyid String a296464ce012b8ab710a

getBlackList 1 numeric 1 The columns in the file will be:

Data Format Examples MSISDN 11 numeric 33601020304

15 – Sendings in non latin alphabet

You can send non latin alphabet message (Russian, chinese, Arabic, etc) to your mobile numbers. To do so, the request must be encoded in UTF-8 and contain the argument:

&ucs2=1

For technical reasons, 1 SMS can not exceed 70 characters (instead of the usual 160) and in the case of long SMS, each SMS can not exceed 67 characters.

PUSH MSISDN HTTP

26

IV - Annexes

1 - Error Code Table

Error code Message 0 Your message has been sent 1 The login is empty 2 The password is empty 3 Your credentials are incorrect 4 You must enter a message 5 The message can not exceed 160 characters 6 You must enter a valid phone number 7 You must enter a valid phone number 11 The phone number is in the blacklist 12 You are out of credit 14 The IP adress is not allowed 16 The sender id can not be empty if defined 17 The sender id must be between 3 and 11 characters

18 The sender id can not contain only numbers 21 The phone number is invalid 23 The maximum number by request is 500 25 You must set the cost to number in 0899

26 You must set the cost to number in 0892

27 This country is not authorized 28 You are out of qualification credit 29 An error has occured (overflow) 30 Error on the connection domain 31 The message can not exceed [X] characters 32 The message is on [X] SMS ([Z] characters) whereas the request

is on[Y] SMS 33 This sender id is not authorized

34 The value of smslong must be an integer

35 You are out of HLR credit

37 Phone numbers are not all for the same country

38 The message can not exceed [X] characters!

39 The message can not exceed [Y] characters!

40 The ucs2 is not allowed with french numbers

41 You can not process HLR requests

PUSH MSISDN HTTP

27

42 The send id can not contain special characters 43 The sending data is not well formatted (AAAA-MM-JJ HH:MM) 100

Your directory has been created

101 You must enter a directory name 102 The directory id has no match 103 Your data has been added to the directory 104 The directory can not be modified because a campaign is scheduled

on it

105 The data is already in the directory 106 The data has been deleted from the directory 107 The data is not in the directory 201 You must enter a starting date 202 You must enter an ending date 203 The starting date is not well formatted (AAAA-MM-JJ HH:MM) 204 The ending date is not well formatted (AAAA-MM-JJ HH:MM) 205 The query is over 200 000 data! Please, reduce it 999 An error has occured. Please contact the technical support

PUSH MSISDN HTTP

28

2 – Authorized characters in SMS are the GSM ones

Warning, the characters [ and ] (code 91 and 93), the line feed (code 10) and the euro symbol € count for 2 characters. Some characters need to be transcoded (cf 3- Table to transcode)

Accepted characters Code

in base 10

Character

Meaning

10 LF Line Feed 13 CR Carriage Return 32 SP Space 33 ! 34 " 35 #

37 % 38 &

39 ' 40 ( 41 ) 42 * 43 + 44 ,

PUSH MSISDN HTTP

29

45 - 46 . 47 / 48 0 49 1 50 2 51 3 52 4 53 5 54 6 55 7 56 8 57 9 58 : 59 ; 60 < 61 = 62 > 63 ? 64 @ 65 A

66 B

67 C

68 D

69 E

70 F

71 G

72 H

73 I

74 J

75 K

76 L

77 M

78 N

79 O

80 P

81 Q

82 R

PUSH MSISDN HTTP

30

83 S

84 T

85 U

86 V

87 W

88 X

89 Y

90 Z

91 [ 93 ] 95 _

97 a

98 b

99 c

100 d

101 e

102 f

103 g

104 h

105 i

106 j

107 k

108 l

109 m

110 n

111 o

112 p

113 q

114 r

115 s

116 t

117 u

118 v

119 w

120 x

121 y

122 z

PUSH MSISDN HTTP

31

224 à

232 è

233 é

234 ê

249 ù

Characters replaced Code

en base 10

Caractère

Replaced by

192 À A 193 Á A 194 Â A 195 Ã A 196 Ä A 197 Å A 200 È E 201 É E 203 Ë E 204 Ì I 205 Í I 206 Î I 207 Ï I 210 Ò O 211 Ó O 212 Ô O 213 Õ O 214 Ö O 217 Ù U 218 Ú U 219 Û U 220 Ü U 225 á a 226 â a 227 ã a 228 ä a 229 å a 231 ç c

PUSH MSISDN HTTP

32

234 ê e 235 ë e 236 ì i 236 ì i 237 í i 238 î i 239 ï i 240 ð o 241 ñ n 242 ò o 243 ó o 244 ô o 245 õ o 246 ö o 249 ù u 250 ú u 251 û u 252 ü u 253 ý y 255 ÿ y

PUSH MSISDN HTTP

33

3 – Table to transcode a GET or POST request

Character Code point (hex)

Space %20 $ %24 & %26 + %2B , %2C / %2F : %3A ; %3B = %3D ? %3F @ %40 € Ê or %ca

Line feed Õ or %d5

4 – Technical Support You can contact the technical support by email at support@iSendPro.com

Our support is available from monday to friday and from 9 am to 5 pm. You can download php examples scripts by clicking HERE