Problemas com e-mails

Este documento contém uma explicação dos problemas mais recorrentes de envio de e-mails no Odoo.

E-mails enviados

O e-mail não foi enviado

O primeiro indicador que mostra que um e-mail não foi enviado é a presença de um ícone vermelho ✉️ (envelope), ao lado da data e hora da mensagem, localizado no chatter.

Ícone de envelope vermelho exibido no chatter.

Os e-mails não enviados também aparecem na fila de e-mails do Odoo. Em modo de desenvolvedor, a fila de e-mails pode ser acessada no aplicativo de Definições ‣ Menu técnico ‣ E-mail ‣ E-mails. Os e-mails não enviados aparecem em turquesa, enquanto os e-mails enviados aparecem em cinza.

Mensagens de erro comuns

Limite diário atingido
Aviso no Odoo quando o limite de e-mails é atingido.

Cada provedor de serviços de e-mail tem seus próprios limites de envio de e-mail. Os limites podem ser diários, por hora ou, às vezes, por minuto. Isso é o mesmo para o Odoo, que limita o envio de um cliente para evitar que os servidores de e-mail do Odoo sejam colocados na lista de bloqueio.

Aqui estão os limites padrão para novas bases de dados:

  • 200 e-mails por dia para bases de dados Odoo Online e Odoo.sh com uma assinatura ativa.

  • 20 e-mails por dia para bases de dados gratuitas de um aplicativo.

  • 50 e-mails por dia para bases de dados de teste.

  • No caso de migração, o limite diário pode ser redefinido para 50 e-mails por dia.

Se o limite diário for atingido:

  • Entre em contato com a equipe de suporte da Odoo, que poderá aumentar o limite diário dependendo dos seguintes fatores:

    1. Quantos usuários há na base de dados?

    2. Quais aplicativos estão instalados?

    3. A taxa de devolução: a porcentagem de endereços que não receberam e-mails porque eles foram devolvidos por um servidor de e-mail no caminho para o destinatário final.

  • Use um servidor externo de e-mail de saída para ser independente do limite de e-mail do Odoo (consulte o :doc. correspondente):</applications/general/email_communication/email_servers>`).

  • Aguarde até as 23h (UTC) para que o limite diário seja redefinido e tente enviar o e-mail novamente. No modo de desenvolvedor, acesse o aplicativo de Definições‣ Menu técnico ‣ E-mail ‣ E-mails e, em seguida, clique no botão Tentar novamente ao lado de um e-mail não enviado.

Aviso

O limite diário de e-mails é abrangente para a base de dados. Por padrão, qualquer mensagem interna, notificação, nota registrada etc. conta como um e-mail no limite diário se notificar alguém por e-mail. Isso pode ser mitigado pelo recebimento de notificações no Odoo, em vez de e-mails.

Erro de SMTP

As mensagens de erro do SMTP (Simple Mail Transport Protocol) explicam por que um e-mail não foi transmitido com êxito. SMTP é um protocolo que descreve a estrutura de e-mail e transmite dados de mensagens pela Internet. As mensagens de erro geradas pelos serviços de e-mail são ferramentas úteis para diagnosticar e solucionar problemas de e-mail.

Example

Este é um exemplo de um erro de entrega permanente SMTP 554: 554: erro de entrega: Desculpe, sua mensagem para ------@yahoo.com não pôde ser entregue. Essa caixa de e-mails está desativada (554.30). - mta4471.mail.bf1.yahoo.com --- Abaixo dessa linha uma cópia da mensagem.

O menu de depuração pode ser usado para investigar problemas de envio de SMTP a partir de uma base de dados. Para acessar o menu, o modo de desenvolvedor deve ser ativado. Depois de ativado, navegue até o Menu de depuração no canto superior direito da barra de menus (o ícone 🐞 (inseto)), Menu de depuração ‣ Gerenciar mensagens

O menu Gerenciar mensagens abre uma lista de todas as mensagens enviadas em um determinado registro. Em cada mensagem, há informações sobre o envio, incluindo o tipo e o subtipo da mensagem.

Outras informações incluem para quem a mensagem foi enviada e se o Odoo recebeu uma mensagem de devolução de um servidor de e-mail.

Opção de menu Gerenciar mensagens no menu de depuração.

Nota

Um usuário deve estar em uma visualização no Odoo que tenha um chatter para que a opção de menu Gerenciar mensagens seja exibida.

Nenhum erro preenchido

O Odoo nem sempre é capaz de fornecer informações sobre o motivo da falha. Os diferentes provedores de e-mail implementam uma política personalizada de e-mails devolvidos, e nem sempre é possível para o Odoo interpretá-la corretamente.

Se esse for um problema recorrente com o mesmo cliente ou com o mesmo domínio, não hesite em entrar em contato com o Suporte da Odoo para obter ajuda para encontrar o motivo.

Nota

Um dos motivos mais comuns para a falha no envio de um e-mail sem mensagem de erro está relacionado à configuração de SPF e/ou DKIM. Além disso, verifique se o mail.bounce.alias está definido nos parâmetros do sistema. Acesse os parâmetros do sistema no modo de desenvolvedor acessando o app de Definições ‣ Menu técnico ‣ Parâmetros ‣ Parâmetros do sistema.

O e-mail é enviado com atraso

As campanhas de e-mail são enviadas em um horário programado, usando um atraso pré-programado no banco de dados. O Odoo usa uma tarefa atrasada para enviar e-mails que são considerados “não urgentes” (formatos de boletim informativo, como: mala direta, automação de marketing e eventos). O utilitário de sistema cron pode ser usado para agendar programas a serem executados automaticamente em intervalos predeterminados. O Odoo usa essa política para evitar a sobrecarga dos servidores de e-mail e, em vez disso, prioriza a comunicação individual. Esse cron é chamado Mail: Email Queue Manager, e pode ser acessado em modo de desenvolvedor acessando Aplicativo de configurações ‣ Menu técnico ‣ Automação ‣ Ações agendadas.

E-mail programado para ser enviado mais tarde.

Dica

O que é um cron? Um cron é uma ação que o Odoo executa em segundo plano para executar um código específico para concluir uma tarefa.

Importante

Por padrão, o cron de envio em massa é executado a cada 60 minutos. Isso pode ser alterado para não menos que 5 minutos. No entanto, a execução da ação a cada 5 minutos sobrecarregaria a base de dados do Odoo (estressaria o sistema), portanto, isso não é recomendado. Para editar o cron de envio em massa, selecione a ação agendada :guilabel:`Mail: Email Queue Manager” e faça os ajustes necessários.

