**Aviso de fim do suporte:** em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para obter mais informações, consulte [Fim do suporte do Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Observação:** APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Solução de problemas do canal de e-mail
<a name="channels-email-troubleshooting"></a>

Verifique se o registro em log está ativado para ajudar a identificar a causa da falha. Para obter mais informações sobre registro em log, consulte [Monitoring and logging](troubleshooting.md#troubleshooting-logging) e [Email events](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-email.html).

## Problemas de renderização
<a name="troubleshooting-email-message-not-displayed"></a>
+ Ao usar um modelo de e-mail, uma falha de renderização ocorre quando as variáveis de mensagens estão ausentes, formatadas incorretamente ou quando há uma incompatibilidade entre as variáveis da mensagem e os dados do endpoint, causando falhas de e-mail durante o envio. 
+ Para identificar falhas de renderização, analise a métrica `RenderingFailure` do Amazon SES CloudWatch durante o período em que a campanha foi veiculada. As falhas de renderização aparecem nos logs de eventos do Amazon Pinpoint como [eventos \$1email.rendering\$1failure](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-email.html#event-streams-data-email-attributes).
+ Para resolver o problema, verifique se todas as variáveis da mensagem têm um atributo de endpoint correspondente e se estão no formato correto. Para obter mais informações, consulte [Adicionar conteúdo personalizado a modelos de mensagem](message-templates-personalizing.md).
+ Configure os valores padrão para todas as variáveis de mensagem no modelo para evitar falhas de renderização quando um atributo estiver ausente para um endpoint.
+ Teste a execução da campanha sem o modelo para confirmar se os endpoints podem receber mensagens com sucesso. Essa ação pode ajudar a confirmar se o problema está relacionado às variáveis do modelo.

## Status de devolução
<a name="troubleshooting-email-message-bounce"></a>

****Solução para devolução flexível****
+ Uma *devolução flexível* ocorre devido a uma falha temporária e aparecerá sob o tipo de evento **\$1email.softbounce** nos logs. O Amazon Pinpoint lida com devoluções flexíveis tentando uma nova entrega dos e-mails devolvidos por um determinado período.
+ Uma devolução flexível pode ocorrer nos seguintes cenários:
  + A caixa de correio do destinatário está cheia.
  + A caixa de correio do destinatário está temporariamente indisponível.
  + Os limites do servidor foram excedidos.
  + O servidor está sobrecarregado.
+ Os códigos de erro específicos relacionados às devoluções flexíveis são 421, 450, 451 ou 452. Para obter as descrições desses códigos de erro, consulte [Registro de códigos de status aprimorados do Simple Mail Transfer Protocol (SMTP)](https://www.iana.org/assignments/smtp-enhanced-status-codes/smtp-enhanced-status-codes.xhtml). O **smtp\$1response** nos logs fornece o código de erro para o evento de devolução.

****Solução para devolução definitiva****
+ Uma *devolução definitiva* é uma falha persistente na entrega que aparece sob o tipo de evento **\$1email.hardbounce** nos logs. Essas falhas não são repetidas.
+ Uma devolução definitiva pode ocorrer nos seguintes cenários:
  + O endereço de e-mail não existe.
  + O nome do domínio não existe.
  + O servidor de e-mail do destinatário bloqueou os e-mails.
  + O endereço de e-mail está na lista de supressão de conta.
+ Monitore o número de devoluções definitivas no projeto e remova os endereços de e-mail de devoluções definitivas das suas listas de destinatários. As devoluções definitivas podem afetar negativamente sua reputação de envio e a capacidade de entrega de sua mensagem de e-mail. Para obter mais informações, consulte as práticas recomendadas em [Devoluções](channels-email-best-practices.md#channels-email-best-practices-bounce-rate).