Como depurar problemas de e-mail em tempo real usando os logs do Mailgun

Qualquer profissional de desenvolvimento ou de administração de sistemas que se preze geralmente começará o processo de solução de problemas com uma simples pergunta: “Você verificou os logs?” A depuração de qualquer aplicativo ou serviço de sistema geralmente começa com a análise dos logs para descobrir o que deu errado. A mesma lógica também se aplica aos e-mails.

Os e-mails não desaparecem simplesmente. Os logs sabem para onde eles foram.

Mailgun oferece um registro detalhado que captura cada etapa da jornada de um e-mail, desde o momento do envio até a entrega final (ou sua falha). Esses logs fornecem um registro em tempo real dos eventos e oferecem insights sobre por que um e-mail teve uma devolução, sofreu atraso ou nunca chegou.

Neste artigo, você aprenderá a acessar os logs do Mailgun, identificar as partes principais dos logs e corrigir problemas comuns.

O sistema de registro do Mailgun oferece uma visão geral dos eventos recentes relacionados a e-mails em toda a sua conta, incluindo as subcontas. Por padrão, ele exibe todos os eventos das últimas 24 horas em formato de tabela. É possível se concentrar em até três métricas de eventos específicos simultaneamente e refinar os resultados usando até dez dimensões de filtro, como domínio do destinatário, tipo de evento ou ID da mensagem. Essa granularidade permite o monitoramento e a análise precisos das atividades de e-mail. Os logs também podem ser exportados como arquivos CSV para análise offline ou manutenção de registros.

Para acessar os logs do Mailgun, você precisará de uma conta do Mailgun. Após fazer o login, navegue até Send > Reporting > Logs:

Entender essas métricas é fundamental para compreender o que aconteceu com seus e-mails:

• Aceito: O Mailgun recebeu o e-mail e o colocou na fila de entrega.
• Entregue: O e-mail foi enviado com sucesso e reconhecido pelo servidor de e-mail do destinatário.
• Falha temporária: O Mailgun não conseguiu realizar a entrega do e-mail, mas tentará novamente. Isso geralmente resulta de devoluções temporárias ou problemas no servidor do destinatário.
• Falha permanente: A entrega falhou e o Mailgun não tentará novamente. As causas comuns incluem devoluções definitivas ou endereços em listas de supressão.
• Reclamação: O destinatário marcou o e-mail como spam, e o servidor de e-mail notificou o Mailgun por meio de um loop de feedback.

Este é apenas um subconjunto de algumas das métricas pelas quais você pode filtrar e classificar.

O sistema de filtragem do Mailgun  permite que você ignore as distrações e foque nos eventos de e-mail específicos que importam. Em vez de rolar por uma longa lista de logs, os filtros permitem refinar os resultados com base em critérios como endereço do destinatário, tipo de evento, domínio e ID da mensagem:

Você pode selecionar até três tipos de eventos de uma vez e combiná-los com até dez filtros adicionais para obter resultados mais precisos. Por exemplo, se você quiser investigar por que os e-mails de um determinado cliente não estão sendo entregues, é possível filtrar pelo endereço de e-mail e procurar eventos de “Devolução” (Bounced) ou “Falha” (Failed). Se você estiver analisando o engajamento da campanha, filtrar por eventos de “Abertura” (Opened) ou “Clique” (Clicked) pode fornecer insights sobre as interações dos destinatários.

O uso desses recursos de filtragem facilita o diagnóstico de problemas específicos. Os logs filtrados também podem ser exportados para uma análise mais aprofundada, proporcionando uma visão clara das tendências e de possíveis problemas.

Nesta seção, você verá alguns exemplos práticos e como encontrar e solucionar os tipos de problemas que pode enfrentar durante uma campanha de e-mail real.

Existem muitas causas diferentes para um e-mail não ser entregue. Uma das mais comuns é a devolução definitiva, que ocorre quando um e-mail é enviado a um endereço inválido ou inexistente. Geralmente, isso acontece devido a uma lista de contatos desatualizada ou a erros de digitação no endereço de um destinatário.