Os e-mails considerados urgentes (comunicação de uma pessoa para outra, como pedidos de venda, faturas, pedidos de compra etc.) são enviados imediatamente.

E-mails recebidos

Quando há um problema com os e-mails recebidos, pode não haver uma indicação, por si só, no Odoo. É o cliente de e-mail que envia, que tenta entrar em contato com uma base de dados, que receberá uma mensagem de retorno (na maioria das vezes uma mensagem de erro 550: caixa de entrada indisponível).

O e-mail não foi recebido

As etapas que devem ser executadas dependem da plataforma Odoo em que a base de dados está hospedada.

Os usuários do Odoo.sh podem encontrar seus registros ao vivo na pasta ~/logs/.

Os registros são uma coleção armazenada de todas as tarefas concluídas em uma base de dados. Eles são uma representação somente de texto, completa com registros de data e hora de cada ação realizada na base de dados do Odoo. Isso pode ser útil para rastrear e-mails que saem da base de dados. A falha no envio também pode ser vista por registros que indicam que a mensagem tentou ser enviada repetidamente. Os registros mostrarão cada ação dos servidores de e-mail a partir da base de dados.

A pasta ~/logs/ (acessada pela linha de comando ou no painel do Odoo.sh) de uma base de dados Odoo.sh contém uma lista de arquivos que contêm os logs da base de dados. Os arquivos de registro são criados todos os dias às 5:00 AM (UTC).

Dica

Os dois dias mais recentes (hoje e ontem) não são compactados, enquanto os mais antigos são, para economizar espaço. Os nomes dos arquivos para hoje e ontem são, respectivamente: odoo.log e odoo.log.1.

Para os dias seguintes, eles são nomeados com suas datas e, em seguida, compactados. Use o comando grep e zgrep (para os compactados) para pesquisar os arquivos.

Veja também

Para obter mais informações sobre os registros e como acessá-los por meio do painel Odoo.sh, consulte esta documentação de administração.

Para obter mais informações sobre como acessar os registros por meio da linha de comando, visite esta documentação do desenvolvedor.

Os usuários do Odoo Online não terão acesso aos registros. No entanto, o Suporte da Odoo pode ser contatado se houver um problema recorrente com o mesmo cliente ou domínio.

Obtenha ajuda do suporte da Odoo

Para que possamos ajudar de forma eficiente, forneça o máximo de informações possível. Aqui está uma lista do que pode ser útil ao entrar em contato com a equipe de suporte do Odoo sobre um problema:

  1. Envie uma cópia dos cabeçalhos do e-mail. O arquivo .EML (ou cabeçalhos) do e-mail é o formato de arquivo que contém todas as informações técnicas necessárias para uma investigação. A documentação do provedor de e-mail pode explicar como acessar o arquivo EML/arquivos de cabeçalho. Depois que os cabeçalhos do e-mail forem obtidos, adicioná-los ao chamado de suporte do Odoo é a maneira mais eficiente de a equipe de suporte do Odoo investigar.

  2. Explique o fluxo exato que está sendo seguido para receber normalmente esses e-mails no Odoo. Aqui estão exemplos de perguntas cujas respostas podem ser úteis:

    • Essa é uma mensagem de notificação de uma resposta que está sendo recebida no Odoo?

    • Essa é uma mensagem que está sendo enviada da base de dados do Odoo?

    • Há um servidor de e-mail de entrada sendo usado ou o e-mail está sendo redirecionado de alguma forma?

    • Existe um exemplo de um e-mail que foi encaminhado corretamente?

  3. Forneça respostas para as seguintes perguntas:

    • É um problema genérico ou é específico de um caso de uso? Se for específico de um caso de uso, qual exatamente?

    • Ele está funcionando conforme o esperado? Caso o e-mail seja enviado usando o Odoo, o e-mail de devolução deve chegar à base de dados do Odoo e exibir o envelope vermelho.

Nota

O parâmetro do sistema de rejeição precisa ser definido nas configurações técnicas para que a base de dados receba corretamente as mensagens de rejeição. Para acessar essa configuração, vá para Aplicativo de Definições ‣ Menu técnico ‣ Parâmetros ‣ Parâmetros do sistema. Em seguida, selecione o nome do parâmetro mail.bounce.alias e defina o valor como bounce se ele ainda não estiver definido.