API pour l'envoi et la réception de SMS

Qu'est-ce que l'API websms ?

L'API vous permet d'envoyer des SMS à partir de votre propre application, en utilisant votre compte websms.lu
Vous pouvez également recevoir des SMS entrants sur l'url de votre choix.

Spécifications techniques

Si vous avez réservé un numéro de réception dans votre compte, vous pouvez nous fournir une URL qui sera appelée à chaque message entrant sur ce numéro (MO - Mobile Originated). Ces messages seront égalemet affichés dans votre interface websms.lu

Les appels vers votre URL sont faits en POST, les différents paramètres sont encodés en UTF-8 et urlencodés.

Pour des raisons de sécurité, nous vous recommandons d'utiliser le protocole HTTPS.

Votre URL doit renvoyer un code http 200 en moins de 30 secondes pour valider la bonne réception du SMS, inutile d'afficher du contenu.

Si votre URL n'est pas accessible (le code http renvoyé n'est pas 200), notre plateforme tentera de délivrer le message pendant 24 heures avant d'abandonner.

Paramètres du SMS

Les informations suivantes seront envoyées à votre URL:

Paramètre	Description
msisdn	Le numéro long que vous avez réservé dans l'interface au format international (+352__________)
from	L'expéditeur du SMS vers votre numéro long au format international (+352__________)
text	Le contenu du SMS
keyword	Le mot clé détecté au début du SMS (vide si vous avez réservé l'ensemble du numéro long)
dateSent	La date d'envoi du SMS par l'utilisateur (format %Y-%m-%d %H:%M:%S)
dateReceived	La date à laquelle le SMS a été reçue par notre plateforme (format %Y-%m-%d %H:%M:%S) (compter un délai de 15 secondes)