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

# Solução de problemas de email

> Como diagnosticar e corrigir problemas comuns de email do OneSignal.

Use este guia para identificar e resolver os problemas mais comuns de email do OneSignal, incluindo problemas de configuração, desafios de entregabilidade e erros de design.

<Note>
  Antes de solucionar problemas, revise nossos guias de [Configuração de Email](./email-setup) e [Entregabilidade de Email](./email-deliverability). Estes cobrem as causas mais comuns de problemas de email.
</Note>

## Problemas de configuração

A maioria dos problemas de configuração vem de registros DNS incorretos ou limitações do seu Provedor de Serviço de Email (ESP).

### Verificar registros DNS

1. Abra seu provedor de DNS.
2. Confirme que os registros SPF, DKIM e MX correspondem ao nosso guia de [Configuração de DNS de Email](./email-dns-configuration).
3. Permita até 24 horas para que as alterações de DNS se propaguem.

<Warning>
  Se os registros DNS estiverem configurados incorretamente, os emails podem falhar ao enviar, ser rejeitados ou marcados como spam.
</Warning>

### Limites de envio mensais (ESPs não-OneSignal)

Se você usa SendGrid, Mailchimp ou Mailgun diretamente (não via Email do OneSignal), seu volume de envio é limitado pelo plano do seu ESP.
Verifique os logs do seu provedor:

