Configuration de l'intégration

Amazon SES - création de compte et configuration pour l’intégration d’envoi

Objectif du document

Ce document décrit comment préparer un compte AWS et le service Amazon SES afin de pouvoir réaliser l’intégration d’envoi avec les modules de ce projet.

Le guide couvre :

la création d’un compte AWS,
l’activation d’Amazon SES,
la vérification du domaine et de l’expéditeur,
la sortie du sandbox,
la préparation des identifiants,
deux variantes d’intégration avec Magento :
- via Amazon SES API,
- via Amazon SES SMTP.

Remarque importante pour ce projet

Le code du projet met à disposition deux chemins d’intégration avec Amazon SES :

SES API dans Kowal_EmailTransport avec le type de transport ses.
SES SMTP dans Kowal_EmailSmtp avec le type de transport smtp.

Cela signifie qu’il est utile de préparer le compte AWS et SES une seule fois, mais que la méthode finale de connexion à Magento dépend de la variante de déploiement choisie.

Hypothèses initiales

Avant de commencer, préparez :

le domaine depuis lequel les messages seront envoyés, par ex. example.com,
l’accès DNS de ce domaine,
l’adresse d’expéditeur, par ex. newsletter@example.com,
une carte bancaire ou un mode de facturation actif dans AWS,
la décision du choix de la région dans laquelle SES fonctionnera, par ex. eu-central-1 ou us-east-1.

1. Création d’un compte AWS

Accédez au panneau AWS : https://aws.amazon.com/
Créez un compte AWS.
Activez le MFA pour le compte root.
N’utilisez pas les clés d’accès du compte root pour l’intégration applicative.

Pour l’intégration Magento, préparez un utilisateur IAM distinct ou des identifiants SMTP distincts, selon la variante choisie.

2. Activation d’Amazon SES

Connectez-vous à AWS Console.
Ouvrez le service Amazon Simple Email Service.
Sélectionnez la région dans laquelle vous souhaitez envoyer vos messages.

C’est important, car dans SES la région a une importance opérationnelle :

les identités d’expéditeur sont maintenues par région,
le statut sandbox/production access s’applique à la région,
les données de configuration Magento doivent pointer vers cette même région,
les identifiants SMTP dans SES sont uniques par région.

Si la boutique opère à l’international, il est préférable de définir dès le départ la région cible pour un marché donné ou pour toute l’organisation et de s’y tenir de manière cohérente.

3. Vérification du domaine ou de l’adresse d’expéditeur

La meilleure pratique pour une boutique consiste à vérifier l’ensemble du domaine, et non seulement une adresse email individuelle.

Variante recommandée

Vérifiez le domaine, par ex. example.com.

Grâce à cela :

vous pouvez envoyer depuis plusieurs adresses de ce domaine,
il est plus facile de passer à l’envoi en production,
vous vous préparez mieux aux campagnes, aux messages transactionnels et à plusieurs expéditeurs,
il est plus simple de gérer plusieurs boutiques, langues et marques dans un même écosystème.

Étapes

Dans SES, allez dans Identities.
Sélectionnez Create identity.
Choisissez le type Domain.
Saisissez le domaine d’envoi.
Activez Easy DKIM, sauf si vous avez une raison d’utiliser vos propres clés DKIM.
Ajoutez les enregistrements DNS indiqués par AWS à votre zone DNS.
Attendez le statut Verified.

Portée DNS minimale

En pratique, vous aurez besoin au minimum de :

des enregistrements de vérification SES,
des enregistrements DKIM,
éventuellement d’un enregistrement pour le custom MAIL FROM.

4. Sortie du sandbox SES

Un nouveau compte SES fonctionne généralement au départ dans le sandbox.

Cela signifie notamment que :

vous ne pouvez envoyer que depuis des identités vérifiées,
les destinataires doivent également être vérifiés,
vous ne pourrez pas effectuer un envoi de production normal vers les clients de la boutique.

Étapes

Dans SES, ouvrez Account dashboard ou l’écran initial de configuration.
Sélectionnez l’option Request production access.
Remplissez le formulaire selon l’usage prévu du système :
- transactional,
- marketing,
- newsletter,
- e-commerce communications.
Indiquez que l’envoi sera réalisé depuis votre propre Magento pour une boutique en ligne.
Envoyez la demande.

Avant d’envoyer la demande, il est préférable d’avoir déjà un domaine vérifié. Cela accélère généralement l’acceptation.

5. Configuration de la délivrabilité

Ce n’est pas le minimum obligatoire pour un premier test, mais c’est fortement recommandé avant la production.

