mailerpress icon black white

Documentation

Comment intégrer et gérer le suivi des rebonds avec Amazon SES

Voici les étapes pour envoyer vos campagnes e-mail avec Amazon SES et gérer le suivi des rebonds dans MailerPress à l’aide d’Amazon SNS (Simple Notification Service).

Prérequis

1. Se connecter à la console AWS

Rendez-vous sur la console de gestion AWS et connectez-vous avec les identifiants de votre compte AWS.

Si vous ne disposez pas encore d’un compte AWS, vous devrez d’abord en créer un.

Notez qu’AWS exige un moyen de paiement valide, même si Amazon SES propose une offre gratuite généreuse.

2. Configurer Amazon SES

Vérifier votre domaine ou votre adresse e-mail

Avant de pouvoir envoyer des e-mails via Amazon SES, vous devez vérifier votre identité d’envoi :

  1. Dans la console AWS, recherchez SES et ouvrez le tableau de bord Amazon Simple Email Service
  2. Dans la barre latérale gauche, cliquez sur Identités vérifiées
  3. Cliquez sur Créer une identité
  4. Choisissez Domaine (recommandé) ou Adresse e-mail
  5. Suivez les étapes de vérification fournies par AWS
    Pour la vérification de domaine, vous devrez ajouter des enregistrements DNS à votre domaine. AWS vous fournira les enregistrements spécifiques à ajouter.

Vérifier le statut d’envoi SES

Les nouveaux comptes AWS commencent en mode sandbox, ce qui limite l’envoi aux seules adresses e-mail vérifiées. Pour pouvoir envoyer des e-mails à n’importe quel destinataire :

  1. Allez dans le tableau de bord du compte dans la console SES
  2. Si vous voyez le message « Your account is in the sandbox », cliquez sur Request production access
  3. Remplissez le formulaire de demande en décrivant votre cas d’usage

3. Créer des clés d’accès IAM pour MailerPress

MailerPress a besoin d’identifiants API pour envoyer des e-mails via Amazon SES :

  1. Dans la console AWS, recherchez IAM et ouvrez le tableau de bord Identity and Access Management
  2. Dans la barre latérale gauche, cliquez sur Utilisateurs
  3. Cliquez sur Créer un utilisateur
  4. Saisissez un nom d’utilisateur (par exemple mailerpress-ses)
  5. Cliquez sur Suivant
  6. Sélectionnez Attacher des politiques directement
  7. Recherchez et sélectionnez AmazonSESFullAccess
  8. Cliquez sur Suivant, puis sur Créer l’utilisateur

Générer des clés d’accès

  1. Cliquez sur l’utilisateur que vous venez de créer
  2. Allez dans l’onglet Identifiants de sécurité
  3. Sous Clés d’accès, cliquez sur Créer une clé d’accès
  4. Sélectionnez Application exécutée en dehors d’AWS
  5. Cliquez sur Suivant, puis sur Créer une clé d’accès
  6. Important : copiez et sauvegardez immédiatement l’Access Key ID et la Secret Access Key. La clé secrète ne sera plus affichée par la suite.

4. Lier votre site à Amazon SES

  1. Dans l’administration WordPress, allez dans MailerPressIntégrations
  2. Trouvez Amazon SES dans la liste des fournisseurs d’e-mails et cliquez pour le configurer
  3. Saisissez vos identifiants :
    Access Key ID : collez la clé d’accès copiée précédemment
    Secret Access Key : collez la clé secrète copiée précédemment
    Région : sélectionnez votre région AWS (par exemple us-east-1, eu-west-1)
  4. Cliquez sur Enregistrer pour sauvegarder vos paramètres
  5. Cliquez sur Tester la connexion pour vérifier que tout fonctionne correctement

5. Activer le suivi des rebonds avec Amazon SNS

Contrairement à d’autres fournisseurs d’e-mails, Amazon SES ne dispose pas de webhooks intégrés. Il utilise Amazon SNS (Simple Notification Service) pour envoyer les notifications de rebond. Cela nécessite une configuration supplémentaire dans AWS.

Étape 5.1 : Créer un topic SNS

  1. Dans la console AWS, recherchez SNS et ouvrez le tableau de bord Simple Notification Service
  2. Dans la barre latérale gauche, cliquez sur Topics
  3. Cliquez sur Créer un topic
  4. Sélectionnez Standard comme type (et non FIFO)
  5. Saisissez un nom pour votre topic (par exemple mailerpress-ses-bounces)
  6. Laissez les autres paramètres par défaut
  7. Cliquez sur Créer le topic
  8. Copiez l’ARN du topic, vous en aurez besoin plus tard (il ressemble à arn:aws:sns:us-east-1:123456789012:mailerpress-ses-bounces)

Étape 5.2 : Créer une souscription HTTPS

  1. Sur la page de votre topic, cliquez sur Créer une souscription
  2. Configurez la souscription :
    Protocole : sélectionnez HTTPS
    Endpoint : saisissez l’URL du webhook MailerPress :
    https://example.com/wp-json/mailerpress/v1/esp/bounce/amazonses
    Remplacez example.com par votre véritable nom de domaine.
  3. Important : laissez l’option « Enable raw message delivery » décochée
  4. Cliquez sur Créer la souscription

