> ## 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 de DNS de email

> Adicione manualmente registros DNS (SPF, DKIM, DMARC, CNAME, MX) para autenticar seu domínio de envio para entrega de email do OneSignal.

Configure os registros DNS fornecidos pelo OneSignal para autenticar seu domínio de envio. Na maioria dos casos, o DNS pode ser configurado automaticamente a partir do dashboard do OneSignal conforme descrito no guia de [Configuração de email](./email-setup). Use esta página quando precisar adicionar registros manualmente.

## Requisitos

Para configurar manualmente os registros DNS, você deve:

* Possuir o domínio de envio.
* Ter acesso às configurações de DNS através do seu provedor.

Se você não possui um domínio, recomendamos comprar um pelo Cloudflare. Este guia usa Cloudflare como exemplo, mas a maioria dos provedores de DNS funciona da mesma forma.

<Accordion title="Registrando seu domínio com Cloudflare" icon="circle-chevron-down">
  Crie uma conta em [Cloudflare.com](https://www.cloudflare.com/).

  Vá para **Domain Registration > Register Domains**.

  <Frame caption="Página de registro de domínio do Cloudflare">
    <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/738ee09-Register_a_Domain.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=327f5030dcc96a69aacf608556573bad" alt="Dashboard do Cloudflare mostrando a página de registro de domínios" width="1300" height="775" data-path="images/docs/738ee09-Register_a_Domain.png" />
  </Frame>

  Pesquise por um nome disponível e compre-o.

  <Frame caption="Página de compra de domínio do Cloudflare">
    <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/914f661-Purchase_Domain.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=b81467e17066a8937256778554c2d014" alt="Resultados de pesquisa de domínio do Cloudflare com opção de compra" width="1386" height="542" data-path="images/docs/914f661-Purchase_Domain.png" />
  </Frame>

  Uma vez comprado, seu domínio aparecerá em **Domain Registration > Managed Domains**.

  <Frame caption="Página de domínios gerenciados do Cloudflare">
    <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/64857b3-Domain_Active.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=a3354c52a0f2442467d289d9e8071872" alt="Lista de domínios gerenciados do Cloudflare mostrando o domínio ativo" width="1303" height="817" data-path="images/docs/64857b3-Domain_Active.png" />
  </Frame>
</Accordion>

***

## Adicionar registros DNS

Complete os passos de [Configuração de email](./email-setup) até ser solicitado a adicionar registros DNS, então retorne aqui ou use o botão **Auto-Configure DNS**.

No dashboard do OneSignal:

* ⚠️ significa que o registro DNS atual não corresponde
* ✅ significa que o registro DNS atual corresponde

Cada registro DNS precisa ser adicionado ao seu provedor de DNS. A exceção é o registro MX — você deve ter registros MX configurados, mas eles podem apontar para um servidor de email diferente (por exemplo, Gmail).

<Frame caption="Copiar registros DNS do OneSignal para seu provedor de DNS">
  <img src="https://mintcdn.com/onesignal/TrjGYudL1B3K9oZG/images/dashboard/dns-manual-configure.png?fit=max&auto=format&n=TrjGYudL1B3K9oZG&q=85&s=826b4fdef6343099bc3063dbf0dc6667" alt="Dashboard do OneSignal mostrando os registros DNS para copiar no seu provedor" width="991" height="760" data-path="images/dashboard/dns-manual-configure.png" />
</Frame>

Na interface do seu provedor de DNS (por exemplo, Cloudflare), vá para **DNS > Records** e adicione cada registro.

### Registros TXT

* **Type:** `TXT`
* **Name:** OneSignal "Hostname"
* **Content:** OneSignal "Value"
* **TTL:** Auto ou o mais baixo

<Warning>
  Se você já tem um registro TXT SPF, não crie um segundo. Adicione diretivas `include:` adicionais ao registro existente:

  `v=spf1 include:spf.onesignal.email include:mailgun.org include:your-other-spf-records ~all`
</Warning>

<Frame caption="Interface de registro DNS TXT no Cloudflare">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/476fea15213effba6c92f335f940246d1fc7d214233e5feee83b9f8a0f6390b2-Screenshot_2024-10-23_at_10.31.55_AM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=73f5e5388f8b6d5f3728aed32f03741a" alt="Interface do Cloudflare para adicionar um registro DNS TXT com campos de hostname e valor" width="2540" height="1062" data-path="images/docs/476fea15213effba6c92f335f940246d1fc7d214233e5feee83b9f8a0f6390b2-Screenshot_2024-10-23_at_10.31.55_AM.png" />
</Frame>

#### SPF (Sender Policy Framework)

Verifica se o IP de envio está autorizado a enviar emails em nome do seu domínio.

#### DMARC

Adiciona aplicação de política para falhas de SPF/DKIM. **DMARC é necessário para envio seguro de email.** Saiba mais: [Diretrizes para remetentes de email](https://support.google.com/mail/answer/81126)

<Warning>
  OneSignal usa o valor `v=DMARC1; p=none;` para o registro DMARC. Se você já tem um registro DMARC, não adicione um duplicado — verifique se o registro existente inclui esta política.
</Warning>

### Registros CNAME

Usados para rastreamento de abertura, clique e cancelamento de assinatura.

* **Type:** `CNAME`
* **Name:** OneSignal "Hostname"
* **Target:** OneSignal "Value"
* **TTL:** Auto ou o mais baixo

<Note>
  Se usar Cloudflare, defina **Proxy** como "DNS only" e **Flattening** como "Off" para registros CNAME. Outros provedores de DNS geralmente não requerem essas configurações.
</Note>

<Frame caption="Interface de registro DNS CNAME no Cloudflare">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2e304d0eeb876a92bd325eeb490a7f8e5a7ba53d381bdc86009143146f7e6405-Screenshot_2024-10-23_at_10.36.52_AM.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=c268cad031c5d52f44cd5fce1e81b105" alt="Interface do Cloudflare para adicionar um registro CNAME com campos de hostname e destino" width="2540" height="1062" data-path="images/docs/2e304d0eeb876a92bd325eeb490a7f8e5a7ba53d381bdc86009143146f7e6405-Screenshot_2024-10-23_at_10.36.52_AM.png" />
</Frame>

#### DKIM (DomainKeys Identified Mail)

Verifica se o conteúdo da mensagem não foi alterado e foi enviado por você. A chave pública está incluída no registro DNS CNAME fornecido pelo OneSignal.

### Registros MX

Recebe respostas de email e rejeições. Mesmo se você estiver apenas enviando, os registros MX ajudam a evitar erros de verificação de domínio.

<Warning>
  Se você já usa outro provedor de email (por exemplo Gmail), não sobrescreva registros MX existentes.
</Warning>

* **Type:** `MX`
* **Name:** OneSignal "Hostname"
* **Mail server:** OneSignal "Value"
* **TTL:** Auto ou o mais baixo
* **Priority:** `10`

<Frame caption="Interface de registro DNS MX no Cloudflare">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/f267f956723811f57b5a7d5db5190619a44c7641699a0bf5b3511f617597ada1-Screenshot_2024-10-23_at_10.50.19_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=538fb5cd52395b619b641eeb23f4a610" alt="Interface do Cloudflare para adicionar um registro MX com campos de servidor de email e prioridade" width="2540" height="884" data-path="images/docs/f267f956723811f57b5a7d5db5190619a44c7641699a0bf5b3511f617597ada1-Screenshot_2024-10-23_at_10.50.19_AM.png" />
</Frame>

***

## Verificação de DNS e solução de problemas

Após adicionar os registros:

1. Retorne ao dashboard do OneSignal.
2. Clique em **Check Records** ou no botão de atualizar.

Registros verificados mostram ✅. Todos os registros devem ser verificados exceto MX, que pode mostrar ⚠️ se apontar para um servidor de email diferente (por exemplo, Google Workspace) — isso é esperado e aceitável.

<Frame caption="Registros DNS verificados no dashboard do OneSignal">
  <img src="https://mintcdn.com/onesignal/2-gyvU4UfJHiycCa/images/dashboard/dns-check-records.png?fit=max&auto=format&n=2-gyvU4UfJHiycCa&q=85&s=74380955130736264e42e26f2ae14a39" alt="Dashboard do OneSignal mostrando registros DNS com marcas de verificação verdes para status verificado" width="2250" height="1290" data-path="images/dashboard/dns-check-records.png" />
</Frame>

<Warning>
  A verificação geralmente leva alguns minutos, mas pode levar até 48 horas.
</Warning>

### Solucionar problemas de propagação DNS

1. Use [whatsmydns.net](https://www.whatsmydns.net/) para verificar a propagação se algum registro estiver pendente.
2. Para registros que mostram ⚠️, copie o hostname do dashboard do OneSignal na barra de pesquisa e defina o tipo DNS.
3. Verifique os resultados — ✅ significa que o registro está verificado globalmente, ❌ significa que ainda não propagou para aquele servidor.

Se o valor mostrado no whatsmydns.net diferir do que o OneSignal fornece, verifique seu provedor de DNS e atualize o registro para corresponder.

<Frame caption="Verificar propagação DNS com whatsmydns.net">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a3011bc8b7477b7a1e18cb16cfd69bba03cc1f19cf623ccddd1926722bfc585c-Screenshot_2024-10-23_at_11.02.59_AM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=6b259000725c32c495332ec81842db00" alt="Resultados do whatsmydns.net mostrando o status de propagação DNS global com indicadores verdes e vermelhos" width="2578" height="1492" data-path="images/docs/a3011bc8b7477b7a1e18cb16cfd69bba03cc1f19cf623ccddd1926722bfc585c-Screenshot_2024-10-23_at_11.02.59_AM.png" />
</Frame>

#### Erros comuns e soluções

* **Registro TXT SPF não verificado**
  * Você provavelmente tem um registro SPF existente. Você deve ter apenas um registro TXT SPF — adicione diretivas `include:` adicionais ao seu valor. Consulte a seção [Registros TXT](#registros-txt) acima.
* **DNS não totalmente propagado**
  * Se [whatsmydns.net](https://www.whatsmydns.net/) mostrar uma mistura de ✅ e ❌, os registros não propagaram completamente. Isso pode levar até 48 horas. Aguarde e verifique novamente, ou contate seu provedor de DNS.
* **Valor DNS não corresponde ao OneSignal**
  * Se os valores no [whatsmydns.net](https://www.whatsmydns.net/) não corresponderem ao que o OneSignal fornece:
    * Registros MX apontando para outro lugar (por exemplo, Google Mail) são esperados — tudo bem desde que mostrem ✅ no whatsmydns.net.
    * Verifique se o hostname está correto. `mail.yourdomain.com` não é o mesmo que `yourdomain.com`.
    * Contate seu provedor de DNS para obter ajuda.

***

## Perguntas frequentes

### Quanto tempo leva a verificação DNS?

A verificação geralmente é concluída em minutos, mas a propagação DNS pode levar até 48 horas dependendo do seu provedor e das configurações de TTL. Use [whatsmydns.net](https://www.whatsmydns.net/) para verificar o progresso.

### E se eu já tiver registros SPF ou DMARC?

Não crie registros duplicados. Para SPF, adicione `include:spf.onesignal.email` do OneSignal ao seu registro TXT SPF existente. Para DMARC, verifique se seu registro existente inclui `v=DMARC1; p=none;` ou uma política mais restritiva.

### Preciso de registros MX se estou apenas enviando emails?

Os registros MX ajudam a evitar erros de verificação de domínio mesmo para configurações somente de envio. Se você já usa um provedor de email como Gmail ou Google Workspace, mantenha seus registros MX existentes — você não precisa substituí-los pelos valores do OneSignal.

***

<Check>
  Retorne a [Configuração de email](./email-setup) para completar a configuração e começar a enviar emails.
</Check>

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Configuração de email" icon="envelope" href="./email-setup">
    Configuração completa do canal de email incluindo seleção de provedor e configuração DNS automática.
  </Card>

  <Card title="Remetentes" icon="paper-plane" href="./senders">
    Gerencie domínios de envio, endereços de resposta e identidades de remetente.
  </Card>

  <Card title="Guia de aquecimento de email" icon="temperature-arrow-up" href="./email-warm-up">
    Aumente gradualmente o volume de email para construir reputação do remetente e melhorar a entregabilidade.
  </Card>

  <Card title="Mensagens de email" icon="envelopes-bulk" href="./email-messaging">
    Crie e envie campanhas de email com modelos, personalização e agendamento.
  </Card>
</Columns>
