> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon SES

> Configurer Amazon SES comme fournisseur d'emails dans Notifuse.

Notifuse peut envoyer des emails via AWS Simple Email Service (SES).

## Configuration

Allez dans **Paramètres** → **Intégrations**, cliquez sur **Ajouter une intégration**, puis choisissez **Amazon SES** sous **Envoi d'emails**. Le formulaire s'ouvre en pleine page.

![Formulaire de l'intégration Amazon SES](https://www.notifuse.com/docs/assets/screenshots/ses_form.png)

![Paramètres Amazon SES](https://www.notifuse.com/docs/assets/screenshots/ses_settings.png)

### Champs du formulaire

| Champ                    | Description                                                                                                                                                  | Exemple                                    |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
| **Région**               | Région AWS où se trouvent vos identités vérifiées                                                                                                            | `us-east-1`                                |
| **ID de clé d'accès**    | Clé d'accès d'un utilisateur IAM autorisé à envoyer avec SES                                                                                                 | `AKIAIOSFODNN7EXAMPLE`                     |
| **Clé d'accès secrète**  | Clé d'accès secrète de cet utilisateur IAM                                                                                                                   | `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY` |
| **Isolation par tenant** | Facultatif. Donne à cette intégration son propre profil de réputation et sa propre liste de suppression (voir [plus bas](#reputation-isolation-ses-tenants)) | Désactivé                                  |
| **Configuration set**    | Facultatif, dans **Avancé**. Envoie via un configuration set que vous gérez                                                                                  | `my-config-set`                            |
| **Tenant SES**           | Facultatif, dans **Avancé**. Envoie via un tenant que vous gérez                                                                                             | `my-tenant`                                |

### Liste des expéditeurs

Ajoutez des adresses d'expéditeur vérifiées dans vos paramètres AWS SES :

| Champ     | Description                   | Exemple                  |
| --------- | ----------------------------- | ------------------------ |
| **Nom**   | Nom affiché de l'expéditeur   | `Support Team`           |
| **Email** | Adresse email de l'expéditeur | `support@yourdomain.com` |

Les expéditeurs doivent être vérifiés dans la console AWS SES avant de pouvoir être utilisés.

### Types d'usage

Choisissez ce qu'envoie cette intégration Amazon SES depuis le menu **⋯** de sa carte dans **Paramètres** → **Intégrations** (**Utiliser pour le marketing**, **Utiliser pour le transactionnel**), ou dans le panneau **Envoi d'emails** de cette page :

| Option                              | Description                                                            | Exemples                                                                              |
| ----------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Utiliser pour le transactionnel** | Emails générés par le système à la suite d'une action de l'utilisateur | Réinitialisations de mot de passe, confirmations de commande, notifications de compte |
| **Utiliser pour le marketing**      | Emails promotionnels et newsletters envoyés aux abonnés                | Annonces de produits, newsletters, campagnes promotionnelles                          |

Choisissez les deux pour envoyer tous les types d'emails avec la même configuration SES.

### Webhooks

Notifuse s'abonne automatiquement aux webhooks SES suivants :

| Type de webhook | Description                       | Rôle                            |
| --------------- | --------------------------------- | ------------------------------- |
| **Livraison**   | Email bien remis                  | Suivre les livraisons réussies  |
| **Rebond**      | Email rejeté                      | Surveiller les rebonds          |
| **Plaintes**    | Le destinataire a signalé un abus | Traiter les signalements d'abus |

Notifuse reçoit ces événements de livraison au moment où ils se produisent.

## Isolation de la réputation (tenants SES)

Par défaut, tous les espaces de travail d'un compte AWS partagent une même réputation d'envoi et **une seule liste de suppression**. La campagne mal ciblée d'une équipe peut faire passer le taux de rebonds ou de plaintes du compte au-dessus des seuils d'AWS et suspendre les envois de tout le monde. Un rebond définitif dans un espace de travail place aussi ce destinataire dans la liste de suppression de tous les autres.

L'**Isolation par tenant** donne à une intégration son propre [tenant SES](https://docs.aws.amazon.com/ses/latest/dg/tenants.html), avec son profil de réputation, ses métriques de rebonds et de plaintes et sa liste de suppression. AWS peut alors suspendre un seul tenant au lieu du compte entier.

> [!NOTE]
>
> **En auto-hébergement, créer un nouveau tenant SES demande une [clé de licence](https://www.notifuse.com/fr/docs/self-hosting/licence.md).** Un tenant déjà créé continue d'envoyer avec sa propre réputation indéfiniment, sans clé : le chemin d'envoi ne vérifie pas la licence. Notifuse Cloud inclut l'isolation par tenant SES à partir de l'offre Starter ([détails](https://www.notifuse.com/fr/docs/self-hosting/licence.md#on-notifuse-cloud)).

### L'activer

Ouvrez l'intégration (**Paramètres** → **Intégrations**), activez l'**Isolation par tenant** dans le panneau **Réputation**, puis enregistrez. Notifuse vous demande de confirmer, car un tenant est une ressource AWS facturée, puis crée tout le nécessaire dans votre compte :

| Étape                             | Ce que fait Notifuse                                                                                            |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Créer le tenant**               | Nommé `notifuse-<integration ID>`, avec `SuppressionScope: TENANT` pour les rebonds et les plaintes             |
| **Associer le configuration set** | Rattache le configuration set par lequel cette intégration envoie                                               |
| **Associer les identités**        | Rattache chaque identité vérifiée qui couvre un expéditeur : l'adresse exacte, son domaine ou un domaine parent |

Enregistrer à nouveau relance les mêmes étapes. C'est ainsi qu'un expéditeur ajouté plus tard est associé, et qu'une exécution partielle est reprise.

> [!NOTE]
>
> **La suppression au niveau du tenant n'est pas le réglage par défaut d'AWS.** Un tenant créé à la main dans la console SES hérite de la liste de suppression du compte si vous ne réglez pas vous-même la portée de suppression. Vous obtenez alors l'isolation de la réputation mais, sans aucun avertissement, _pas_ celle de la suppression. Notifuse règle la portée à la création, et la corrige si un tenant du même nom existe déjà.

> [!NOTE]
>
> L'isolation s'applique à l'**intégration**, pas à l'espace de travail. Un espace de travail qui utilise deux intégrations SES distinctes, l'une pour le marketing et l'autre pour le transactionnel, obtient deux tenants, chacun avec sa liste de suppression : une adresse en rebond sur l'une n'est pas bloquée par SES sur l'autre. La liste de suppression que Notifuse tient pour chaque espace de travail s'applique toujours aux deux, donc au pire un message de plus part vers une adresse que SES sait déjà mauvaise.

### Ce que vous verrez

- **Un expéditeur sans identité vérifiée** est signalé par son nom après l'enregistrement. Ses envois échoueraient avec ou sans tenant, corrigez-le donc.
- **Une permission IAM manquante** est signalée avec l'action exacte et une commande `aws` CLI à lancer. Notifuse ne fait passer l'intégration sur le tenant qu'une fois son configuration set associé, car SES rejette **tous** les messages envoyés via un tenant qui n'en a pas. Une configuration partielle laisse l'envoi exactement comme il était.
- La carte de l'intégration affiche le configuration set utilisé et indique si la réputation est `isolated` ou `shared with the rest of this AWS account`.

### La désactiver

Désactiver l'**Isolation par tenant** prend effet au prochain envoi : les messages repartent sous la réputation partagée du compte. Le tenant reste dans AWS avec sa liste de suppression et son historique de réputation, et la réactivation reprend le même tenant.

> [!NOTE]
>
> Un tenant dont l'isolation a été désactivée **reste facturé** jusqu'à la suppression de l'intégration. Désactivez-la pour changer votre façon d'envoyer ; supprimez l'intégration pour arrêter la facturation.

> [!WARNING]
>
> **Supprimer l'intégration supprime le tenant**, avec sa liste de suppression et son historique de réputation, qui ne peuvent pas être recréés. Retirer seulement les webhooks laisse les deux en place, car l'envoi en dépend toujours.

### Avancé : utiliser votre propre tenant ou configuration set

Dans **Avancé**, les deux champs sont facultatifs et suggèrent les noms qui existent dans votre compte (ils deviennent de simples champs texte si vos identifiants ne permettent pas de les lister) :

| Champ                 | Description                                                                                                                                                                                    |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Configuration set** | Envoie via un configuration set que vous gérez, au lieu de celui nommé `notifuse-<integration ID>`. Notifuse y rattache sa destination d'événements, mais ne le crée ni ne le supprime jamais. |
| **Tenant SES**        | Envoie via un tenant que vous gérez vous-même. Incompatible avec l'interrupteur ci-dessus. Notifuse ne le crée, ne le modifie et ne le supprime pas.                                           |

Avec votre propre tenant, vous devez lui associer vous-même l'identité d'envoi **et** le configuration set, sinon SES rejette chaque envoi :

```bash
aws sesv2 create-tenant-resource-association \
  --tenant-name my-tenant \
  --resource-arn arn:aws:ses:<region>:<account>:configuration-set/<name>
```

> [!NOTE]
>
> Les tenants n'existent que dans l'API SES v2, celle que Notifuse utilise désormais pour envoyer. Ils sont aussi propres à une région : un tenant se trouve dans la même région que son intégration.

## Réponses entrantes (arrêt à la réponse)

Pour la **[Sortie à la réponse](https://www.notifuse.com/fr/docs/features/automations.md#exit-on-reply)** dans les automations, SES doit transmettre les réponses entrantes à Notifuse. SES traite le courrier reçu à part de l'envoi : vous le configurez donc une fois, en deux temps :

1. **Pointez les enregistrements MX de votre domaine vers SES.** Ajoutez sur votre domaine d'envoi un enregistrement MX qui pointe vers le point d'entrée SES de réception de votre région, `inbound-smtp.<region>.amazonaws.com` (par exemple `inbound-smtp.us-east-1.amazonaws.com`), avec la priorité `10`. Sans lui, les réponses n'arrivent jamais jusqu'à SES. SES n'a pas d'API DNS, vous le faites donc à la main.
2. **Enregistrez la route entrante.** Dans **Paramètres → Intégrations**, ouvrez le menu **⋯** de l'intégration SES et choisissez **Réenregistrer les webhooks** (**Enregistrer les webhooks** s'ils ne sont pas encore enregistrés). En plus des webhooks d'événements de livraison, de rebond et de plainte, Notifuse crée un topic SNS (abonné en HTTPS à Notifuse, signé avec SignatureVersion 2) et une **règle de réception** SES avec une action SNS. Si votre compte a un ensemble de règles de réception actif, la règle est ajoutée **dans celui-ci**. Elle ne fait que transmettre une copie et n'a pas d'action _stop_, donc une configuration existante (comme Amazon WorkMail) continue de fonctionner. Notifuse crée et active un ensemble de règles dédié `notifuse-inbound` **seulement** si aucun ensemble de règles n'est actif.

> [!NOTE]
>
> La réception d'emails SES n'existe que dans certaines régions AWS (par exemple `us-east-1`, `us-west-2`, `eu-west-1`). Si la région de votre intégration ne la prend pas en charge, l'enregistrement entrant est indiqué comme indisponible. Consultez la liste AWS des [Email Receiving endpoints](https://docs.aws.amazon.com/general/latest/gr/ses.html).
>
> Le topic SNS entrant, la règle de réception et l'abonnement demandent des permissions IAM en plus de celles d'envoi : `sns:CreateTopic`, `sns:SetTopicAttributes`, `sns:Subscribe`, `ses:DescribeActiveReceiptRuleSet`, `ses:CreateReceiptRuleSet`, `ses:CreateReceiptRule`, `ses:SetActiveReceiptRuleSet`, `ses:DeleteReceiptRule` et `ses:ListIdentities`. La règle de réception ne couvre que les identités vérifiées de votre compte (domaines et adresses email). Si aucune n'est vérifiée, l'enregistrement entrant est refusé, pour que la règle ne transmette jamais tout le courrier du compte.
>
> Les réponses sont rattachées à l'envoi d'origine par leur `Message-ID`. SES réécrit cet en-tête à l'envoi : Notifuse enregistre donc la valeur que SES renvoie et la fait correspondre quel que soit l'hôte, sans clé de signature entrante distincte. Avant d'être acceptée, chaque notification SNS entrante voit sa **signature RSA vérifiée** et doit être **liée au topic créé** : un message venant de tout autre topic SNS est rejeté, même avec une signature AWS valide. Le point d'entrée a une limite de débit.

> [!WARNING]
>
> **Les configurations manuelles doivent renseigner l'ARN du topic SNS.** Les messages entrants sont authentifiés par rapport au topic créé, donc une intégration sans ARN de topic lié rejette tout le courrier entrant. Si vous enregistrez les webhooks depuis le menu **⋯**, Notifuse le renseigne pour vous. Si vous branchez la réception SES à la main (votre propre topic SNS + règle de réception), renseignez l'ARN du topic dans le paramètre `inbound_topic_arn` de l'intégration SES, sinon les réponses ne seront pas acceptées.

Une fois les deux étapes en place, un contact qui répond à un email d'automation quitte le parcours si cette automation a la **Sortie à la réponse** activée. Les rebonds et les réponses automatiques d'absence ne comptent jamais comme une réponse.

## Prérequis

Il vous faut :

1. Un compte AWS actif avec SES activé
2. Des adresses email ou des domaines vérifiés dans la console AWS SES
3. Un utilisateur AWS avec les permissions d'envoi SES (voir plus bas)
4. L'accès production : sortez du sandbox SES pour envoyer sans restrictions

### Permissions IAM

Seul le premier groupe est obligatoire. Chacun des autres active une fonction facultative, et Notifuse fonctionne sans lui : une permission manquante est signalée avec l'action à ajouter, jamais par un échec silencieux.

| Usage                                   | Actions                                                                                                                                                                                                                                                                                                                                            |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Envoi** (obligatoire)                 | `ses:SendEmail`                                                                                                                                                                                                                                                                                                                                    |
| **Webhooks d'événements**               | `ses:CreateConfigurationSet`, `ses:DescribeConfigurationSet`, `ses:ListConfigurationSets`, `ses:DeleteConfigurationSet`, `ses:CreateConfigurationSetEventDestination`, `ses:UpdateConfigurationSetEventDestination`, `ses:DeleteConfigurationSetEventDestination`, `sns:CreateTopic`, `sns:Subscribe`, `sns:GetTopicAttributes`, `sns:DeleteTopic` |
| **Isolation de la réputation**          | `ses:CreateTenant`, `ses:GetTenant`, `ses:PutTenantSuppressionAttributes`, `ses:CreateTenantResourceAssociation`, `ses:ListEmailIdentities`                                                                                                                                                                                                        |
| **Sélecteurs de noms et vérifications** | `ses:ListTenants`, `ses:ListTenantResources`                                                                                                                                                                                                                                                                                                       |
| **Suppression propre**                  | `ses:DeleteTenant`, `ses:DeleteTenantResourceAssociation`                                                                                                                                                                                                                                                                                          |
| **Réponses entrantes**                  | Voir la [note sur l'arrêt à la réponse](#inbound-replies-stop-on-reply) plus haut                                                                                                                                                                                                                                                                  |

> [!WARNING]
>
> Sans les permissions de **suppression propre**, supprimer une intégration laisse son tenant dans votre compte AWS, où il reste facturé jusqu'à ce que vous le supprimiez à la main.

## Test

Cliquez sur **Envoyer un e-mail de test** en haut du formulaire de l'intégration, ou sur **Envoyer un test** sur sa carte, pour vérifier votre configuration.
