Este é um guia de #explicação que discute como os administradores podem solucionar problemas de envio de e-mail a partir de um site Discourse.
Nível de usuário necessário: Administrador
O Discourse depende fortemente de e-mail para notificações aos usuários e tarefas de gerenciamento de contas. Se os usuários não conseguirem receber e-mails do seu site Discourse, isso pode levar a uma variedade de problemas, incluindo notificações perdidas e questões de gerenciamento de contas.
Resumo
Nesta documentação, você aprenderá:
- Como verificar os registros de e-mails enviados
- Como investigar e-mails ignorados e com erro de entrega (bounced)
- Passos comuns de solução de problemas para questões de entregabilidade de e-mail
- Configurações-chave e onde encontrá-las
Verificando E-mails Enviados
O primeiro lugar para verificar ao solucionar problemas de e-mail é a página Admin → E-mails → Enviados do seu site (localizada em .../admin/email/sent). A página E-mails → Enviados no Discourse é um recurso valioso para administradores monitorarem e solucionarem problemas da funcionalidade de e-mail de seu fórum. Esta página fornece um registro detalhado de todos os e-mails que foram enviados com sucesso da sua instância do Discourse.
Aqui está todas as informações que você pode encontrar sobre e-mails enviados nesta página:
- Enviado em: Há quanto tempo o e-mail foi enviado.
- Usuário: O usuário que recebeu o e-mail.
- Para Endereço: O endereço de e-mail do destinatário.
- Tipo de E-mail: O tipo do e-mail que foi enviado. Pode ser um resumo, lista de discussão, postado por usuário, mensagem privada de usuário, etc.
- Chave de Resposta: Um identificador único para cada e-mail enviado. Esta chave garante que, quando um usuário responde a um e-mail de notificação, o Discourse possa corresponder corretamente a resposta ao post e ao usuário apropriados, permitindo que os usuários participem das discussões do fórum diretamente por e-mail.
- Post: O ID do post do qual o e-mail foi gerado. Clicar neste ID levará você ao post real no fórum.
- Detalhes SMTP: Este campo indica a resposta recebida do servidor SMTP após tentar enviar o e-mail. Uma resposta
250 2.0.0significa que o e-mail foi aceito para entrega pelo primeiro servidor de e-mail (o relé de saída).
Se um usuário relatar que não recebeu um e-mail do Discourse, e o Discourse mostrar uma mensagem de
250 2.0.0 Ok: queued as ...sob seusPost & Detalhes SMTP, você pode querer pedir que o usuário verifique novamente sua caixa de entrada, juntamente com sua pasta de spam, para ver se ele pode ter perdido os e-mails. Este status indica que o e-mail foi aceito pelo primeiro servidor de correio, mas não garante a entrega à caixa de entrada final. O e-mail ainda pode ser filtrado, atrasado ou descartado por servidores subsequentes.Você também pode recomendar que o usuário entre em contato com a equipe de suporte ou departamento de TI que gerencia seu servidor de e-mail para ver se eles estão cientes de algo que possa estar acontecendo com o e-mail após ser relatado como enfileirado. Se você tiver acesso aos registros do seu servidor de e-mail de saída (ou se estiver na infraestrutura hospedada pelo Discourse), você pode usar o ID da fila mostrado nos Detalhes SMTP para rastrear a jornada do e-mail através da cadeia de entrega.
Se um e-mail não aparecer na página E-mails → Enviados no Discourse, isso significa que o e-mail não foi enviado com sucesso da sua instância do Discourse.
Vamos dar uma olhada em algumas das outras páginas que podemos usar para solução de problemas de e-mail.
Investigando E-mails Ignorados
Localizada na página .../admin/email/skipped do seu site, a página E-mails Ignorados lista todos os e-mails que o Discourse decidiu não enviar por vários motivos. Cada e-mail ignorado terá um Motivo de Ignorar listado ao lado, fornecendo insights sobre por que o e-mail não foi enviado.
As seguintes informações estão disponíveis nesta página sobre e-mails ignorados:
- Hora: A data e hora em que o e-mail deveria ter sido enviado e foi, em vez disso, ignorado.
- Usuário: O usuário que deveria ter recebido o e-mail.
- Para Endereço: O endereço de e-mail do destinatário.
- Tipo de E-mail: O tipo do e-mail que foi ignorado, como
resumo,lista de discussão,postado por usuário,mensagem privada de usuário, etc. - Motivo de Ignorar: O motivo pelo qual o e-mail foi ignorado. Motivos comuns incluem o usuário estar ativo no site, o usuário já ter lido um post, ou o usuário ter excedido o limite de pontuação de erro de entrega (bounce score).
Exceeded bounce_score_threshold?
No Discourse, cada vez que um e-mail enviado para o endereço de e-mail de um usuário retorna com erro (bounces), a ‘pontuação de erro’ (bounce score) do usuário aumenta. A ‘pontuação de erro’ é uma medida do número de tentativas de entrega falhas para e-mails enviados para um endereço específico.
A mensagem Exceeded bounce_score_threshold no Discourse refere-se à situação em que a ‘pontuação de erro’ de um usuário excede um certo limite, e é uma das razões mais comuns pelas quais você precisaria solucionar problemas de envio de e-mail do Discourse.
Um e-mail com erro de entrega é um e-mail que não pôde ser entregue ao destinatário e é devolvido ao remetente. Isso pode acontecer por uma variedade de razões, e quando isso ocorre, o sistema de e-mail do remetente recebe uma notificação sobre o problema de entrega.
Existem dois tipos de erro de entrega de e-mail:
- Erro Rígido (Hard Bounce): Esta é uma falha permanente de entrega. Geralmente acontece quando o endereço de e-mail do destinatário é inválido ou não está mais em uso. Outras razões podem ser que o nome de domínio não existe ou o servidor de e-mail do destinatário bloqueou completamente a entrega.
- Erro Suave (Soft Bounce): Esta é uma questão temporária de entrega. Pode ser devido à caixa de correio do destinatário estar cheia, o servidor de e-mail estar temporariamente fora do ar ou sobrecarregado, ou a mensagem de e-mail ser muito grande.
bounce_score_threshold?
Sim! Veja: Configurações do Site de Pontuação de Erro.
No entanto, é importante garantir que quaisquer problemas subjacentes com a entregabilidade de e-mail estejam totalmente resolvidos antes de ajustar as configurações de pontuação de erro.
Com isso em mente, vamos discutir algumas das outras informações que podemos ver sobre e-mails com erro de entrega no Discourse.
Solucionando Problemas de E-mails com Erro de Entrega
A página de e-mails com erro de entrega está localizada em .../admin/email/bounced e fornece uma visão detalhada de todos os e-mails com erro de entrega. Aqui está o que você pode ver nesta página sobre e-mails com erro de entrega:
- Hora: A data e hora em que o e-mail retornou com erro.
- Usuário: O usuário que deveria ter recebido o e-mail.
- Para Endereço: O endereço de e-mail do destinatário.
- Tipo de E-mail: O tipo do e-mail que foi ignorado. Pode ser um resumo, lista de discussão, postado por usuário, mensagem privada de usuário, etc.
Na página Com Erro de Entrega, você pode clicar no ícone (i) para visualizar detalhes adicionais sobre um e-mail com erro de entrega:
A janela Detalhes do E-mail Recebido terá informações detalhadas sobre o e-mail com erro de entrega, e tipicamente a seção Corpo fornecerá uma explicação do motivo pelo qual o e-mail retornou com erro.
Aqui estão algumas razões pelas quais um e-mail do Discourse pode estar retornando com erro:
- Endereço de E-mail Inválido: Se o endereço de e-mail do destinatário for inválido, inexistente ou tiver sido excluído, o e-mail retornará com erro.
- Caixa de Correio Cheia: Se a caixa de correio do destinatário estiver cheia e não puder aceitar novas mensagens, o e-mail retornará com erro.
- Problemas de Servidor: Se o servidor de e-mail do destinatário estiver fora do ar ou temporariamente indisponível, o e-mail retornará com erro. Isso geralmente é um problema temporário.
- Remetente Bloqueado: O servidor de e-mail do destinatário pode ter bloqueado seu endereço de e-mail do Discourse, ou pode permitir apenas e-mails recebidos de domínios específicos, geralmente devido a políticas de segurança de e-mail.
- Filtros de Spam Agressivos: Se o conteúdo do e-mail for marcado como spam pelo servidor de e-mail do destinatário, o e-mail pode retornar com erro.
- Resposta Automática: Alguns sistemas de resposta automática (como respostas de fora do escritório) podem causar um erro suave.
Nesta situação, a melhor opção é que o usuário cujos e-mails estão retornando com erro entre em contato com seu provedor de serviço de e-mail. O provedor de serviço de e-mail pode ser capaz de fornecer insights específicos sobre por que os e-mails estão sendo bloqueados, rejeitados, etc., e pode ser capaz de ajustar as configurações de segurança ou incluir o serviço de e-mail do Discourse na lista de permissões. Eles também podem estar cientes de manutenção em andamento do servidor de e-mail ou outros problemas que estariam causando o retorno de e-mails com erro.
Se o usuário tiver controle sobre seus serviços de e-mail e estiver usando Microsoft Hosted Exchange ou Google Workspace, também temos procedimentos para Contornar o spam para e-mails do seu site hospedado no CDCK no Microsoft Hosted Exchange e Contornar o spam para e-mails do seu site hospedado no Discourse no Google Workspace.
Você precisará Redefinir a Pontuação de Erro do Usuário ou, se o problema estiver afetando vários usuários, você pode Redefinir em Massa as Pontuações de Erro para Todos os Usuários. Uma vez que as pontuações de erro tenham sido redefinidas, o Discourse retomarás as tentativas de entregar e-mails aos usuários que estavam excedendo seu bounce_score_threshold.
Passos Adicionais
A configuração e solução de problemas de e-mail podem ser complexas devido às muitas variáveis envolvidas. Além de verificar a seção Admin → E-mail do seu site para solucionar problemas de e-mail, você também pode querer passar pela nossa Lista de verificação de configuração de entrega de e-mail se ainda estiver tendo dificuldade em determinar por que os e-mails não estão sendo entregues corretamente do seu site Discourse.
Se o seu site Discourse foi configurado recentemente, também temos um guia sobre Solucionando problemas de e-mail em uma nova instalação do Discourse (apenas instalações auto-hospedadas).
Por fim, você pode verificar a página de registros do Discourse navegando para Admin > Logs (.../logs/) e procurando por quaisquer erros que você possa ver relacionados à entregabilidade de e-mail.