Outro problema frequente é a devolução temporária, em que o e-mail é rejeitado temporariamente devido a fatores como uma caixa de entrada cheia ou um problema temporário no servidor do destinatário.

A filtragem de spam é outro motivo comum para falhas de entrega. Se um e-mail for sinalizado como spam pelo servidor de e-mail do destinatário, ele poderá ser totalmente rejeitado ou encaminhado para a pasta de “lixo eletrônico” em vez da caixa de entrada. Isso pode ocorrer devido a uma reputação do remetente ruim, falta de autenticação (SPF, DKIM, ou DMARC falhas), ou devido a um conteúdo de e-mail que aciona os filtros de spam. Além disso, os servidores dos destinatários podem rejeitar os e-mails se o domínio de envio ou o IP estiver em uma lista de bloqueio ou se o volume de e-mails parecer suspeitamente alto em um curto período. Identificar a causa de e-mails não entregues é o primeiro passo para a solução do problema.

Para rastrear e-mails não entregues usando a interface de logs do Mailgun, selecione Bounced (all) e Failed (all) para exibir apenas os e-mails não entregues:

Essa lista incluirá e-mails que podem estar marcados como “Falha temporária” (Temporary failed), e nesse caso o Mailgun tentará reenviar o e-mail posteriormente.

Para identificar a causa raiz, você pode aplicar filtros com base em tipos de eventos (como “Devolução” ou “Falha”) ou até mesmo em endereços específicos de destinatários. Os detalhes do log fornecem contexto adicional, como mensagens de erro SMTP do servidor do destinatário, o que pode indicar se o problema ocorreu devido a falhas de autenticação, filtragem de spam ou endereços inválidos. Por exemplo, um erro 550 5.1.1 significa que o endereço do destinatário não existe, enquanto um erro 451 sugere um problema temporário, como um atraso temporário no lado do destinatário.

A partir daí, você pode determinar por que os e-mails não estão chegando aos destinatários e adotar ações corretivas, como atualizar as listas de contatos, ajustar as configurações de autenticação de e-mail ou melhorar o conteúdo do e-mail para evitar gatilhos de spam excessivamente rígidos.

A devolução ocorre quando uma mensagem é rejeitada pelo servidor de e-mail do destinatário, impedindo a sua entrega.

As devoluções definitivas acontecem quando um e-mail é enviado a um endereço inválido, fechado ou inexistente. São falhas permanentes, e a melhor solução é remover esses endereços da sua lista de contatos para manter uma boa reputação do remetente.

As devoluções temporárias, por outro lado, são provisórias e costumam ser causadas por uma caixa de entrada cheia, problemas no servidor ou greylisting. Em muitos casos, o Mailgun tenta reenviar automaticamente os e-mails que sofreram devoluções temporárias.

Algumas devoluções ocorrem devido à filtragem baseada em reputação, em que o servidor de e-mail do destinatário rejeita o e-mail porque o IP ou o domínio do remetente foi sinalizado por comportamento semelhante a spam. Isso pode ser resolvido com a melhoria da autenticação de e-mail (SPF, DKIM e DMARC), a redução de reclamações de spam e a garantia de que o conteúdo do e-mail cumpra as práticas recomendadas. Além disso, altos volumes de e-mails em um curto período podem acionar limites de taxa, o que causa devoluções temporárias. Nesses casos, o Mailgun vai ajustar automaticamente a taxa de envio dos seus e-mails com base no feedback dos provedores de caixa de correio.

Da mesma forma que antes, você pode usar a interface de logs do Mailgun para filtrar as métricas “Bounced (all)” e “Failed (all)” para exibir apenas os e-mails com problemas.

A maneira mais rápida de identificar por que um e-mail foi devolvido é verificar o código de erro SMTP. Cada registro de e-mail devolvido inclui um código de erro SMTP e uma mensagem do servidor do destinatário que fornece detalhes sobre o problema.

