Aller au contenu principal

E-mails transactionnels pour vos applications

Permettez à l'une de vos applications déployées d'envoyer des e-mails transactionnels — confirmations d'inscription, réinitialisations de mot de passe, reçus — via la plateforme, sans compte SMTP ni clé d'API d'un prestataire. Vous rattachez la messagerie à une application à peu près comme une base de données : vous rattachez, et les variables d'environnement apparaissent dans l'application.

Le courrier part du domaine de votre application dès que celui-ci est vérifié ; en attendant, l'expéditeur de la plateforme prend le relais, de sorte que rien n'est bloqué pendant la propagation DNS.

Rattacher la messagerie​

Dans l'environnement de l'application, faites Create Service → Transactional Email, puis :

  1. Choisissez l'application qui enverra les messages.
  2. Préfixe des variables — par exemple MY_APP. Nous injectons les clés que votre application lit :
    • MY_APP_EMAIL_HUB_URL — le point d'envoi (une URL de relais de la plateforme, pas celle d'un prestataire) ;
    • MY_APP_EMAIL_HUB_TOKEN — un jeton limité à cette seule application ;
    • MY_APP_EMAIL_PROVIDER — facultatif : le sélecteur de transport (voir ci-dessous).
  3. Nom d'expéditeur — ce que voient les destinataires à côté de l'adresse (par défaut, le nom de l'application ; modifiable ensuite sans redéployer).

Confirmez : l'application est redéployée pour prendre en compte les nouvelles variables.

Le sélecteur de transport (…_EMAIL_PROVIDER)​

Si votre application choisit son transport de messagerie d'après une variable d'environnement, la fenêtre vous permet de l'indiquer et de choisir la valeur à y placer. Voir E-mails depuis votre application → Le sélecteur de transport.

Gérer un rattachement​

Depuis la carte du service Transactional Email de l'application :

  • Rotate — émet un nouveau jeton, invalide immédiatement l'ancien et redéploie. À utiliser si un jeton a fuité.
  • Changer le nom d'expéditeur — effectif dès l'envoi suivant, sans redéploiement.
  • Unbind — révoque le jeton et retire les variables d'environnement.

Envoyer sous votre propre identité​

Le courrier part sous l'identité du domaine de votre application dès que ce domaine est vérifié (la plateforme publie et utilise alors les enregistrements DNS de signature qui conviennent). En attendant, les envois passent par l'expéditeur de secours de la plateforme, pour que votre application continue de fonctionner. La vérification d'un domaine est décrite dans le guide des domaines.

Votre jeton est un identifiant au porteur, limité à cette seule application : il est masqué dans l'interface derrière un bouton d'affichage, et le renouveler est la façon de révoquer une fuite.