DKIM

Si vous utilisez Easy DKIM, SES signe automatiquement les messages après une configuration DNS correcte.

Custom MAIL FROM

Si vous souhaitez mieux contrôler l’expéditeur technique et la délivrabilité :

Ouvrez le domaine vérifié dans SES.
Configurez Custom MAIL FROM domain, par ex. mail.example.com.
Ajoutez au DNS :
- un enregistrement MX,
- un enregistrement SPF/TXT pour MAIL FROM.

Cela est particulièrement pertinent pour les boutiques qui pratiquent régulièrement l’email marketing et souhaitent limiter les problèmes de réputation d’expéditeur.

6. Variante A - intégration via Amazon SES API

Cette variante utilise le type de transport ses disponible dans Kowal_EmailTransport.

Quand choisir cette variante

Choisissez SES API si :

vous souhaitez utiliser directement Amazon SES comme provider,
vous souhaitez maintenir un compte de transport de type ses,
vous souhaitez router les messages via Kowal_EmailTransport.

6.1. Création d’un utilisateur IAM pour l’envoi

N’utilisez pas le compte root.

Préparez un utilisateur IAM distinct, par ex. :

magento-ses-sender

Attribuez-lui ensuite une politique avec les autorisations minimales d’envoi.

Exemple de politique minimale

{ 'Version': '2012-10-17', 'Statement': [ { 'Effect': 'Allow', 'Action': [ 'ses:SendEmail', 'ses:SendRawEmail' ], 'Resource': '*' } ]}

Si vous le souhaitez, vous pouvez l’étendre à la lecture des limites ou des statistiques, mais pour le simple envoi, le périmètre ci-dessus constitue un point de départ.

6.2. Création de l’Access Key et de la Secret Key

Ouvrez IAM.
Accédez à Users.
Ouvrez l’utilisateur préparé.
Accédez à l’onglet Security credentials.
Dans la section Access keys, sélectionnez Create access key.
Enregistrez :
- Access Key ID
- Secret Access Key

Le secret ne s’affiche qu’une seule fois. Si vous le perdez, vous devrez créer une nouvelle clé.

6.3. Données nécessaires pour Magento dans la variante API

Pour le compte de transport ses dans Magento, préparez :

provider_region, par ex. eu-central-1,
provider_api_key,
provider_api_secret,
sender_name,
sender_email,
reply_to_email facultatif,
store_id, si le compte ne doit fonctionner que pour une store view spécifique.

6.4. Correspondance avec le panneau Magento

Dans Kowal / Email Marketing :

Ajoutez un nouveau compte de transport.
Définissez :
- Transport Type = Amazon SES,
- Region = région SES,
- Access Key = clé IAM,
- Secret Key = secret IAM.
Enregistrez le compte.
Associez le compte au routage des messages.
Effectuez un test d’envoi depuis le compte de transport.

7. Variante B - intégration via Amazon SES SMTP

Cette variante utilise Kowal_EmailSmtp.

Quand choisir cette variante

Choisissez SES SMTP si :

vous souhaitez déployer Amazon SES comme source SMTP,
vous utilisez le pack Advance Email Delivery,
vous souhaitez conserver un modèle d’intégration plus simple côté Magento.

7.1. Création des identifiants SMTP dans SES

Ouvrez Amazon SES.
Accédez à SMTP settings.
Sélectionnez Create SMTP credentials.
AWS vous guidera dans la création d’un utilisateur IAM pour SMTP.
Enregistrez :
- SMTP username
- SMTP password

Il ne s’agit pas de clés AWS classiques. Ce sont des identifiants SMTP distincts pour SES.

7.2. Endpoint SMTP

Pour SES, utilisez un hôte au format :

email-smtp..amazonaws.com

Exemple :

email-smtp.eu-central-1.amazonaws.com

7.3. Port et chiffrement

Paramètres les plus couramment utilisés :

port 587 + STARTTLS,
ou port 465 + TLS Wrapper / SSL.

En pratique, pour Magento, le point de départ le plus sûr est :

hôte : email-smtp..amazonaws.com
port : 587
sécurité : STARTTLS

7.4. Données nécessaires pour Magento dans la variante SMTP

Préparez :

l’hôte SMTP,
le port,
le type de chiffrement,
l’identifiant SMTP,
le mot de passe SMTP,
l’adresse d’expéditeur conforme à la verified identity dans SES.

7.5. Correspondance avec le panneau Magento

Dans Kowal / Email Marketing :

