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

> Configure o Mailgun como provedor de email no Notifuse.

O Notifuse pode enviar emails pelo Mailgun.

## Configuração

Vá em **Configurações** → **Integrações**, clique em **Adicionar integração** e escolha **Mailgun** em **Envio de emails**. O formulário abre em tela cheia.

![Formulário da integração Mailgun](https://www.notifuse.com/docs/assets/screenshots/mailgun_form.png)

![Configurações do Mailgun](https://www.notifuse.com/docs/assets/screenshots/mailgun_settings.png)

### Campos do formulário

| Campo         | Descrição                               | Exemplo                   |
| ------------- | --------------------------------------- | ------------------------- |
| **Domínio**   | O seu domínio de envio verificado       | `mg.yourdomain.com`       |
| **Chave API** | A sua chave API privada do Mailgun      | `key-1234567890abcdef...` |
| **Região**    | Onde a sua conta Mailgun está hospedada | `US` ou `EU`              |

### Lista de remetentes

Adicione os endereços de remetente verificados na sua conta Mailgun:

| Campo     | Descrição                      | Exemplo                  |
| --------- | ------------------------------ | ------------------------ |
| **Nome**  | Nome exibido do remetente      | `Support Team`           |
| **Email** | Endereço de email do remetente | `support@yourdomain.com` |

Os remetentes precisam estar verificados no console do Mailgun antes de você poder usá-los.

### Tipos de uso

O Mailgun pode enviar tanto emails transacionais quanto campanhas de broadcast. Escolha o que ele envia no menu **⋯** do card dele em **Configurações** → **Integrações** (**Usar para marketing**, **Usar para transacional**) ou no painel **Envio de emails** da mesma página:

| Opção                      | Descrição                                                | Exemplos                                                            |
| -------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------- |
| **Usar para transacional** | Emails gerados pelo sistema a partir de ações do usuário | Redefinição de senha, confirmação de pedido, avisos da conta        |
| **Usar para marketing**    | Campanhas de email em massa e newsletters                | Newsletters de marketing, novidades do produto, emails promocionais |

### Webhooks

O Notifuse registra automaticamente os seguintes webhooks do Mailgun:

| Tipo de webhook | Descrição                      | Finalidade                   |
| --------------- | ------------------------------ | ---------------------------- |
| **Entrega**     | Email entregue                 | Acompanhar as entregas       |
| **Retorno**     | Email retornado                | Monitorar os retornos        |
| **Reclamações** | O destinatário denunciou abuso | Tratar as denúncias de abuso |

O Notifuse recebe esses eventos de entrega no momento em que acontecem.

## Respostas recebidas (parar ao responder)

Para usar **[Sair ao responder](https://www.notifuse.com/pt/docs/features/automations.md#exit-on-reply)** nas automações, o Mailgun precisa encaminhar as respostas recebidas ao Notifuse. Você configura isso uma única vez, em duas partes:

1. **Aponte os registros MX do seu domínio para o Mailgun.** Adicione os registros MX de recebimento do Mailgun ao DNS do seu domínio de envio, em geral `mxa.mailgun.org` e `mxb.mailgun.org`, ambos com prioridade `10`. Sem eles, as respostas nunca chegam ao Mailgun. O Mailgun não tem API de DNS, então você faz isso à mão.
2. **Registre a rota de recebimento.** Em **Configurações → Integrações**, abra o menu **⋯** da integração Mailgun e escolha **Registrar webhooks novamente** (ou **Registrar webhooks**, se eles ainda não estiverem registrados). Além dos webhooks de entrega, retorno e reclamação, o Notifuse cria uma **Route** no Mailgun que encaminha ao Notifuse os emails recebidos no seu domínio. A rota não interrompe as demais: ela encaminha uma cópia e deixa as suas outras rotas do Mailgun continuarem rodando, então uma configuração de recebimento existente continua funcionando.

> [!NOTE]
>
> As respostas são associadas ao envio original pelo `Message-ID` (um valor impossível de adivinhar que o Notifuse define no envio), então não é necessária uma chave de assinatura separada para o recebimento. O endpoint de recebimento tem limite de requisições.

Com as duas partes prontas, um contato que responde a um email de automação sai da jornada se essa automação estiver com **Sair ao responder** ativado. Retornos e respostas automáticas de ausência nunca contam como resposta.

## Pré-requisitos

Você precisa de:

1. Uma conta Mailgun ativa
2. Um domínio verificado no console do Mailgun
3. Uma chave API privada do Mailgun

## Teste

Clique em **Enviar um e-mail de teste** no topo do formulário da integração, ou em **Enviar teste** no card dela, para verificar a configuração.
