Configurer la Mail API

Comment configurer l'envoi de SMS et de messages RCS via la Mail API ?

La Mail API vous permet d'envoyer des SMS ou des messages RCS depuis votre compte e-mail via notre passerelle. Pour plus de détails sur l'utilisation, consultez les articles Envoyer des SMS par e-mail et Envoyer des RCS par e-mail.

Créer une adresse Mail API

Ouvrez Developer -> API Access. La page liste côte à côte toutes vos clés REST API, adresses Mail API et connexions SMPP. Cliquez sur Create New en haut à droite et choisissez Mail API.

Page Developer -> API Access avec un bouton Create New

Dans la boîte de dialogue Create Mail API Address, configurez :

  • Email Sender : l'adresse e-mail depuis laquelle vous enverrez. Vous pouvez aussi utiliser un wildcard pour tout un domaine, p. ex. *@seven.io.
  • Key : un mot de passe utilisé comme paramètre key= sur chaque SMS envoyé par e-mail. Lettres, chiffres et - _ $ uniquement. Cliquez sur Regenerate pour en générer un nouveau.
  • Error Mail (optional) : adresse qui doit recevoir les erreurs de livraison. Par défaut, l'adresse expéditrice est utilisée.

Cliquez sur Save pour ajouter l'adresse.

Boîte de dialogue Create Mail API Address avec les champs Email Sender, Key et Error Mail

Paramètres supplémentaires de la Mail API

Ouvrez Developer -> Settings et dépliez la section Mail API pour affiner le comportement de toutes vos adresses Mail API.

Panneau des paramètres Mail API avec les options Maximum Character Count, Remove Signature, Notification on Error, HTTP Push on Error et Insert Sender in SMS

Maximum Character Count

Limitez la longueur du corps du message pour éviter que des signatures ou pieds de page ne fassent exploser votre volume de SMS. 0 désactive la limite. Pour un contrôle plus strict, encadrez votre message avec des doubles dièses (##Ceci est votre texte##) - tout ce qui est en dehors est supprimé avant l'envoi.

Remove Signature

Filtre les blocs de citation (> comme ceci) avant l'envoi.

Notification on Error

Active des notifications par e-mail et/ou par push HTTP lorsqu'une tentative d'email-to-SMS échoue.

Insert Sender in SMS

Préfixe optionnellement une partie de l'expéditeur de l'e-mail au texte SMS :

  • Full Address : par exemple username@domain.com
  • Local Part (before @) : par exemple username
  • Don't attach : rien n'est ajouté

ID d'expéditeur par défaut et RCS

Si vous voulez un nom d'expéditeur fixe sur tous vos SMS, définissez un ID d'expéditeur par défaut (jusqu'à 11 caractères alphanumériques). Les réponses ne sont possibles que si l'ID d'expéditeur est un numéro de téléphone. Les messages RCS utilisent toujours le nom d'expéditeur enregistré avec l'agent.

Documentation

Référence complète et exemples dans la documentation Mail API.

Cela a-t-il répondu à votre question ?

Articles associés