Envoi de SMS simple

Définition

Il s’agit de l’envoi simple de SMS. Vous pouvez spécifier plusieurs numéro de téléphone dans le paramètre « sms_recipients » en les séparant par une « , ».
Une bonne utilisation consiste à transmettre des trames de 200 à 500 numéros à la fois lors de vos campagnes :

  • < 200 : vous multipliez les appels et gaspillez le temps de connexion
  • > 500 : la trame devient lourde et les risques de pertes de données augmentent.

URL

XML : https://www.octopush-dm.com/api/sms

JSON : https://www.octopush-dm.com/api/sms/json

Encodage

UTF-8

Paramètres particuliers

NomDéfinition
user_loginLogin utilisateur (adresse e-mail).
api_keyClé api disponible sur votre manager.
sms_recipientsListe des numéros au format international +XXZZZZZ, séparés par des virgules.
sms_textTexte du message (maximum 459 caractères).
sms_typeType de SMS : XXX = SMS LowCost ; FR = SMS Premium; WWW = SMS Monde. En France, si la mention « STOP au XXXXX » est absente de votre texte, l’API renverra une erreur.
sms_senderExpéditeur du message (si l’opérateur le permet), 3 à 11 caractères alpha- numériques (a-zA-Z).

Exemple Curl

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« 

Retour XML



000
0.55
6.93
api110000000021
1501503703
1

< successs>
< success>
+33601010101
FR
0.055
< /success>
< /successs>
< /failures>

Retour JSON

{« error_code« :« 000 », »cost« :0.055, »balance« :6.93, »ticket« :« api110000000021 », »sending_date« :1501503703, »number_of_sendings« :1, »currency_code« :« \u20ac », »failures« :[], »successs« :{« recipient« :33601010101, »country_code« : »FR », »cost« :0.550, »sms_needed« :1}}

Définition des Tags XML

Se référer à la page concernant les retours XML

* Pour certains utilisateurs ovh, l’utilisation de curl_setopt($ch, CURLOPT_FRESH_CONNECT, true); dans leur séquence d’envoi en CUrl pourrait être utile.