* [Feed de Atividade do SendGrid](https://www.twilio.com/docs/sendgrid/ui/analytics-and-reporting/email-activity-feed)
* [Atividade e Relatórios do Mailchimp](https://mailchimp.com/developer/transactional/docs/activity-reports/)
* [Logs do Mailgun](https://www.mailgun.com/products/send/email-analytics/logs/)

### Muitas pesquisas DNS

Ao testar registros SPF com ferramentas como [teste URI](https://www.uriports.com/tools?method=spf\&domain=mail.daystrom-institute.com), você pode ver:

<Frame caption="Muitas pesquisas DNS">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-troubleshooting-too-many-dns-lookups.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=926c451d7d99431a4ed0e8092ff6b014" alt="Muitas pesquisas DNS" width="1127" height="338" data-path="images/email/email-troubleshooting-too-many-dns-lookups.png" />
</Frame>

Isso é esperado se você usar o registro SPF:

```
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
```

O OneSignal usa o Mailgun "por baixo dos panos" como nosso Provedor de Serviço de Email. Isso significa que as pesquisas SPF apontam para os mesmos intervalos de IP e não adicionam realmente nenhuma pesquisa adicional. Para remover o aviso, você pode simplificar para:

```
v=spf1 include:mailgun.org ~all
```

Isso impedirá o erro e não afetará o envio de email do OneSignal.

### Múltiplos registros TXT para domínio de remetente

Você só pode ter **um** registro SPF para seu domínio de envio.
Verifique com [pesquisa TXT do WhatsMyDNS](https://www.whatsmydns.net/#TXT) para confirmar que você não tem várias entradas.

***

## Problemas de entregabilidade

Problemas de entregabilidade incluem envios lentos, colocação na pasta de spam e rejeições de email.

### Emails atrasados

Se seu domínio de envio é novo ou tem baixa reputação, ISPs (Gmail, Outlook, Yahoo) podem atrasar a entrega. Isso é chamado de **limitação de taxa** ou **greylisting**. Ao visualizar seus [Relatórios de Mensagens de Email](./email-message-reports), você pode verificar os detalhes de quanto tempo levou para enviarmos a mensagem.

<Frame caption="Email enviado do OneSignal em menos de 3 segundos">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-speed-message-report.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=ac366a1120913e1ee2204e7ce2baa4ed" alt="Relatório de mensagem de email" width="2186" height="816" data-path="images/email/email-speed-message-report.png" />
</Frame>

Neste exemplo, vemos que o email foi enviado do OneSignal em menos de 3 segundos. Nós o enviamos para o Provedor de Serviço de Email, que então vai para o ISP do destinatário. Esses servidores de email podem atrasar o email até várias horas antes de ser entregue ao destinatário.

<Note>
  Siga nossas [Melhores Práticas de Reputação de Email](./email-reputation-best-practices) para acelerar a entrega.
</Note>

### Emails indo para spam

A causa mais comum é a má reputação do remetente. Siga nosso guia de [Entregabilidade de Email](./email-deliverability).

Se você estiver usando um ESP de terceiros, consulte:

* [SendGrid: Listas de negação](https://docs.sendgrid.com/ui/sending-email/deny-lists)
* [Mailgun: Informações de lista negra](https://help.mailgun.com/hc/en-us/articles/115005365027-What-Is-a-Blacklist-)
* [Mailchimp: Reputação e rejeições](https://mailchimp.com/developer/transactional/docs/reputation-rejections/#rejected-emails)

### Enviar e receber do mesmo domínio

Um único domínio não pode usar os mesmos registros MX para enviar e receber email simultaneamente. Se você deseja **enviar** de `@seudominio.com` e também **receber** no mesmo domínio:

* Mantenha seu DNS de envio com o OneSignal.
* Aponte seus registros MX para seu provedor de email de entrada (por exemplo, [registros MX do Google Workspace](https://support.google.com/a/topic/2683820?hl=en\&ref_topic=9202)).

### Listas de supressão

Se um endereço cancelou a inscrição ou marcou você como spam, seu ESP suprimirá envios para ele.
Para reinscrever:

1. Vá para **Público > Assinaturas** no OneSignal.
2. Pesquise o endereço de email.
3. Clique em **Cancelar Inscrição de Email** (se inscrito) e depois em **Reinscrever no Email**.
4. Envie um email de teste para confirmar.

### Apple Private Relay

Se você enviar para endereços `@privaterelay.appleid.com`, você deve verificar seu domínio de envio em sua [conta de Desenvolvedor Apple](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service/).
Domínios não verificados resultarão em emails descartados.

### Chave de API muito restritiva

Se estiver usando SendGrid ou Mailchimp, certifique-se de que sua chave de API tenha as [permissões mínimas necessárias](./sendgrid-setup#what-are-the-minimum-api-restrictions-i-can-allow).

***

## Design de email

Estes são problemas dentro do próprio conteúdo do email.

### Links não funcionando

Geralmente causado por configuração CNAME ausente ou incorreta.
Se estiver usando um ESP de terceiros, siga a configuração do domínio de rastreamento deles.

### Botões não clicáveis

* Certifique-se de que a URL esteja correta e comece com `https://`.
* Evite testar da sua pasta de spam — alguns clientes de email bloqueiam links lá.

### Adicionar imagens ao pré-cabeçalho

O Gmail suporta imagens promocionais em pré-cabeçalhos (anotações de ofertas, carrosséis de produtos).
Consulte o [Portal do Desenvolvedor do Gmail](https://developers.google.com/gmail/promotab/overview) para configuração.

***

## Provedores de Serviço de Email (ESPs)

Perguntas ou problemas comuns relacionados ao uso de nossas integrações com SendGrid, Mailchimp ou Mailgun.

### Preciso pagar outro provedor para email?

Se você usar a [Configuração de Email do OneSignal](./email-setup), gerenciaremos suas contas de email e você não precisará usar outro provedor de email. Se você planeja usar Sendgrid, Mailchimp ou Mailgun, então precisará continuar pagando seu provedor de serviço de email diretamente.

## Qual é a taxa de transferência de email do OneSignal?

O OneSignal geralmente envia mensagens a uma taxa de 1.000 a 5.000 por segundo para o Provedor de Serviço de Email. Cabe ao seu ESP entregar os emails aos seus usuários.

O OneSignal usa o Mailgun para Email do OneSignal e o Mailgun anuncia que pode suportar até [15 milhões de emails por hora](https://www.mailgun.com/blog/product/how-quickly-can-mailgun-process-my-messages-introducing-the-rapid-fire-throughput-sla/).

***
