Envoyez des e-mails par SMTP

Le relais SMTP de Banger permet aux applications qui n’envoient que par SMTP, comme Supabase Auth, Auth0, WordPress ou le module de messagerie de votre framework, d’envoyer via Banger. Votre application s’authentifie avec une clé API Banger, et chaque message part de votre domaine et apparaît dans Journaux.

Avant de commencer

Deux éléments sont nécessaires :

1. Une voie Produit. L’adresse From doit appartenir à un domaine ou sous-domaine avec une voie Produit prête. Ouvrez Domaines › Ajouter une voie, choisissez Produit et ajoutez les enregistrements DNS affichés. Voir Ajoutez votre domaine. Une voie de messagerie (boîtes de l’équipe) ou de Campagne ne peut pas envoyer les e-mails d’application : ceux-ci n’affectent donc jamais la réputation des boîtes de votre équipe.
2. Une clé API autorisée à envoyer. Ouvrez Clés API › Créer une clé API, donnez le nom de l’application (par exemple « Supabase Auth »), sélectionnez uniquement mail:send, puis Créer une clé. Copiez-la immédiatement : elle n’est montrée qu’une fois.

Vous pouvez aussi ouvrir Clés API depuis Paramètres › Développeurs › Gérer les clés API.

Paramètres SMTP

Le bloc SMTP de la page Clés API présente ces paramètres, avec un bouton de copie de l’hôte.

Si l’application demande « SSL » ou « TLS », utilisez 465. Si elle demande « STARTTLS », utilisez 587.

Connectez Supabase Auth

1. Dans Supabase, ouvrez Authentication › E-mails › Paramètres SMTP et activez le SMTP personnalisé.
2. E-mail de l’expéditeur: une adresse sur votre voie Produit, comme noreply@app.example.com.
3. Nom de l’expéditeur: le nom du produit. Banger le conserve tel qu’écrit.
4. Hôte submit.bangermail.com, Port 465, Nom d’utilisateur banger, Mot de passe votre clé API.
5. Enregistrez, puis envoyez-vous un lien de connexion depuis Authentication › Utilisateurs.

Les autres applications fonctionnent de la même façon : collez ces paramètres dans leurs réglages SMTP ou de messagerie. Les exemples de code sont dans la documentation SMTP développeur.

Vérifiez le résultat

Ouvrez Journaux. Chaque message envoyé par l’application indique SMTP comme source et son état de livraison. Banger journalise aussi chaque refus, avec la correction nécessaire.

Votre application reçoit 250 2.0.0 Queued as … lorsque Banger accepte un message.

Traitement de chaque message

• Envoi tel que l’application l’a rédigé, avec votre nom From et la signature DKIM de votre domaine.
• Suppression de Bcc et Return-Path ; ajout d’un Reply-To correspondant à From s’il n’existe pas.
• Exclusion des destinataires supprimés des envois, envoi aux autres.
• Traitement d’une nouvelle tentative du même message comme le même envoi : un délai dépassé ne produit jamais un doublon.
• Décompte de chaque message dans votre forfait, comme tout envoi.

Chaque message peut atteindre 10 MiB et 50 destinataires.

Lorsqu’un message est refusé

Chaque refus donne la cause et une référence, (ref …), correspondant à l’entrée dans Journaux. Les codes commençant par 4 sont temporaires ; votre application peut réessayer.

Protégez la clé

• Donnez à chaque application sa propre clé avec seulement mail:send. Une fuite du mot de passe SMTP ne permet ainsi pas de lire votre espace de travail.
• Pour la renouveler, créez une nouvelle clé, actualisez l’application, puis Révoquer l’ancienne. Les applications qui l’utilisent encore seront refusées à leur prochaine connexion.
• Banger ne stocke qu’une empreinte de chaque clé et journalise les connexions refusées dans Journaux.

Essayez avec votre IA

Crée une clé API autorisée uniquement à envoyer des e-mails, vérifie ma voie Produit et donne-moi les paramètres SMTP pour Supabase.