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

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.

Code

Type

Définition

user_login

Obligatoire

Login utilisateur (adresse e-mail).

api_key

Obligatoire

Clé api disponible sur votre manager.

sms_recipients

Obligatoire

Liste des numéros au format international +XXZZZZZ, séparés par des virgules.

sms_text

Obligatoire

Texte du message (maximum 459 caractères).

sms_type

Obligatoire

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

Obligatoire

Expéditeur du message (si l’opérateur le permet), 3 à 11 caractères alpha- numériques (a-zA-Z).

sms_mode

Optionnel

Mode d’envoi : défaut : 1 1 = Envoi Instantané, 2 = Envoi Différé (il faut alors spécifier la date)

sending_date

Conditionnel

[Si mode = 2, deprecated] Timestamp, indiqué en GMT+1

sending_time

Optionnel

Timestamp, indiqué en GMT+1

sending_period

Optionnel

Delai 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_names

Optionnel

Remplacent la chaîne {prenom} de votre message.

recipients_last_names

Optionnel

Remplacent la chaîne {nom} de votre message, séparés par des virgules.

sms_fields_1

Optionnel

Remplacent la chaîne {ch1} de votre message, séparés par des virgules.

sms_fields_2

Optionnel

Remplacent la chaîne {ch2} de votre message, séparés par des virgules.

sms_fields_3

Optionnel

Remplacent la chaîne {ch3} de votre message, séparés par des virgules.

request_mode

Optionnel

Permet de choisir le mode simulation avec la valeur ‘simu’. * défaut : real

request_id

Optionnel

Permet 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_replies

Optionnel

Instancier à 1 pour indiquer que vous souhaitez les réponses aux SMS envoyés

transactional

Optionnel

Instancier à 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_sender

Optionnel

dé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_keys

Optionnel

Contient 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_sha1

Optionnel

Cette 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és

Champs correspondants

T

sms_text

R

sms_recipients

M

sms_mode

Y

sms_type

S

sms_sender

D

sending_date

a

recipients_first_names

b

recipients_last_names

c

sms_fields_1

d

sms_fields_2

e

sms_fields_3

W

with_replies

N

transactional

Q

request_id