Free and immediate reminder Free and immediate reminder
04.13.41.50.70 (appel gratuit depuis un fixe)

Send push SMS

Definition

This sends a simple SMS. You can specify multiple phone numbers in the "sms_recipients" parameter by separating them with a ",".
One good way to use this is to send to blocks of 200 to 500 numbers at a time during your campaigns:

  • < 200: you multiply calls and waste connection time
  • > 500: the frame becomes heavy and the risk of data loss increases.

URL

http://www.octopush-dm.com/api/sms
or
https://www.octopush-dm.com/api/sms

Encoding

UTF-8

Special parameters

Name Definition
user_login User login (email address).
api_key API key available on your manager.
sms_recipients List of numbers in international format + XXZZZZZ separated by commas.
sms_text Message text (maximum 459 characters).
sms_type SMS Type: XXX = Low Cost SMS; FR = Premium SMS; WWW = Global SMS. In France, if "STOP XXXXX" is missing from your text, the API will return an error.
sms_sender Sender of the message (if the user allows it), 3-11 alphanumeric characters (a-zA-Z).

Curl example

curl "https://www.octopush-dm.com/api/sms/?user_login=*****%40******.com&api_key=***************&sms_text=un+exemple+de+texte&sms_recipients=0033601010101&sms_type=FR&sms_sender=Octopush"

XML Back

<?xml version="1.0" encoding="UTF-8"?>
<octopush>
    <error_code>000</error_code>
    <cost>0.105</cost>
    <balance>6.93</balance>
    <ticket>api110000000021</ticket>
    <sending_date>1415974349</sending_date>
    <number_of_sendings>1</number_of_sendings>
    <currency_code>€</currency_code>
    <successs>
        <success>
            <recipient>+33601010101</recipient>
            <country_code>FR</country_code>
            <cost>0.550</cost>
        </success>
    </successs>
    <failures/>
</octopush>

Defining XML Tags

Refer to page XML Returns