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

# Configuração do Mailgun

> Guia passo a passo para configurar o Mailgun com OneSignal para enviar mensagens de email. Inclui verificação de DNS, configuração de credenciais SMTP, geração de chave API e instruções de integração com OneSignal.

<Warning>
  Este guia de configuração é se você já tem Mailgun e quer integrá-lo com OneSignal. Se você não tem uma conta Mailgun, você pode usar [Email OneSignal](./email-setup) em vez disso.
</Warning>

## Requisitos

* [Conta Mailgun](https://www.mailgun.com)
* API Mailgun **US** (região EU não é suportada)
* [Conta OneSignal](https://onesignal.com)
* Um domínio que você possui e acesso ao seu provedor de DNS

***

## Configuração

### 1. Adicionar um novo domínio no Mailgun

Pule esta etapa se seu domínio já está configurado na região US.

1. Vá para a página **Domains** no painel do Mailgun.

<Frame caption="Navegue até a página Domains">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6e14df8-01_-_Navigate_to_sending_domains.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=542d06f8870b8e98cdb276d475cb2d99" width="1328" height="1124" data-path="images/docs/6e14df8-01_-_Navigate_to_sending_domains.png" />
</Frame>

2. Clique em **Add new domain**.

<Frame caption="Abra o formulário Add New Domain">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/403bd98-01.2_-_Click_Add_new_domain_button.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=d0d94e8e010730d7f80fb782f0bf3557" width="1328" height="1124" data-path="images/docs/403bd98-01.2_-_Click_Add_new_domain_button.png" />
</Frame>

3. Insira um subdomínio (por exemplo, `mail.seudominio.com`) e garanta que a região seja **US**.

<Frame caption="Especifique o subdomínio e selecione a região US">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/ad8dca5-01.3_-_Add_new_domain.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=fa477b2191c6b916fb4e16a9bf457161" width="1328" height="1124" data-path="images/docs/ad8dca5-01.3_-_Add_new_domain.png" />
</Frame>

### 2. Verificar configurações de DNS

O Mailgun fornece os seguintes registros DNS:

* 2 **TXT** (SPF & DKIM)
* 2 **MX**
* 1 **CNAME**

Atualize estes em seu provedor de DNS. A propagação pode levar até 48 horas. O Mailgun notificará você por email assim que verificado.

Para verificar:

* Vá para **Mailgun > Sending > Domain Settings > Your Domain > DNS Records**
* Procure por marcas de verificação verdes ao lado de cada registro

<Frame caption="Verificar configuração de DNS">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/ddbf617-01.5_-_Verified_DNS_settings.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=26bd8596b9ac4b96089b8225c00fa94d" width="1328" height="1124" data-path="images/docs/ddbf617-01.5_-_Verified_DNS_settings.png" />
</Frame>

<Info>
  Se o CNAME não estiver configurado corretamente, o rastreamento de cliques, aberturas e cancelamento de assinatura de email não funcionará.
</Info>

***

### 3. Configurar credenciais SMTP

1. Vá para **Sending > Domain Settings > SMTP credentials** no Mailgun.

<Frame caption="Navegue até SMTP Credentials">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/963d676-02_-_Add_SMTP_creds.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=2cb892039a5cfee55aa25da01ae438e1" width="1328" height="1124" data-path="images/docs/963d676-02_-_Add_SMTP_creds.png" />
</Frame>

2. Clique em **Add new SMTP user**.

<Frame caption="Adicionar novas credenciais SMTP">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b2108d4-02.1_-_Click_Add_new_SMTP_user.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=79537c0dae456ed4320ad09647db4d87" width="1328" height="1124" data-path="images/docs/b2108d4-02.1_-_Click_Add_new_SMTP_user.png" />
</Frame>

3. Defina um nome de login e salve as credenciais.

<Frame caption="Criar usuário SMTP">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/be7540c-03_-_New_SMTP_creds.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=53a10a727d7dbb9a8234332e50e3308e" width="1328" height="1124" data-path="images/docs/be7540c-03_-_New_SMTP_creds.png" />
</Frame>

4. Clique no ícone de **copiar** para salvar a senha com segurança.

<Frame caption="Copiar senha SMTP">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/ab32f9b-03.1_-_Copy_SMTP_user_pass.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=51aeb4db620490e077f63465619e2711" width="1328" height="1124" data-path="images/docs/ab32f9b-03.1_-_Copy_SMTP_user_pass.png" />
</Frame>

### 4. Obter uma chave API do Mailgun

1. No painel do Mailgun, role até o final e clique em **API Keys**.

<Frame caption="Navegue até API Keys">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/430314e-42fc46d-step-1-50.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=f80af7cfcfe4be2d94418b6f15448097" width="1616" height="1365" data-path="images/docs/430314e-42fc46d-step-1-50.png" />
</Frame>

2. Clique em **Add new key**

<Frame caption="Adicionar nova chave">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6390d56-93a49a5-step-2-50.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=45c91e47914b90b577388c8c26fc9538" width="1616" height="1365" data-path="images/docs/6390d56-93a49a5-step-2-50.png" />
</Frame>

3. Nomeie a chave e clique em **Create Key**.

<Frame caption="Criar chave">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/09dd33b-6faf199-step-3-50.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=87af7bad8fc8363e916e5673779a65ea" width="1616" height="1365" data-path="images/docs/09dd33b-6faf199-step-3-50.png" />
</Frame>

4. Copie a chave API gerada e salve-a com segurança.

<Frame caption="Copiar chave API">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1350337-cb5aeba-step-4-50.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=d4f1a03d0287b8c3169bda289b839cfa" width="1616" height="1365" data-path="images/docs/1350337-cb5aeba-step-4-50.png" />
</Frame>

***

### 5. Configurar Mailgun no OneSignal

1. No OneSignal, vá para **Settings > Platforms > Email** e escolha **Mailgun**.

<Frame caption="Configuração de email do aplicativo">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/9341a6c-01_-_App_setup_email.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=2c645ab6c1107ed5bb1122aacff78d17" width="1328" height="1124" data-path="images/docs/9341a6c-01_-_App_setup_email.png" />
</Frame>

2. Selecione **Mailgun** como o provedor.

<Frame caption="Configuração de email do aplicativo">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4a2a57c-02_-_App_Setup_Email_Mailgun.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=d7bcb86f6bc0d15df9b49a147d132959" width="1328" height="1124" data-path="images/docs/4a2a57c-02_-_App_Setup_Email_Mailgun.png" />
</Frame>

3. Insira:

* O domínio do [Passo 1](#1-adicionar-um-novo-dominio-no-mailgun)
* Credenciais SMTP do [Passo 3](#3-configurar-credenciais-smtp)
* Chave API do [Passo 4](#4-obter-uma-chave-api-do-mailgun)

<Frame caption="Configurar provedor">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/07c6b2f-03_-_Configure_provider.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=a3cb35435c5496d52c08135bed6c99d0" width="1328" height="1124" data-path="images/docs/07c6b2f-03_-_Configure_provider.png" />
</Frame>

4. Defina o nome do remetente padrão e endereço de email `from`.

<Frame caption="Configurar configurações adicionais">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9e6af63-04_-_Configure_additional_settings.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=7c34b6e400662d67808226872626e1de" width="1328" height="1124" data-path="images/docs/9e6af63-04_-_Configure_additional_settings.png" />
</Frame>

### 6. Adicionar webhooks do OneSignal ao Mailgun

Navegue até **Mailgun > Sending > Webhooks > Your Domain > Webhooks** e adicione:

```
https://onesignal.com/email/hooks/mailgun
```

<Frame caption="Adicionar webhook">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d81f4cc-Screenshot_2023-01-25_at_3.48.04_PM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=30721d7d06a88cae8fc244577f767a89" width="1534" height="1212" data-path="images/docs/d81f4cc-Screenshot_2023-01-25_at_3.48.04_PM.png" />
</Frame>

### 7. Mudar protocolo de rastreamento para HTTPS

Garanta que os destinatários sejam direcionados para URLs seguras.

1. Vá para as configurações de domínio no Mailgun.
2. Em **Tracking > Tracking Protocol**, mude de **HTTP** para **HTTPS**.

<Frame caption="Mudar protocolo de rastreamento">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e79e542-Screenshot_2023-01-25_at_3.52.26_PM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=bfb73b54c1f4a81ae480cdfda0413966" width="2228" height="632" data-path="images/docs/e79e542-Screenshot_2023-01-25_at_3.52.26_PM.png" />
</Frame>

### 8. Enviar um email de teste

1. Vá para **OneSignal > Messages > Email**, clique em **New Email**.
2. Adicione um assunto, clique em **Send Test Email**, insira seu email e clique em **Send Test Message**.

<Frame caption="Enviar email de teste">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=5d3969be38e8e9caea691fdb094a54c7" width="1806" height="598" data-path="images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png" />
</Frame>

Você deve receber o email de teste em breve.

***

## Solução de problemas

Consulte nosso [FAQ de Email](./email-troubleshooting)

<Info>
  Precisa de ajuda?

  Converse com nossa equipe de Suporte ou envie email para `support@onesignal.com`

  Por favor inclua:

  * Detalhes do problema que você está enfrentando e passos para reproduzir se disponível
  * Seu OneSignal App ID
  * O External ID ou Subscription ID se aplicável
  * A URL para a mensagem que você testou no Dashboard OneSignal se aplicável
  * Quaisquer [logs ou mensagens de erro](/docs/pt-BR/capturing-a-debug-log) relevantes

  Estamos felizes em ajudar!
</Info>

***

<Check>
  Configuração de email concluída!
  **Próximos passos:**

  * Retorne ao [guia de Configuração de Email](./email-setup) para explorar as capacidades de Email do OneSignal.
</Check>

***