Como mencionamos, um erro 550 5.1.1 significa que o endereço de e-mail não existe, indicando a necessidade de removê-lo da sua lista. Um erro 452 indica que a caixa de correio do destinatário está cheia e, nesse caso, tentar de novo mais tarde pode funcionar.

Algumas mensagens de erro, como 554 5.7.1, sugerem que o e-mail foi bloqueado devido a problemas relacionados a spam. Nesses casos, melhorar a reputação do remetente, garantir a autenticação adequada e evitar táticas excessivamente agressivas de e-mail marketing podem ajudar a reduzir as taxas de devolução.

Muitas dessas devoluções também podem fazer com que o sistema de supressão automatizado do Mailgun entre em ação. Esse sistema foi desenvolvido para proteger a reputação do remetente do domínio a partir do qual você faz o envio. Por exemplo, se um endereço de e-mail específico gerar um registro de devolução no log, ele será adicionado automaticamente a uma lista de supressão que garante que o Mailgun não tente enviar para esse endereço novamente.

Quando estiver executando uma campanha de e-mail, você deve monitorar ativamente os logs de e-mails devolvidos e adotar ações corretivas com base nos códigos de erro. Isso ajuda a manter uma lista de e-mails mais limpa, a aprimorar a entregabilidade e a evitar futuros problemas de rejeição de e-mails.

Os eventos de reclamação ocorrem quando os destinatários marcam uma mensagem como spam ou lixo eletrônico, indicando aos provedores de serviços de e-mail que o conteúdo é indesejado. Essas reclamações são indicadores essenciais da insatisfação dos destinatários e podem causar um impacto significativo na reputação do remetente.

Uma alta taxa de reclamações de spam sugere que seus e-mails não estão atendendo às expectativas dos destinatários, o que leva os provedores de caixa de correio a filtrar mensagens futuras para as pastas de spam ou bloqueá-las completamente. A manutenção de uma taxa de reclamação baixa é importante para garantir uma alta entregabilidade e preservar sua reputação como remetente de confiança.

Na interface de logs do Mailgun, limite os eventos a Complained para ver apenas as mensagens relevantes:

A análise desses logs deve ajudar a identificar padrões específicos, como taxas de reclamação mais altas em campanhas específicas ou em determinadas linhas de assunto. Por exemplo, se uma campanha de e-mail específica apresentar um número elevado de reclamações, isso pode indicar um conteúdo ou uma segmentação desalinhada, o que deve motivar uma revisão e um ajuste na sua estratégia de e-mail.

Você deve revisar esses logs de reclamação de forma proativa e regular, pois isso pode ajudar a aperfeiçoar sua abordagem e a se alinhar melhor com as expectativas dos destinatários. Depois de entender por que os destinatários estão registrando reclamações, você poderá implementar medidas para combatê-las, como opções melhores para cancelar a inscrição ou um conteúdo mais relevante, que o público pretendido deseja ver em sua caixa de entrada.

Além dos logs de reclamações, os provedores de caixa de correio (exceto o Gmail) oferecem loops de feedback (FBLs) que notificam os remetentes quando os destinatários marcam e-mails como spam. O Mailgun registra automaticamente os seus endereços IP para esses FBLs e suprime futuros e-mails para os destinatários que fizeram reclamações, ajudando a proteger a reputação do remetente. Você pode analisar essas reclamações no Painel de Controle do Mailgun ou usando a API de logs e remover os endereços da lista de sinalização, se necessário.

Neste artigo, você aprendeu como acessar, filtrar e entender o seu painel de logs do Mailgun. Essas informações ajudarão você a aprimorar suas campanhas de e-mail, a reduzir falhas de entrega e a melhorar a reputação do remetente. Para ver mais artigos como este, não deixe de se inscrever na nossa newsletter!

Autor: Thinus Swart