Dans la section smtp, définissez globalement :
- enabled = Yes,
- host = endpoint SES,
- port = 587,
- username = SMTP username,
- password = SMTP password,
- connection_security = STARTTLS,
- test_recipient_email = adresse de test.
Enregistrez la configuration.
Exécutez Send Test Email.

Si vous utilisez plusieurs comptes ou plusieurs store views, vous pouvez également configurer un compte de transport distinct de type smtp avec des données de connexion dédiées.

8. Que choisir dans ce projet

Choisissez SES API si :

vous souhaitez utiliser des comptes de transport ses,
vous souhaitez router l’envoi par compte et provider,
vous souhaitez faire évoluer le transport sans tout appuyer sur la couche SMTP.

Choisissez SES SMTP si :

vous souhaitez un premier déploiement plus rapide,
vous voulez traiter SES comme un serveur SMTP externe,
vous déployez principalement le pack delivery basé sur Kowal_EmailSmtp.

9. Check-list minimale avant le test d’envoi

Avant le premier test, confirmez :

Le compte AWS existe et la facturation est active.
La région SES a été choisie.
Le domaine ou l’adresse d’expéditeur ont le statut Verified.
Le compte SES dispose du production access ou vous testez uniquement dans les conditions du sandbox.
DKIM est configuré.
Magento dispose de données expéditeur correctes.
La variante d’intégration a été choisie :
- API,
- ou SMTP.
Les identifiants sont stockés en sécurité.
Un test a été envoyé et la distribution du message a été confirmée.

10. Erreurs les plus fréquentes

Le compte est toujours dans le sandbox

Symptôme :

le message n’est pas envoyé à des destinataires normaux.

Cause :

absence de production access.

Le domaine n’est pas vérifié

Symptôme :

erreur d’expéditeur ou rejet de l’envoi.

Cause :

absence de verified identity pour le domaine ou l’adresse d’expéditeur.

Mauvaise région

Symptôme :

les données semblent correctes, mais l’envoi ne fonctionne toujours pas.

Cause :

l’identité est vérifiée dans une autre région que celle utilisée par l’intégration.

Confusion entre clés API et identifiants SMTP

Symptôme :

l’authentification SMTP ne fonctionne pas.

Cause :

des clés IAM ont été saisies dans SMTP au lieu de SMTP username et SMTP password.

Utilisation du compte root

Symptôme :

absence de séparation de sécurité et rotation des identifiants plus difficile.

Cause :

intégration basée sur des données root au lieu d’un utilisateur IAM distinct ou d’identifiants SMTP distincts.

11. Liens vers la documentation officielle AWS

Set up your SES account: https://docs.aws.amazon.com/ses/latest/dg/setting-up.html
Creating and verifying identities: https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html
Verified identities: https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html
Request production access: https://docs.aws.amazon.com/ses/latest/dg/request-production-access.html
SMTP credentials: https://docs.aws.amazon.com/ses/latest/dg/smtp-credentials.html
SMTP endpoint connection: https://docs.aws.amazon.com/ses/latest/dg/smtp-connect.html
Custom MAIL FROM: https://docs.aws.amazon.com/ses/latest/dg/mail-from.html
SES regions: https://docs.aws.amazon.com/ses/latest/dg/regions.html
SES credentials overview: https://docs.aws.amazon.com/ses/latest/dg/send-email-concepts-credentials.html
IAM access keys: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html

12. Données à transmettre pour le déploiement

À la fin, la personne qui crée SES doit transmettre pour le déploiement exactement cet ensemble :

Pour la variante SES API

région SES,
verified domain,
access key,
secret key,
adresse d’expéditeur,
reply-to, s’il doit être différent,
information indiquant si le compte doit fonctionner globalement ou par store view.

Pour la variante SES SMTP

région SES,
hôte SMTP,
port,
security mode,
SMTP username,
SMTP password,
adresse d’expéditeur,
adresse de test pour la vérification.

Notice d'installation du module

Objectif du document

Ce document décrit l’installation et la configuration du pack magento-2-package-advanced-newsletter-suite. Il s’agit d’un pack complet de newsletter et d’email marketing pour Magento 2, couvrant les destinataires, capture, les campagnes, le contenu, l’envoi, le tracking, le panneau opérationnel ainsi que les points d’inscription frontend.

Prérequis

Avant le déploiement, préparez :

Magento Open Source 2.4.x,
Composer,
un accès CLI à bin/magento,
un compte administrateur Magento,
les identifiants d’accès SMTP,
un cron Magento configuré,
la capacité à exécuter des consumers de file d’attente,
un environnement de test pour vérifier l’inscription, les campagnes et les envois.

