Envoi de sms personnalise (Publipostage)

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

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).
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



000
0.55
6.93
api110000000021
1455975613
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