Email to SMS
L'interface Email to SMS envoie un SMS à partir d'un e-mail ordinaire, sans écrire une seule ligne de code. Le numéro du destinataire constitue l'adresse, l'objet contient les identifiants et les paramètres, et le corps de l'e-mail est le texte du message.
L'interface doit d'abord être activée dans le portail. Les étapes et les identifiants sont décrits dans l'administration des API.
Adresse du destinataire
L'adresse à laquelle l'e-mail est envoyé :
Le numéro du destinataire doit être écrit au format international, sans zéro initial ni signe + — par exemple 420777777777.
Format de l'objet
L'objet contient trois paramètres obligatoires et deux facultatifs, séparés par un point-virgule :
Les paramètres facultatifs s'omettent en partant de la droite — sans eux, l'objet est wallet_id;email2sms_password;smstype. Le texte du message se place dans le corps de l'e-mail.
Tableau des paramètres
| NOM DU PARAMÈTRE | VALEUR | OBLIGATOIRE | VALEUR PAR DÉFAUT |
|---|---|---|---|
| wallet_id | ID du portefeuille dans le portail (Modules et API > Email > SMS) |
Oui | - |
| email2sms_password | Mot de passe dans le portail (Modules et API > Email > SMS) |
Oui | - |
| smstype | 1 — texte raccourci à 160 caractères, 10 — EMS avec un texte jusqu'à 612 caractères |
Oui | - |
| isms | Passerelle SMS, valeur 0 – 4. Obligatoire pour utiliser un expéditeur texte. |
Non | 0 |
| sender | Expéditeur du message — un numéro au format international (420777777777) ou un texte de 11 caractères maximum (eshop.com) |
Non | Numéro système |
Vous trouverez la valeur isms dans les tarifs du portail — elle s'affiche lorsque vous survolez l'icône de clé à molette destinée aux développeurs.
Les SMS Unicode ne sont pas pris en charge par cette interface.
Exemples
Exemple 1 — passerelle par défaut
Un SMS de 160 caractères maximum au numéro +420777777777 avec le texte « Bonjour, comment allez-vous ? », envoyé par la passerelle par défaut (numéro système).
Adresse du destinataire : 420777777777@email2sms.bulkgate.com
Objet : bg180012091617000;MotDePasseFictif;1
Corps de l'e-mail : Bonjour, comment allez-vous ?
Exemple 2 — expéditeur texte
Le même SMS envoyé par la passerelle 2 avec l'expéditeur texte eshop.com.
Adresse du destinataire : 420777777777@email2sms.bulkgate.com
Objet : bg180012091249500;MotDePasse12345;1;2;eshop.com
Corps de l'e-mail : Bonjour, comment allez-vous ?
Réponse
Les e-mails sont traités toutes les minutes. En cas d'erreur, le serveur vous renvoie un e-mail contenant le numéro de l'erreur.
Merci pour votre retour.