Étape 5.3 : Confirmer la souscription

Après la création de la souscription, AWS SNS enverra automatiquement une requête de confirmation à votre endpoint MailerPress. MailerPress gérera cela automatiquement.

  1. Attendez quelques secondes, puis actualisez la page des souscriptions
  2. Le statut de la souscription doit passer de Pending confirmation à Confirmed
    Si la souscription reste en attente :
    • Vérifiez que votre site est accessible depuis Internet (et non en localhost)
    • Assurez-vous que votre certificat SSL est valide
    • Consultez les journaux d’erreurs WordPress pour identifier d’éventuels problèmes

Étape 5.4 : Configurer SES pour envoyer les rebonds vers SNS

  1. Retournez dans la console Amazon SES
  2. Cliquez sur Identités vérifiées dans la barre latérale gauche
  3. Sélectionnez votre domaine ou votre adresse e-mail vérifiée
  4. Allez dans l’onglet Notifications
  5. Cliquez sur Modifier dans la section « Feedback notifications »
  6. Configurez les options suivantes :
    Retour de rebond : sélectionnez le topic SNS que vous avez créé (mailerpress-ses-bounces)
    Retour de plainte : sélectionnez le même topic SNS (recommandé)
  7. En option, cochez Inclure les en-têtes d’e-mail d’origine pour faciliter le débogage
  8. Cliquez sur Enregistrer les modifications

Tester le suivi des rebonds

Amazon SES fournit des adresses e-mail spéciales pour tester les rebonds sans affecter votre réputation d’expéditeur :

  1. Dans MailerPress, créez une campagne de test ou utilisez la fonction d’envoi de test
  2. Envoyez un e-mail de test à : [email protected]
  3. Attendez quelques instants que la notification de rebond soit traitée
  4. Vérifiez dans MailerPressAudience que le contact a bien été marqué comme en rebond
    Autres adresses de test disponibles :

Suivre vos rebonds

Une fois la configuration terminée, MailerPress va automatiquement :

  • Recevoir les notifications de rebond d’Amazon SES via SNS
  • Marquer les adresses e-mail en rebond dans votre liste de contacts
  • Empêcher les envois futurs vers les adresses en rebond permanent
  • Enregistrer les détails des rebonds pour consultation

Vous pouvez consulter les statistiques de rebond dans MailerPressTableau de bord et voir les enregistrements individuels de rebond dans les fiches de contact.

Dépannage

La souscription reste en « Pending confirmation »

  • Assurez-vous que votre site est accessible publiquement (pas derrière un pare-feu ni en localhost)
  • Vérifiez que votre certificat SSL est valide et non expiré
  • Confirmez que l’URL du webhook est correcte et sans faute de frappe
  • Consultez les journaux d’erreurs WordPress dans wp-content/debug.log

Les rebonds ne sont pas suivis

  • Vérifiez que la souscription SNS est bien marquée comme « Confirmed »
  • Assurez-vous que SES est configuré pour envoyer les rebonds vers le bon topic SNS
  • Envoyez un test à [email protected]
  • Consultez les journaux MailerPress pour détecter d’éventuels messages d’erreur

Erreurs « Access Denied »

  • Vérifiez que votre utilisateur IAM dispose bien de la politique AmazonSESFullAccess
  • Assurez-vous que votre Access Key ID et votre Secret Access Key sont corrects
  • Vérifiez que vos clés d’accès IAM sont actives et non désactivées ou supprimées

Les e-mails ne sont pas envoyés

  • Confirmez que votre domaine ou adresse e-mail est vérifié dans SES
  • Vérifiez si votre compte est toujours en mode sandbox
  • Vérifiez que vous avez sélectionné la bonne région AWS dans MailerPress

Référence des régions AWS

Choisissez la région la plus proche de votre audience pour de meilleures performances :

Code RégionEmplacement
us-east-1US East (N. Virginia)
us-east-2US East (Ohio)
us-west-1US West (N. California)
us-west-2US West (Oregon)
eu-west-1Europe (Irlande)
eu-west-2Europe (Londres)
eu-west-3Europe (Paris)
eu-central-1Europe (Francfort)
ap-south-1Asie-Pacifique (Mumbai)
ap-southeast-1Asie-Pacifique (Singapour)
ap-southeast-2Asie-Pacifique (Sydney)
ap-northeast-1Asie-Pacifique (Tokyo)

Résumé

Pour utiliser Amazon SES avec le suivi des rebonds dans MailerPress :

  1. Créer et vérifier une identité d’envoi dans Amazon SES
  2. Créer un utilisateur IAM avec les autorisations SES et générer des clés d’accès
  3. Configurer MailerPress avec vos identifiants AWS
  4. Créer un topic SNS pour les notifications de rebond
  5. Souscrire l’URL du webhook MailerPress au topic SNS
  6. Configurer votre identité SES pour envoyer les rebonds vers le topic SNS
  7. Tester avec le simulateur de rebond AWS
    Une fois la configuration terminée, MailerPress suivra automatiquement les rebonds et protégera votre réputation d’expéditeur.