Envoyer des SMS par e-mail

Avec la Mail API, vous envoyez des SMS directement depuis votre logiciel de messagerie ou depuis toute application capable d'envoyer des e-mails. La condition préalable est une configuration Mail API. L'article Configurer la Mail API explique comment la créer.

Adresse

Chaque configuration dispose d'une adresse fixe, que vous trouvez dans le dashboard sous Développeur -> Accès API :

TOKEN@gateway.seven.io
PREFIX.TOKEN@gateway.seven.io

Le token est généré par seven et reste fixe. Vous choisissez librement le préfixe pour chaque e-mail : tout ce qui précède le dernier point de l'adresse constitue le préfixe et est analysé à l'aide du motif du préfixe d'adresse.

Si le motif du préfixe d'adresse est {{to}}, un e-mail envoyé à 4917612345678.a1b2c3d4e5f6g7h8@gateway.seven.io part vers le numéro 4917612345678. Au lieu d'un numéro de téléphone, vous pouvez également indiquer un contact ou un groupe de votre carnet d'adresses.

Si vous avez activé l'option Autoriser en plus l'adresse sans token dans la configuration, le préfixe seul suffit : 4917612345678@gateway.seven.io.

Destinataire, texte et expéditeur

Vous définissez avec les motifs de la configuration où figurent dans l'e-mail le destinataire, le texte du message et l'expéditeur :

• Destinataire : via {{to}} dans le préfixe, dans l'objet ou dans le corps. Si aucun motif ne capture le destinataire, le SMS est envoyé au destinataire fixe défini dans la configuration.
• Texte : avec le réglage par défaut (motif du corps {{text}}), l'ensemble du texte de l'e-mail devient le SMS. Avec du texte littéral dans le motif, vous délimitez le texte, par exemple (({{text}})), afin que les signatures ne soient pas envoyées.
• Expéditeur : via {{from}} dans un motif ou via l'expéditeur du message défini dans la configuration. Si les deux sont vides, l'expéditeur par défaut de votre compte s'applique.

D'autres options comme l'heure d'envoi ({{delay}}), un label ({{label}}) ou un SMS flash ({{flash}}) se contrôlent également via des variables dans les motifs. Les paramètres de contrôle dans l'objet comme from= ou key= ne sont pas analysés pour les configurations avec adresse fixe. Vous trouverez la liste complète des variables dans la documentation Mail API.

Un exemple : un outil de monitoring envoie son alerte dans l'objet à a1b2c3d4e5f6g7h8@gateway.seven.io. Dans la configuration, le motif de l'objet est {{text}}, le motif du corps est vide et votre numéro d'astreinte est saisi comme destinataire fixe. L'objet Charge CPU critique sur srv-07 devient alors un SMS avec exactement ce texte, envoyé au numéro d'astreinte.

Adresse de l'expéditeur

Envoyez toujours depuis l'un des expéditeurs autorisés de la configuration. Les e-mails provenant d'autres adresses ne sont pas traités. Si la vérification DMARC est active pour la configuration, votre e-mail doit en outre la passer. Vous voyez les e-mails refusés avec le code 904 dans le Débogueur.

Format classique (configurations Legacy)

Les configurations créées avant l'introduction de l'adresse fixe sont signalées par Legacy dans le dashboard et continuent de fonctionner sans changement. Vous y contrôlez l'envoi via la ligne de destinataire et l'objet :

• Destinataire : numéro de téléphone devant @gateway.seven.io, par exemple 01761234567890@gateway.seven.io.
• Objet : commandes au format parametre=valeur, séparées par des espaces, par exemple from=Fleuriste key=123456789. Mettez les valeurs contenant des espaces entre guillemets : from="Maison Fleurs". Un to= dans l'objet remplace la ligne de destinataire, ce qui vous permet par exemple d'atteindre aussi des groupes.
• Texte : le texte de l'e-mail. Si vous l'encadrez de doubles dièses (##Voici votre texte##), seule la partie comprise entre les deux est envoyée.

Vous trouverez tous les paramètres du format classique dans la documentation Mail API.