• fr
    • en
Contact : +33(0)4.13.41.50.70
  • fr
    • en

Publipostage SMS

Définition

Cette option vous permet de personnaliser vos SMS pour chacun de vos destinataires.
Vous pouvez faire cette personnalisation de votre côté, mais cela vous oblige à nous transmettre autant de requêtes qu’il y a de numéros de téléphones, ce qui peut prendre plusieurs minutes selon la taille de vos listes.
Grâce à l’option de publipostage de Octopush, votre envoi ne durera que quelques secondes pour l’ensemble de vos contacts.

 

URL

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

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

 

Encodage

UTF-8

 

Paramètres particuliers

Nom Définition
user_login Login utilisateur (adresse e-mail).
api_key Clé api disponible sur votre manager.
sms_recipients Liste des numéros au format international +XXZZZZZ, séparés par des virgules.
sms_text Texte du message (maximum 459 caractères).
sms_type Type 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_sender Expéditeur du message (si l’opérateur le permet), 3 à 11 caractères alpha- numériques (a-zA-Z).
recipients_first_names* Remplacent la chaîne {prenom} de votre message.
recipients_last_names* Remplacent la chaîne {nom} de votre message, séparés par des virgules.
sms_fields_1* Remplacent la chaîne {ch1} de votre message, séparés par des virgules.
sms_fields_2* Remplacent la chaîne {ch2} de votre message, séparés par des virgules.
sms_fields_3* Remplacent la chaîne {ch3} de votre message, séparés par des virgules.

* Ces paramètres sont optionnels. Ils peuvent également ne contenir qu’une seule donnée.

 

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,0033601010102,0033601010103&recipients_last_names=durand,tchang,smith&sms_fields_1=M,Mme,Mr&sms_type=WWW&sms_sender=Octopush&sms_mode=2« 

Retour XML

<?xml version= »1.0″ encoding= »UTF-8″?>
<octopush>
<error_code>000</error_code>
<cost>0.55</cost>
<balance>6.93</balance>
<ticket>api110000000021</ticket>
<sending_date>1455975613</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.055</cost>
< /success>
< /successs>
< /failures>
</octopush>

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