Liste des paramètres

Voici la liste des paramètres disponibles pour utiliser notre API SMS.
ATTENTION : lorsque ceux-ci ne sont pas obligatoires, c’est qu’ils ont une valeur par défaut.

CodeTypeDéfinition
user_loginObligatoireLogin utilisateur (adresse e-mail).
api_keyObligatoireClé api disponible sur votre manager.
sms_recipientsObligatoireListe des numéros au format international +XXZZZZZ, séparés par des virgules.
sms_textObligatoireTexte du message (maximum 459 caractères).
sms_typeObligatoireType 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_senderObligatoireExpéditeur du message (si l’opérateur le permet), 3 à 11 caractères alpha- numériques (a-zA-Z).
sms_modeOptionnelMode d’envoi : défaut : 1 1 = Envoi Instantané, 2 = Envoi Différé (il faut alors spécifier la date)
sending_dateConditionnel[Si mode = 2, deprecated] Timestamp, indiqué en GMT+1
sending_timeOptionnelTimestamp, indiqué en GMT+1
sending_periodOptionnelDelai souhaité (en secondes) avant envoi. Ce champ vous permet de définir le temps qui vous sépare de la date souhaitée et d’éviter les confusions de timezone
recipients_first_namesOptionnelRemplacent la chaîne {prenom} de votre message.
recipients_last_namesOptionnelRemplacent la chaîne {nom} de votre message, séparés par des virgules.
sms_fields_1OptionnelRemplacent la chaîne {ch1} de votre message, séparés par des virgules.
sms_fields_2OptionnelRemplacent la chaîne {ch2} de votre message, séparés par des virgules.
sms_fields_3OptionnelRemplacent la chaîne {ch3} de votre message, séparés par des virgules.
request_modeOptionnelPermet de choisir le mode simulation avec la valeur ‘simu’. * défaut : real
request_idOptionnelPermet d’ajouter une sécurité à l’envoi. Si ce champ est différent de null, alors le système viendra vérifier s’il n’y pas déjà un de vos envois ayant le même request_id. Si c’est le cas, la requête est ignorée.
with_repliesOptionnelInstancier à 1 pour indiquer que vous souhaitez les réponses aux SMS envoyés
transactionalOptionnelInstancier à 1 pour les envois de type confirmation, ou alerte (7j/7, h24) INTERDICTION FORMELLE d’envoyer du SMS marketing avec cette option (tout abus est passible d’une suspension immédiate du compte, ainsi que d’une amende de 1000€ par infraction constatée)
msisdn_senderOptionneldéfaut : 0. Certains opérateurs internationaux autorisent les numéros de téléphone comme émetteur. Dans ce cas, ce champ doit être à 1.
request_keysOptionnelContient la liste des clés des champs de la requête que vous souhaitez ajouter dans le hash sha1. Exemple : ‘TRYS’ (pour les champs sms_text, sms_recipients, sms_type, sms_sender). Voir le tableau des clés en annexe.
request_sha1OptionnelCette valeur contient le sha1 de la concaténation des valeurs des champs choisis dans la variable request_keys, et concaténés dans le même ordre que les clés.

Nomenclature des codes SHA1

ClésChamps correspondants
Tsms_text
Rsms_recipients
Msms_mode
Ysms_type
Ssms_sender
Dsending_date
arecipients_first_names
brecipients_last_names
csms_fields_1
dsms_fields_2
esms_fields_3
Wwith_replies
Ntransactional
Qrequest_id