Ce que le pack installe

Le pack comprend :

Kowal_MarketingCore,
Kowal_EmailTransport,
Kowal_EmailSmtp,
Kowal_EmailEvents,
Kowal_EmailTemplateStudio,
Kowal_NewsletterAudience,
Kowal_NewsletterCapture,
Kowal_NewsletterCampaigns,
Kowal_NewsletterConsole,
Kowal_NewsletterFrontend.

Il s’agit du plus haut niveau d’agrégation dans l’écosystème des modules d’email marketing pour Magento.

Installation

1. Installation du pack Composer

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store  composer require kowal/package-advanced-newsletter-suite

2. Activation des modules dans Magento

bin/magento module:enable \ Kowal_MarketingCore \ Kowal_EmailTransport \ Kowal_EmailSmtp \ Kowal_EmailEvents \ Kowal_EmailTemplateStudio \ Kowal_NewsletterAudience \ Kowal_NewsletterCapture \ Kowal_NewsletterCampaigns \ Kowal_NewsletterConsole \ Kowal_NewsletterFrontendbin/magento setup:upgradebin/magento cache:flush

En mode production, exécutez également :

bin/magento setup:di:compilebin/magento setup:static-content:deploy -f

Configuration

1. Section d’administration

La configuration de base doit être disponible dans :

Kowal / Email Marketing

Conformément à la spécification, les groupes de paramètres attendus sont :

general,
transport,
smtp,
campaigns,
double_opt_in,
events.

2. Configuration de l’envoi

Commencez par configurer la base de la delivery :

activité du module,
type de transport par défaut,
journalisation des envois,
compte ou comptes SMTP,
routage des messages,
fallback pour les comptes de secours, s’il est utilisé.

Le déploiement du pack complet requiert toujours une couche SMTP et transport pleinement opérationnelle.

3. Configuration des destinataires et des inscriptions

Confirmez ensuite la configuration de la couche destinataires :

l’intégration avec newsletter_subscriber,
les listes de diffusion,
les segments,
les statuts d’abonnement,
les métadonnées supplémentaires de l’abonné,
les sources d’acquisition,
les consentements marketing.

Configurez également le processus d’inscription :

les formulaires et points d’inscription,
le double opt-in,
le modèle du message de confirmation,
la durée de validité du token de confirmation.

4. Configuration des campagnes

Dans la section campaigns, définissez :

batch_size,
max_retry_count,
send_rate_limit_per_run,
watchdog_timeout_minutes.

Le pack prend en charge :

la définition des campagnes,
la planification,
la file des destinataires,
le traitement par lots des envois,
l’historique d’exécution des campagnes,
les envois test.

5. Configuration de Template Studio

Si le déploiement inclut le travail sur le contenu de la newsletter, configurez EmailTemplateStudio conformément au périmètre MVP :

travail sur les modèles natifs de newsletter Magento,
choix des layouts produits,
enregistrement de la section générée dans le modèle natif,
import du contenu prêt dans la campagne.

6. Configuration des événements email

Dans la section events, configurez :

le traitement des événements,
la rétention des payloads,
la politique d’acceptation des événements dupliqués provenant des fournisseurs.

La couche EmailEvents est responsable de l’observabilité du processus de distribution et de l’association des événements avec les logs de transport ainsi qu’avec les campagnes.

7. Configuration du panneau d’administration et du frontend

Le pack complet comprend :

Kowal_NewsletterConsole comme panneau opérationnel,
Kowal_NewsletterFrontend comme couche de formulaires et widgets d’inscription frontend.

Après l’installation, vérifiez :

la disponibilité du tableau de bord,
les raccourcis vers la configuration et les modules opérationnels,
la vue des dernières erreurs et des derniers envois,
la présence des formulaires d’inscription sur le frontend de la boutique.

Cron et consumers de file d’attente

Le pack complet nécessite un traitement asynchrone actif.

1. Cron Magento

bin/magento cron:install

Le cron doit être responsable de :

la planification des campagnes,
la récupération des tâches,
le watchdog opérationnel.

2. Queue consumers

Les consumers de file d’attente doivent assurer le traitement réel des lots d’envoi. Les noms des consumers doivent être récupérés depuis les fichiers actuels etc/queue_consumer.xml des modules déployés.

En environnement de production, veillez à :

lancer les consumers en arrière-plan,
assurer leur démarrage automatique après un redémarrage du serveur,
mettre en place une surveillance des pannes,
journaliser les erreurs.

Étapes après l’installation

