> ## 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.

# Mailgun

> Configurer Mailgun comme fournisseur d'emails dans Notifuse.

Notifuse peut envoyer des emails via Mailgun.

## Configuration

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

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

![Paramètres Mailgun](https://www.notifuse.com/docs/assets/screenshots/mailgun_settings.png)

### Champs du formulaire

| Champ       | Description                         | Exemple                   |
| ----------- | ----------------------------------- | ------------------------- |
| **Domaine** | Votre domaine d'envoi vérifié       | `mg.yourdomain.com`       |
| **Clé API** | Votre clé API privée Mailgun        | `key-1234567890abcdef...` |
| **Région**  | Où votre compte Mailgun est hébergé | `US` ou `EU`              |

### Liste des expéditeurs

Ajoutez des adresses d'expéditeur vérifiées dans votre compte Mailgun :

| 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 Mailgun avant de pouvoir être utilisés.

### Types d'usage

Mailgun peut envoyer à la fois des emails transactionnels et des newsletters. Choisissez ce qu'il envoie 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**      | Campagnes d'emails de masse et newsletters                             | Newsletters marketing, nouveautés produit, emails promotionnels                       |

### Webhooks

Notifuse enregistre automatiquement les webhooks Mailgun 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.

## 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, Mailgun doit transmettre les réponses entrantes à Notifuse. Vous le configurez une fois, en deux temps :

1. **Pointez les enregistrements MX de votre domaine vers Mailgun.** Ajoutez les enregistrements MX de réception de Mailgun dans le DNS de votre domaine d'envoi, en général `mxa.mailgun.org` et `mxb.mailgun.org`, tous deux avec la priorité `10`. Sans eux, les réponses n'arrivent jamais jusqu'à Mailgun. Mailgun 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 Mailgun et choisissez **Réenregistrer les webhooks** (**Enregistrer les webhooks** s'ils ne sont pas encore enregistrés). En plus des webhooks de livraison, de rebond et de plainte, Notifuse crée une **Route** Mailgun qui transmet à Notifuse le courrier entrant de votre domaine. Cette route n'est pas prioritaire : elle transmet une copie et laisse vos autres routes Mailgun s'exécuter, donc une configuration de réception existante continue de fonctionner.

> [!NOTE]
>
> Les réponses sont rattachées à l'envoi d'origine par leur `Message-ID` (une valeur impossible à deviner que Notifuse fixe à l'envoi) : aucune clé de signature entrante distincte n'est nécessaire. Le point d'entrée de réception a une limite de débit.

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 Mailgun actif
2. Un domaine vérifié dans la console Mailgun
3. Une clé API privée Mailgun

## 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.
