Base de connaissances

Passerelle SMS - Email to SMS : envoi de SMS depuis une adresse email

Principe de fonctionnement

Si vous possédez un compte SMS chez Boxis.net, vous pouvez émettre des SMS depuis n'importe quelle messagerie électronique.

Envoyer un SMS depuis une boite email

Pour envoyer un SMS, c'est simple et rapide :

- Adresse destinataire : email2sms@boxis.net

- Sujet : Il contiendra les identifiants de votre compte, ainsi que les paramètres du SMS, le numéro expéditeur et le(s) numéro(s) de téléphone destinataire(s).

- Texte : Le corps de texte contiendra le message à envoyer par SMS. Il y a une de limite du nombre de caractères à un maximum de 980 caractères. Un (1) SMS est limité à 160 caractères, si votre texte dépasse cette limite, le message sera découpé en autant de SMS que nécessaires. Le système contrôle que votre compte soit suffisamment crédité en fonction. (160 caractères pour les SMS en Unicode)

NB : Si votre texte contient 2 sauts de ligne (double \n) ou si vous écrivez le paramètre "--end" , tout ce qui se trouve ensuite ne sera pas pris en compte.

Pour envoyer un SMS par cette méthode il vous faudra votre clés API.

- Espace client -> API -> Clé API

Edition du sujet/objet de l'email

Le sujet doit contenir au moins les champs suivants :

username;apikey;from;to

Les paramètres doivent être séparé par des ":" et sont les suivants :

• username = L'adresse e-mail de votre compte (par exemple: "mail1@example.com")
• apikey = Votre clé API
• from = Votre nom ou numéro d'éxpéditeur à utiliser, permi les noms et numéros déclarés sur votre compte
• to = Numéro de téléphone du destinataire du message, en cas de destinataires multiples il est possible de rajouter des numéros supplémentaires, séparés par une virgule "," (les numétos étant toujours au format internationnal)

Viennent ensuite des paramètres facultatifs, tels que :

• deferred = Pour définir la date d'envoi différée (par default les messages sont envoyés tout de suite), au format hhmmjjMMAAAA (pour un envoi le 25/08/2012 à 12h30 : 123025082012)
• flash = 1 pour envoyer le message en SMS Flash : Le message est directement affiché à l'utilisateur sur l'écran du mobile à la réception. Le message n'est enregistré ni dans la mémoire du téléphone ni dans la carte SIM. Il est effacé dès que l'utilisateur a validé la visualisation.
• fast = 1 pour envoyer le SMS avec la plus haute priorité qui assure la livraison la plus rapide possible. Ce paramètre peut être utilisé pour les deux messages PRO et ECO. Messages rapides coûte deux fois plus de message qu'un envoi normal. Attention! L'envoi en masse et des messages de marketing ne doit pas être envoyé avec le paramètre d'envoi rapide.

Réponse

Pour 3 formats précédents les réponses sont de la forme suivante :

Pour xml :

en cas de succès :

en cas d'erreur :

Pour json :

en cas de succès :

en cas d'erreur :

Pour html :

en cas de succès :

en cas d'erreur :

Restriction

Pour gérer les ip autorisées, il vous suffit de vous connecter à votre espace client et d'aller dans la menu SMS.

Cliquez sur Restrictions par IP.

Vous aurez la possibilité d'entrer des IP ou des ranges d'IP.

Ces champs correspondent aux ip qui seront autorisées à utiliser le service.

Si les champs sont vide, la restriction sera alors inactive.