Après le déploiement, effectuez la check-list complète :

Configurez et testez le compte SMTP.
Vérifiez le routage des messages.
Testez l’inscription d’un abonné et le double opt-in.
Confirmez la compatibilité avec la newsletter native de Magento.
Créez une liste ou un segment de test.
Préparez une campagne de test.
Effectuez un test send.
Vérifiez la planification des campagnes par cron.
Vérifiez le traitement de la file par les consumers.
Confirmez l’enregistrement des logs et des événements email.
Vérifiez le tableau de bord d’administration.
Vérifiez les formulaires et widgets d’inscription frontend.

Test d’acceptation après déploiement

Le pack est correctement déployé si :

les modules s’installent correctement dans Magento 2.4.x,
l’envoi SMTP fonctionne via les comptes et le routage,
l’inscription de l’abonné reste compatible avec la newsletter native de Magento,
la campagne est planifiée par cron et traitée par queue consumer,
les statuts de distribution mettent à jour les logs et les événements email,
le panneau d’administration affiche les données opérationnelles de base,
les points d’inscription frontend fonctionnent correctement,
après désactivation des modules, le mécanisme de base Magento_Newsletter peut toujours fonctionner.

Remarques de déploiement

Il est recommandé de déployer le pack complet avec une configuration SMTP et tracking déjà éprouvée.
Les données additionnelles doivent être stockées dans leurs propres tables, sans dupliquer la table native newsletter_subscriber.
La documentation opérationnelle du déploiement doit en outre couvrir la procédure de gestion des files, des webhooks et des tests de régression de la configuration administrative.

Suite newsletter avancée pour Magento 2

Toute la newsletter. Dans votre Magento.

La newsletter devient une partie de la boutique, et non un monde séparé.

Une seule base de destinataires

Un seul processus de campagne

Une seule vue d’ensemble

Tout entre l’inscription et le résultat.

Collectez des inscriptions à plusieurs endroits de la boutique.

Une base, c’est plus que des adresses email.

Créez vos messages visuellement.

D’abord un test, puis un envoi fiable.

Envoyez via le fournisseur de votre choix.

Vous voyez les réactions des clients et l’état du système.

De l’idée aux résultats en quatre étapes.

Vous collectez des destinataires

Vous créez le message

Vous choisissez le bon groupe

Vous envoyez et analysez

Vous savez ce qui fonctionne — et si tout fonctionne correctement.

Pack prêt à l’emploi pour Magento Open Source.

Compatibilité déclarée

Installation structurée

Envoi flexible

Court et concret.

Créez votre propre infrastructure d’email marketing dans Magento.

Reviews

Amazon SES - création de compte et configuration pour l’intégration d’envoi

Objectif du document

Remarque importante pour ce projet

Hypothèses initiales

1. Création d’un compte AWS

2. Activation d’Amazon SES

3. Vérification du domaine ou de l’adresse d’expéditeur

Variante recommandée

Étapes

Portée DNS minimale

4. Sortie du sandbox SES

Étapes

5. Configuration de la délivrabilité

DKIM

Custom MAIL FROM

6. Variante A - intégration via Amazon SES API

Quand choisir cette variante

6.1. Création d’un utilisateur IAM pour l’envoi

Exemple de politique minimale

6.2. Création de l’Access Key et de la Secret Key

6.3. Données nécessaires pour Magento dans la variante API

6.4. Correspondance avec le panneau Magento

7. Variante B - intégration via Amazon SES SMTP

Quand choisir cette variante

7.1. Création des identifiants SMTP dans SES

7.2. Endpoint SMTP

7.3. Port et chiffrement

7.4. Données nécessaires pour Magento dans la variante SMTP

7.5. Correspondance avec le panneau Magento

8. Que choisir dans ce projet

Choisissez SES API si :

Choisissez SES SMTP si :

9. Check-list minimale avant le test d’envoi

10. Erreurs les plus fréquentes

Le compte est toujours dans le sandbox

Le domaine n’est pas vérifié

Mauvaise région

Confusion entre clés API et identifiants SMTP

Utilisation du compte root

11. Liens vers la documentation officielle AWS

12. Données à transmettre pour le déploiement

Pour la variante SES API

Pour la variante SES SMTP

Advanced Newsletter Suite pour Magento 2 - guide d’installation et de configuration

Objectif du document

Prérequis

Ce que le pack installe

Installation

1. Installation du pack Composer

2. Activation des modules dans Magento

Configuration

1. Section d’administration

2. Configuration de l’envoi

3. Configuration des destinataires et des inscriptions