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

> Configura Mailgun come provider email in Notifuse.

Notifuse può inviare email tramite Mailgun.

## Configurazione

Vai in **Impostazioni** → **Integrazioni**, fai clic su **Aggiungi integrazione**, poi scegli **Mailgun** in **Invio email**. Il modulo si apre a pagina intera.

![Modulo dell'integrazione Mailgun](https://www.notifuse.com/docs/assets/screenshots/mailgun_form.png)

![Impostazioni di Mailgun](https://www.notifuse.com/docs/assets/screenshots/mailgun_settings.png)

### Campi del modulo

| Campo       | Descrizione                            | Esempio                   |
| ----------- | -------------------------------------- | ------------------------- |
| **Dominio** | Il tuo dominio di invio verificato     | `mg.yourdomain.com`       |
| **API Key** | La tua API key privata di Mailgun      | `key-1234567890abcdef...` |
| **Regione** | Dove è ospitato il tuo account Mailgun | `US` o `EU`               |

### Elenco dei mittenti

Aggiungi gli indirizzi mittente verificati nel tuo account Mailgun:

| Campo     | Descrizione                    | Esempio                  |
| --------- | ------------------------------ | ------------------------ |
| **Nome**  | Nome visualizzato del mittente | `Support Team`           |
| **Email** | Indirizzo email del mittente   | `support@yourdomain.com` |

Prima di poterli usare, i mittenti devono essere verificati nella console di Mailgun.

### Tipi di utilizzo

Mailgun può inviare sia email transazionali sia campagne broadcast. Scegli cosa invia dal menu **⋯** della sua scheda in **Impostazioni** → **Integrazioni** (**Usa per il marketing**, **Usa per il transazionale**), oppure nel pannello **Invio email** della stessa pagina:

| Opzione                      | Descrizione                                                  | Esempi                                                                   |
| ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------ |
| **Usa per il transazionale** | Email generate dal sistema in seguito ad azioni degli utenti | Reimpostazione della password, conferme d'ordine, notifiche dell'account |
| **Usa per il marketing**     | Campagne email di massa e newsletter                         | Newsletter di marketing, novità di prodotto, email promozionali          |

### Webhook

Notifuse registra automaticamente i seguenti webhook di Mailgun:

| Tipo di webhook | Descrizione                           | Scopo                                  |
| --------------- | ------------------------------------- | -------------------------------------- |
| **Consegna**    | Email consegnata                      | Tenere traccia delle consegne riuscite |
| **Bounce**      | Email respinta                        | Monitorare i bounce                    |
| **Reclami**     | Il destinatario ha segnalato un abuso | Gestire le segnalazioni di abuso       |

Notifuse riceve questi eventi di consegna in tempo reale.

## Risposte in entrata (stop alla risposta)

Per usare **[Uscita alla risposta](https://www.notifuse.com/it/docs/features/automations.md#exit-on-reply)** nelle automazioni, Mailgun deve inoltrare a Notifuse le risposte in entrata. Lo configuri una sola volta, in due parti:

1. **Punta i record MX del tuo dominio su Mailgun.** Aggiungi i record MX di ricezione di Mailgun al DNS del tuo dominio di invio, di solito `mxa.mailgun.org` e `mxb.mailgun.org`, entrambi con priorità `10`. Senza questi record le risposte non arrivano mai a Mailgun. Mailgun non ha un'API DNS, quindi va fatto a mano.
2. **Registra la route in entrata.** In **Impostazioni → Integrazioni**, apri il menu **⋯** dell'integrazione Mailgun e scegli **Registra di nuovo i webhook** (**Registra i webhook** se non sono ancora registrati). Oltre ai webhook di consegna, bounce e reclamo, Notifuse crea in Mailgun una **Route** che inoltra a Notifuse la posta in entrata del tuo dominio. La route non è esclusiva: inoltra una copia e lascia funzionare le altre route di Mailgun, quindi una configurazione di ricezione esistente continua a funzionare.

> [!NOTE]
>
> Le risposte vengono abbinate all'invio originale tramite il loro `Message-ID` (un valore impossibile da indovinare che Notifuse imposta al momento dell'invio), quindi non serve una chiave di firma separata per la posta in entrata. L'endpoint di ricezione ha un limite di frequenza.

Con entrambe le parti configurate, un contatto che risponde a un'email di un'automazione esce dal percorso se in quell'automazione è attiva **Uscita alla risposta**. I bounce e le risposte automatiche di assenza non contano mai come risposta.

## Prerequisiti

Ti servono:

1. Un account Mailgun attivo
2. Un dominio verificato nella console di Mailgun
3. Una API key privata di Mailgun

## Test

Fai clic su **Invia un’email di prova** in cima al modulo dell'integrazione, oppure su **Invia prova** nella sua scheda, per verificare la configurazione.
