{"id":25466,"date":"2026-09-22T13:18:22","date_gmt":"2026-09-22T13:18:22","guid":{"rendered":"https:\/\/www.mailgun.com\/blog\/depurar-problemas-e-mail-logs-mailgun\/"},"modified":"2026-09-22T13:18:22","modified_gmt":"2026-09-22T13:18:22","slug":"depurar-problemas-e-mail-logs-mailgun","status":"publish","type":"blog","link":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/","title":{"rendered":"Como depurar problemas de e-mail em tempo real usando os logs do Mailgun"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Qualquer profissional de desenvolvimento ou de administra\u00e7\u00e3o de sistemas que se preze geralmente come\u00e7ar\u00e1 o processo de solu\u00e7\u00e3o de problemas com uma simples pergunta: &#8220;Voc\u00ea verificou os logs?&#8221; A depura\u00e7\u00e3o de qualquer aplicativo ou servi\u00e7o de sistema geralmente come\u00e7a com a an\u00e1lise dos logs para descobrir o que deu errado. A mesma l\u00f3gica tamb\u00e9m se aplica aos e-mails.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Os e-mails n\u00e3o desaparecem simplesmente. Os logs sabem para onde eles foram.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/www.mailgun.com\/pt\/\">Mailgun<\/a>\u00a0oferece um registro detalhado que captura cada etapa da jornada de um e-mail, desde o momento do envio at\u00e9 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\u00e7\u00e3o, sofreu atraso ou nunca chegou.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Neste artigo, voc\u00ea aprender\u00e1 a acessar os logs do Mailgun, identificar as partes principais dos logs e corrigir problemas comuns.<\/p>\n\n\n\r\n    <nav data-content-type=\"longform\" class=\"toc-block longform-spacings px-5 py-6 px-md-6 px-lg-7 py-md-7 bg-light fs-sm rounded-lg\" aria-labelledby=\"toc-title-5356\"><p class=\"h5 m-0\" id=\"toc-title-5356\">\u00cdndice<\/p><div class=\"d-flex mt-3\"><div class=\"w-auto fw-bold text-accent d-flex me-2\">01<\/div><div class=\"d-flex flex-column\"><a class=\"fw-bold scrollme link-body-color text-accent\" href=\"#como-acessar-os-logs-do-mailgun-para-depurar-problemas\">Como acessar os logs do Mailgun para depurar problemas<\/a><a class=\"scrollme link-body-color\" href=\"#como-acessar-os-logs-e-entender-as-metricas\">Como acessar os logs e entender as m\u00e9tricas<\/a><a class=\"scrollme link-body-color\" href=\"#como-usar-os-filtros\">Como usar os filtros<\/a><\/div><\/div><div class=\"d-flex mt-3\"><div class=\"w-auto fw-bold text-accent d-flex me-2\">02<\/div><div class=\"d-flex flex-column\"><a class=\"fw-bold scrollme link-body-color text-accent\" href=\"#cenarios-da-vida-real-e-como-depura-los\">Cen\u00e1rios da vida real e como depur\u00e1-los<\/a><a class=\"scrollme link-body-color\" href=\"#como-rastrear-e-mails-nao-entregues\">Como rastrear e-mails n\u00e3o entregues<\/a><a class=\"scrollme link-body-color\" href=\"#como-resolver-devolucoes-de-e-mails\">Como resolver devolu\u00e7\u00f5es de e-mails<\/a><a class=\"scrollme link-body-color\" href=\"#observe-o-codigo-de-erro-smtp\">Observe o c\u00f3digo de erro SMTP<\/a><a class=\"scrollme link-body-color\" href=\"#eventos-de-reclamacao\">Eventos de reclama\u00e7\u00e3o<\/a><\/div><\/div><div class=\"d-flex mt-3\"><div class=\"w-auto fw-bold text-accent d-flex me-2\">03<\/div><div class=\"d-flex flex-column\"><a class=\"fw-bold scrollme link-body-color text-accent\" href=\"#conclusao\">Conclus\u00e3o<\/a><\/div><\/div><\/nav>\n\n\n<h2 class=\"wp-block-heading\">Como acessar os logs do Mailgun para depurar problemas<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O sistema de registro do Mailgun oferece uma vis\u00e3o geral dos eventos recentes relacionados a e-mails em toda a sua conta, incluindo as subcontas. Por padr\u00e3o, ele exibe todos os eventos das \u00faltimas 24 horas em formato de tabela. \u00c9 poss\u00edvel se concentrar em at\u00e9 tr\u00eas m\u00e9tricas de eventos espec\u00edficos simultaneamente e refinar os resultados usando at\u00e9 dez dimens\u00f5es de filtro, como dom\u00ednio do destinat\u00e1rio, tipo de evento ou ID da mensagem. Essa granularidade permite o monitoramento e a an\u00e1lise precisos das atividades de e-mail. Os logs tamb\u00e9m podem ser exportados como arquivos CSV para an\u00e1lise offline ou manuten\u00e7\u00e3o de registros.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Como acessar os logs e entender as m\u00e9tricas<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Para acessar os logs do Mailgun, voc\u00ea precisar\u00e1 de uma\u00a0<a href=\"https:\/\/login.mailgun.com\/login\/\">conta do Mailgun<\/a>. Ap\u00f3s fazer o login, navegue at\u00e9\u00a0<strong>Send &gt; Reporting &gt; Logs<\/strong>:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"761\" src=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.33.11_C3_A2__PM-1024x761.png\" alt=\"Painel do Mailgun com o item de menu Logs em destaque na barra lateral e a p\u00e1gina Logs exibida\" class=\"wp-image-11398\" srcset=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.33.11_C3_A2__PM-1024x761.png 1024w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.33.11_C3_A2__PM-300x223.png 300w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.33.11_C3_A2__PM-768x571.png 768w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.33.11_C3_A2__PM.png 1260w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Entender essas m\u00e9tricas \u00e9 fundamental para compreender o que aconteceu com seus e-mails:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Aceito:<\/strong>\u00a0O Mailgun recebeu o e-mail e o colocou na fila de entrega.<\/li>\n\n\n\n<li><strong>Entregue:<\/strong>\u00a0O e-mail foi enviado com sucesso e reconhecido pelo servidor de e-mail do destinat\u00e1rio.<\/li>\n\n\n\n<li><strong>Falha tempor\u00e1ria:<\/strong>\u00a0O Mailgun n\u00e3o conseguiu realizar a entrega do e-mail, mas tentar\u00e1 novamente. Isso geralmente resulta de devolu\u00e7\u00f5es tempor\u00e1rias ou problemas no servidor do destinat\u00e1rio.<\/li>\n\n\n\n<li><strong>Falha permanente:<\/strong>\u00a0A entrega falhou e o Mailgun n\u00e3o tentar\u00e1 novamente. As causas comuns incluem devolu\u00e7\u00f5es definitivas ou endere\u00e7os em listas de supress\u00e3o.<\/li>\n\n\n\n<li><strong>Reclama\u00e7\u00e3o:<\/strong>\u00a0O destinat\u00e1rio marcou o e-mail como\u00a0<a href=\"https:\/\/www.mailgun.com\/resources\/learn\/glossary\/spam\/\">spam<\/a>, e o servidor de e-mail notificou o Mailgun por meio de um loop de feedback.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Este \u00e9 apenas um subconjunto de\u00a0<a href=\"https:\/\/help.mailgun.com\/hc\/en-us\/articles\/32010244893211-Logs#01GCQY43D682630T9W5ZT8TQHD\">algumas das m\u00e9tricas<\/a>\u00a0pelas quais voc\u00ea pode filtrar e classificar.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Como usar os filtros<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">O\u00a0<a href=\"https:\/\/help.mailgun.com\/hc\/en-us\/articles\/32010244893211-Logs#01GCQY43D60DJG3D05E913SWMQ\">sistema de filtragem do Mailgun<\/a>\u00a0 permite que voc\u00ea ignore as distra\u00e7\u00f5es e foque nos eventos de e-mail espec\u00edficos que importam. Em vez de rolar por uma longa lista de logs, os filtros permitem refinar os resultados com base em crit\u00e9rios como endere\u00e7o do destinat\u00e1rio, tipo de evento, dom\u00ednio e ID da mensagem:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"838\" src=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.36.17_C3_A2__PM-1024x838.png\" alt=\"Interface de filtros com o menu suspenso Selecionar origem aberto e a op\u00e7\u00e3o De em destaque\" class=\"wp-image-11402\" srcset=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.36.17_C3_A2__PM-1024x838.png 1024w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.36.17_C3_A2__PM-300x246.png 300w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.36.17_C3_A2__PM-768x629.png 768w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.36.17_C3_A2__PM.png 1256w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Voc\u00ea pode selecionar at\u00e9 tr\u00eas tipos de eventos de uma vez e combin\u00e1-los com at\u00e9 dez filtros adicionais para obter resultados mais precisos. Por exemplo, se voc\u00ea quiser investigar por que os e-mails de um determinado cliente n\u00e3o est\u00e3o sendo entregues, \u00e9 poss\u00edvel filtrar pelo endere\u00e7o de e-mail e procurar eventos de \u201cDevolu\u00e7\u00e3o\u201d (Bounced) ou \u201cFalha\u201d (Failed). Se voc\u00ea estiver analisando o engajamento da campanha, filtrar por eventos de \u201cAbertura\u201d (Opened) ou \u201cClique\u201d (Clicked) pode fornecer insights sobre as intera\u00e7\u00f5es dos destinat\u00e1rios.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O uso desses recursos de filtragem facilita o diagn\u00f3stico de problemas espec\u00edficos. Os logs filtrados tamb\u00e9m podem ser exportados para uma an\u00e1lise mais aprofundada, proporcionando uma vis\u00e3o clara das tend\u00eancias e de poss\u00edveis problemas.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Cen\u00e1rios da vida real e como depur\u00e1-los<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Nesta se\u00e7\u00e3o, voc\u00ea ver\u00e1 alguns exemplos pr\u00e1ticos e como encontrar e solucionar os tipos de problemas que pode enfrentar durante uma campanha de e-mail real.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Como rastrear e-mails n\u00e3o entregues<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Existem muitas causas diferentes para um e-mail n\u00e3o ser entregue. Uma das mais comuns \u00e9 a devolu\u00e7\u00e3o definitiva, que ocorre quando um e-mail \u00e9 enviado a um endere\u00e7o inv\u00e1lido ou inexistente. Geralmente, isso acontece devido a uma lista de contatos desatualizada ou a erros de digita\u00e7\u00e3o no endere\u00e7o de um destinat\u00e1rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Outro problema frequente \u00e9 a devolu\u00e7\u00e3o tempor\u00e1ria, em que o e-mail \u00e9 rejeitado temporariamente devido a fatores como uma caixa de entrada cheia ou um problema tempor\u00e1rio no servidor do destinat\u00e1rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A filtragem de spam \u00e9 outro motivo comum para falhas de entrega. Se um e-mail for sinalizado como spam pelo servidor de e-mail do destinat\u00e1rio, ele poder\u00e1 ser totalmente rejeitado ou encaminhado para a pasta de \u201clixo eletr\u00f4nico\u201d em vez da caixa de entrada. Isso pode ocorrer devido a uma reputa\u00e7\u00e3o do remetente ruim, falta de autentica\u00e7\u00e3o (<a href=\"https:\/\/www.mailgun.com\/resources\/learn\/glossary\/spf\/\">SPF<\/a>,\u00a0<a href=\"https:\/\/www.mailgun.com\/resources\/learn\/glossary\/dkim\/\">DKIM<\/a>, ou\u00a0<a href=\"https:\/\/www.mailgun.com\/resources\/learn\/glossary\/dmarc\/\">DMARC<\/a>\u00a0falhas), ou devido a um conte\u00fado de e-mail que aciona os filtros de spam. Al\u00e9m disso, os servidores dos destinat\u00e1rios podem rejeitar os e-mails se o dom\u00ednio 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\u00edodo. Identificar a causa de e-mails n\u00e3o entregues \u00e9 o primeiro passo para a solu\u00e7\u00e3o do problema.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para rastrear e-mails n\u00e3o entregues usando a interface de logs do Mailgun, selecione\u00a0<strong>Bounced (all)<\/strong>\u00a0e\u00a0<strong>Failed (all)<\/strong>\u00a0para exibir apenas os e-mails n\u00e3o entregues:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"784\" height=\"1024\" src=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.39.21_C3_A2__PM-784x1024.png\" alt=\"Menu de eventos de m\u00e9tricas com as caixas de sele\u00e7\u00e3o Devolvido (todos) e Falhou (todos) selecionadas na se\u00e7\u00e3o Eventos com falha\" class=\"wp-image-11406\" srcset=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.39.21_C3_A2__PM-784x1024.png 784w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.39.21_C3_A2__PM-230x300.png 230w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.39.21_C3_A2__PM-768x1003.png 768w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.39.21_C3_A2__PM-1176x1536.png 1176w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.39.21_C3_A2__PM.png 1184w\" sizes=\"(max-width: 784px) 100vw, 784px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Essa lista incluir\u00e1 e-mails que podem estar marcados como \u201cFalha tempor\u00e1ria\u201d (Temporary failed), e nesse caso o Mailgun tentar\u00e1 reenviar o e-mail posteriormente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para identificar a causa raiz, voc\u00ea pode aplicar filtros com base em tipos de eventos (como \u201cDevolu\u00e7\u00e3o\u201d ou \u201cFalha\u201d) ou at\u00e9 mesmo em endere\u00e7os espec\u00edficos de destinat\u00e1rios. Os detalhes do log fornecem contexto adicional, como mensagens de erro SMTP do servidor do destinat\u00e1rio, o que pode indicar se o problema ocorreu devido a falhas de autentica\u00e7\u00e3o, filtragem de spam ou endere\u00e7os inv\u00e1lidos. Por exemplo, um erro 550 5.1.1 significa que o endere\u00e7o do destinat\u00e1rio n\u00e3o existe, enquanto um erro 451 sugere um problema tempor\u00e1rio, como um atraso tempor\u00e1rio no lado do destinat\u00e1rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A partir da\u00ed, voc\u00ea pode determinar por que os e-mails n\u00e3o est\u00e3o chegando aos destinat\u00e1rios e adotar a\u00e7\u00f5es corretivas, como atualizar as listas de contatos, ajustar as configura\u00e7\u00f5es de autentica\u00e7\u00e3o de e-mail ou melhorar o conte\u00fado do e-mail para evitar gatilhos de spam excessivamente r\u00edgidos.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Como resolver devolu\u00e7\u00f5es de e-mails<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A devolu\u00e7\u00e3o ocorre quando uma mensagem \u00e9 rejeitada pelo servidor de e-mail do destinat\u00e1rio, impedindo a sua entrega.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">As devolu\u00e7\u00f5es definitivas acontecem quando um e-mail \u00e9 enviado a um endere\u00e7o inv\u00e1lido, fechado ou inexistente. S\u00e3o falhas permanentes, e a melhor solu\u00e7\u00e3o \u00e9 remover esses endere\u00e7os da sua lista de contatos para manter uma boa reputa\u00e7\u00e3o do remetente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">As devolu\u00e7\u00f5es tempor\u00e1rias, por outro lado, s\u00e3o provis\u00f3rias e costumam ser causadas por uma caixa de entrada cheia, problemas no servidor ou\u00a0<a href=\"https:\/\/www.mail.com\/blog\/posts\/what-is-greylisting\/33\/\">greylisting<\/a>. Em muitos casos, o Mailgun tenta reenviar automaticamente os e-mails que sofreram devolu\u00e7\u00f5es tempor\u00e1rias.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Algumas devolu\u00e7\u00f5es ocorrem devido \u00e0 filtragem baseada em reputa\u00e7\u00e3o, em que o servidor de e-mail do destinat\u00e1rio rejeita o e-mail porque o IP ou o dom\u00ednio do remetente foi sinalizado por comportamento semelhante a spam. Isso pode ser resolvido com a melhoria da autentica\u00e7\u00e3o de e-mail (SPF, DKIM e DMARC), a redu\u00e7\u00e3o de reclama\u00e7\u00f5es de spam e a garantia de que o conte\u00fado do e-mail cumpra as pr\u00e1ticas recomendadas. Al\u00e9m disso, altos volumes de e-mails em um curto per\u00edodo podem acionar limites de taxa, o que causa devolu\u00e7\u00f5es tempor\u00e1rias. Nesses casos, o Mailgun vai\u00a0<a href=\"https:\/\/help.mailgun.com\/hc\/en-us\/articles\/203306850-Why-does-the-amount-of-email-I-send-matter\">ajustar automaticamente a taxa<\/a>\u00a0de envio dos seus e-mails com base no feedback dos provedores de caixa de correio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Da mesma forma que antes, voc\u00ea pode usar a interface de logs do Mailgun para filtrar as m\u00e9tricas \u201cBounced (all)\u201d e \u201cFailed (all)\u201d para exibir apenas os e-mails com problemas.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Observe o c\u00f3digo de erro SMTP<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A maneira mais r\u00e1pida de identificar por que um e-mail foi devolvido \u00e9 verificar o c\u00f3digo de erro SMTP. Cada registro de e-mail devolvido inclui um\u00a0<a href=\"https:\/\/en.wikipedia.org\/wiki\/List_of_SMTP_server_return_codes\">c\u00f3digo de erro SMTP<\/a>\u00a0e uma mensagem do servidor do destinat\u00e1rio que fornece detalhes sobre o problema.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Como mencionamos, um erro 550 5.1.1 significa que o endere\u00e7o de e-mail n\u00e3o existe, indicando a necessidade de remov\u00ea-lo da sua lista. Um erro 452 indica que a caixa de correio do destinat\u00e1rio est\u00e1 cheia e, nesse caso, tentar de novo mais tarde pode funcionar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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\u00e7\u00e3o do remetente, garantir a autentica\u00e7\u00e3o adequada e evitar t\u00e1ticas excessivamente agressivas de e-mail marketing podem ajudar a reduzir as taxas de devolu\u00e7\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Muitas dessas devolu\u00e7\u00f5es tamb\u00e9m podem fazer com que o\u00a0<a href=\"https:\/\/help.mailgun.com\/hc\/en-us\/articles\/360012287493-Suppressions-Bounces-Complaints-Unsubscribes-Whitelists\">sistema de supress\u00e3o automatizado do Mailgun<\/a>\u00a0entre em a\u00e7\u00e3o. Esse sistema foi desenvolvido para proteger a reputa\u00e7\u00e3o do remetente do dom\u00ednio a partir do qual voc\u00ea faz o envio. Por exemplo, se um endere\u00e7o de e-mail espec\u00edfico gerar um registro de devolu\u00e7\u00e3o no log, ele ser\u00e1 adicionado automaticamente a uma lista de supress\u00e3o que garante que o Mailgun n\u00e3o tente enviar para esse endere\u00e7o novamente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Quando estiver executando uma campanha de e-mail, voc\u00ea deve monitorar ativamente os logs de e-mails devolvidos e adotar a\u00e7\u00f5es corretivas com base nos c\u00f3digos de erro. Isso ajuda a manter uma lista de e-mails mais limpa, a aprimorar a entregabilidade e a evitar futuros problemas de rejei\u00e7\u00e3o de e-mails.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Eventos de reclama\u00e7\u00e3o<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Os eventos de reclama\u00e7\u00e3o ocorrem quando os destinat\u00e1rios marcam uma mensagem como spam ou lixo eletr\u00f4nico, indicando aos provedores de servi\u00e7os de e-mail que o conte\u00fado \u00e9 indesejado. Essas reclama\u00e7\u00f5es s\u00e3o indicadores essenciais da insatisfa\u00e7\u00e3o dos destinat\u00e1rios e podem causar um impacto significativo na reputa\u00e7\u00e3o do remetente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Uma alta taxa de reclama\u00e7\u00f5es de spam sugere que seus e-mails n\u00e3o est\u00e3o atendendo \u00e0s expectativas dos destinat\u00e1rios, o que leva os provedores de caixa de correio a filtrar mensagens futuras para as pastas de spam ou bloque\u00e1-las completamente. A manuten\u00e7\u00e3o de uma taxa de reclama\u00e7\u00e3o baixa \u00e9 importante para garantir uma alta entregabilidade e preservar sua reputa\u00e7\u00e3o como remetente de confian\u00e7a.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Na interface de logs do Mailgun, limite os eventos a\u00a0<strong>Complained<\/strong>\u00a0para ver apenas as mensagens relevantes:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"990\" height=\"1024\" src=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.43.27_C3_A2__PM-990x1024.png\" alt=\"Caixa de sele\u00e7\u00e3o Reclamou selecionada em Eventos de engajamento, destacada por uma caixa vermelha\" class=\"wp-image-11410\" srcset=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.43.27_C3_A2__PM-990x1024.png 990w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.43.27_C3_A2__PM-290x300.png 290w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.43.27_C3_A2__PM-768x795.png 768w, https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/08\/Screenshot_2025-07-11_at_2.43.27_C3_A2__PM.png 1158w\" sizes=\"(max-width: 990px) 100vw, 990px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">A an\u00e1lise desses logs deve ajudar a identificar padr\u00f5es espec\u00edficos, como taxas de reclama\u00e7\u00e3o mais altas em campanhas espec\u00edficas ou em determinadas linhas de assunto. Por exemplo, se uma campanha de e-mail espec\u00edfica apresentar um n\u00famero elevado de reclama\u00e7\u00f5es, isso pode indicar um conte\u00fado ou uma segmenta\u00e7\u00e3o desalinhada, o que deve motivar uma revis\u00e3o e um ajuste na sua estrat\u00e9gia de e-mail.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Voc\u00ea deve revisar esses logs de reclama\u00e7\u00e3o de forma proativa e regular, pois isso pode ajudar a aperfei\u00e7oar sua abordagem e a se alinhar melhor com as expectativas dos destinat\u00e1rios. Depois de entender por que os destinat\u00e1rios est\u00e3o registrando reclama\u00e7\u00f5es, voc\u00ea poder\u00e1 implementar medidas para combat\u00ea-las, como op\u00e7\u00f5es melhores para cancelar a inscri\u00e7\u00e3o ou um conte\u00fado mais relevante, que o p\u00fablico pretendido deseja ver em sua caixa de entrada.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Al\u00e9m dos logs de reclama\u00e7\u00f5es, os provedores de caixa de correio (exceto o Gmail) oferecem\u00a0<a href=\"https:\/\/documentation.mailgun.com\/docs\/mailgun\/email-best-practices\/feedbackloops\/\">loops de feedback<\/a>\u00a0(FBLs) que notificam os remetentes quando os destinat\u00e1rios marcam e-mails como spam. O Mailgun registra automaticamente os seus endere\u00e7os IP para esses FBLs e suprime futuros e-mails para os destinat\u00e1rios que fizeram reclama\u00e7\u00f5es, ajudando a proteger a reputa\u00e7\u00e3o do remetente. Voc\u00ea pode analisar essas reclama\u00e7\u00f5es no Painel de Controle do Mailgun ou usando a\u00a0<a href=\"https:\/\/documentation.mailgun.com\/docs\/mailgun\/api-reference\/openapi-final\/tag\/Logs\/\">API de logs<\/a>\u00a0e remover os endere\u00e7os da lista de sinaliza\u00e7\u00e3o, se necess\u00e1rio.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Conclus\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Neste artigo, voc\u00ea aprendeu como acessar, filtrar e entender o seu painel de logs do Mailgun. Essas informa\u00e7\u00f5es ajudar\u00e3o voc\u00ea a aprimorar suas campanhas de e-mail, a reduzir falhas de entrega e a melhorar a reputa\u00e7\u00e3o do remetente. Para ver mais artigos como este, n\u00e3o deixe de se inscrever na nossa newsletter!<\/p>\n\n\n\r\n    <aside data-content-type=\"longform\"  class=\"banner-block longform-spacings rounded-lg shadow-lg px-5 py-6 px-md-6 py-md-7 p-lg-7 bg-light\" data-theme=\"dark\" aria-labelledby=\"banner-block-block_61e652ecf267f45923c124f7484fbf79\">\r\n                    <p class=\"text-uppercase section-caption text-body-color\">\r\n                Inscreva-se            <\/p>\r\n                            <p class=\"h4 text-accent fw-bold\" id=\"banner-block-block_61e652ecf267f45923c124f7484fbf79\">\r\n                \u00c9 f\u00e1cil come\u00e7ar. E \u00e9 gr\u00e1tis.            <\/p>\r\n                            <div class=\"mb-0 text-body-color\">\r\n                                    <div class=\"content-body mb-0 text-body-color\"><p>Veja o que voc\u00ea pode alcan\u00e7ar com a melhor plataforma de entrega de e-mail do mundo.<\/p><\/div>\r\n                            <\/div>\r\n        \r\n        <div class=\"text-start mt-5\"><a href=\"https:\/\/signup.mailgun.com\/new\/signup\" target=\"_blank\" class=\"btn btn-secondary\" >Get Started<\/a><\/div>\r\n    <\/aside>\r\n\r\n","protected":false},"excerpt":{"rendered":"<p>Quando o seu e-mail n\u00e3o chega aonde deveria, os logs t\u00eam as respostas. Este post mostra como usar os logs do Mailgun para descobrir falhas de entrega, reclama\u00e7\u00f5es de spam e muito mais, para que voc\u00ea possa agir rapidamente e manter a reputa\u00e7\u00e3o do remetente intacta.<\/p>\n","protected":false},"author":92,"featured_media":4376,"menu_order":0,"template":"","meta":{"_acf_changed":false,"footnotes":""},"blog_category":[21],"class_list":["post-25466","blog","type-blog","status-publish","has-post-thumbnail","hentry","blog_category-deliverability"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Como depurar problemas de e-mail em tempo real com os logs do Mailgun | Mailgun<\/title>\n<meta name=\"description\" content=\"Aprenda a usar os logs do Mailgun para solucionar problemas de e-mail em tempo real, descobrir as causas raiz e melhorar a reputa\u00e7\u00e3o do remetente com uma entregabilidade melhor.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/\" \/>\n<meta property=\"og:locale\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Como depurar problemas de e-mail em tempo real com os logs do Mailgun | Mailgun\" \/>\n<meta property=\"og:description\" content=\"Aprenda a usar os logs do Mailgun para solucionar problemas de e-mail em tempo real, descobrir as causas raiz e melhorar a reputa\u00e7\u00e3o do remetente com uma entregabilidade melhor.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/\" \/>\n<meta property=\"og:site_name\" content=\"Transactional Email API Service For Developers | Mailgun\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/07\/MG-Blog-Deliverability.png\" \/>\n\t<meta property=\"og:image:width\" content=\"720\" \/>\n\t<meta property=\"og:image:height\" content=\"448\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"9 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/\",\"url\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/\",\"name\":\"Como depurar problemas de e-mail em tempo real com os logs do Mailgun | Mailgun\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.mailgun.com\\\/wp-content\\\/uploads\\\/2025\\\/07\\\/MG-Blog-Deliverability.png\",\"datePublished\":\"2026-09-22T13:18:22+00:00\",\"description\":\"Aprenda a usar os logs do Mailgun para solucionar problemas de e-mail em tempo real, descobrir as causas raiz e melhorar a reputa\u00e7\u00e3o do remetente com uma entregabilidade melhor.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/#breadcrumb\"},\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.mailgun.com\\\/wp-content\\\/uploads\\\/2025\\\/07\\\/MG-Blog-Deliverability.png\",\"contentUrl\":\"https:\\\/\\\/www.mailgun.com\\\/wp-content\\\/uploads\\\/2025\\\/07\\\/MG-Blog-Deliverability.png\",\"width\":720,\"height\":448},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/deliverability\\\/depurar-problemas-e-mail-logs-mailgun\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/inicio\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Blog\",\"item\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Como depurar problemas de e-mail em tempo real usando os logs do Mailgun\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/#website\",\"url\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/\",\"name\":\"Transactional Email API Service For Developers | Mailgun\",\"description\":\"Poderosas APIs de e-mail transacional que permitem a voc\u00ea enviar, receber e rastrear e-mails, criadas com os desenvolvedores em mente. Saiba mais hoje mesmo!\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"pt-BR\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/#organization\",\"name\":\"Transactional Email API Service For Developers | Mailgun\",\"url\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.mailgun.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/cropped-android-chrome-512x512-1.png\",\"contentUrl\":\"https:\\\/\\\/www.mailgun.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/cropped-android-chrome-512x512-1.png\",\"width\":512,\"height\":512,\"caption\":\"Transactional Email API Service For Developers | Mailgun\"},\"image\":{\"@id\":\"https:\\\/\\\/www.mailgun.com\\\/pt\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Como depurar problemas de e-mail em tempo real com os logs do Mailgun | Mailgun","description":"Aprenda a usar os logs do Mailgun para solucionar problemas de e-mail em tempo real, descobrir as causas raiz e melhorar a reputa\u00e7\u00e3o do remetente com uma entregabilidade melhor.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/","og_locale":"pt_BR","og_type":"article","og_title":"Como depurar problemas de e-mail em tempo real com os logs do Mailgun | Mailgun","og_description":"Aprenda a usar os logs do Mailgun para solucionar problemas de e-mail em tempo real, descobrir as causas raiz e melhorar a reputa\u00e7\u00e3o do remetente com uma entregabilidade melhor.","og_url":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/","og_site_name":"Transactional Email API Service For Developers | Mailgun","og_image":[{"width":720,"height":448,"url":"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/07\/MG-Blog-Deliverability.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"9 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/","url":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/","name":"Como depurar problemas de e-mail em tempo real com os logs do Mailgun | Mailgun","isPartOf":{"@id":"https:\/\/www.mailgun.com\/pt\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/#primaryimage"},"image":{"@id":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/#primaryimage"},"thumbnailUrl":"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/07\/MG-Blog-Deliverability.png","datePublished":"2026-09-22T13:18:22+00:00","description":"Aprenda a usar os logs do Mailgun para solucionar problemas de e-mail em tempo real, descobrir as causas raiz e melhorar a reputa\u00e7\u00e3o do remetente com uma entregabilidade melhor.","breadcrumb":{"@id":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/#breadcrumb"},"inLanguage":"pt-BR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/"]}]},{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/#primaryimage","url":"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/07\/MG-Blog-Deliverability.png","contentUrl":"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/07\/MG-Blog-Deliverability.png","width":720,"height":448},{"@type":"BreadcrumbList","@id":"https:\/\/www.mailgun.com\/pt\/blog\/deliverability\/depurar-problemas-e-mail-logs-mailgun\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.mailgun.com\/pt\/inicio\/"},{"@type":"ListItem","position":2,"name":"Blog","item":"https:\/\/www.mailgun.com\/pt\/blog\/"},{"@type":"ListItem","position":3,"name":"Como depurar problemas de e-mail em tempo real usando os logs do Mailgun"}]},{"@type":"WebSite","@id":"https:\/\/www.mailgun.com\/pt\/#website","url":"https:\/\/www.mailgun.com\/pt\/","name":"Transactional Email API Service For Developers | Mailgun","description":"Poderosas APIs de e-mail transacional que permitem a voc\u00ea enviar, receber e rastrear e-mails, criadas com os desenvolvedores em mente. Saiba mais hoje mesmo!","publisher":{"@id":"https:\/\/www.mailgun.com\/pt\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.mailgun.com\/pt\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"pt-BR"},{"@type":"Organization","@id":"https:\/\/www.mailgun.com\/pt\/#organization","name":"Transactional Email API Service For Developers | Mailgun","url":"https:\/\/www.mailgun.com\/pt\/","logo":{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/www.mailgun.com\/pt\/#\/schema\/logo\/image\/","url":"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/06\/cropped-android-chrome-512x512-1.png","contentUrl":"https:\/\/www.mailgun.com\/wp-content\/uploads\/2025\/06\/cropped-android-chrome-512x512-1.png","width":512,"height":512,"caption":"Transactional Email API Service For Developers | Mailgun"},"image":{"@id":"https:\/\/www.mailgun.com\/pt\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/blog\/25466","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/blog"}],"about":[{"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/types\/blog"}],"author":[{"embeddable":true,"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/users\/92"}],"version-history":[{"count":0,"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/blog\/25466\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/media\/4376"}],"wp:attachment":[{"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/media?parent=25466"}],"wp:term":[{"taxonomy":"blog_category","embeddable":true,"href":"https:\/\/www.mailgun.com\/pt\/wp-json\/wp\/v2\/blog_category?post=25466"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}