docs
DocumentationDocs FuncionaisProblemas Comuns

Problemas Comuns

Updated on 11/08/2026 · Odoo 17.0

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 sinal de 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.


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 de tempo atingido
Connection unexpectedly closed: timed out

Em casos em que utiliza-se um servidor de e-mail personalizado, se a conexão com a API do provedor de e-mail atingir o tempo limite de conexão por algum motivo, irá apresentar este erro.

Nestes casos não há uma correção específica, exceto fazer o reenvio dos e-mails afetados. Para isso a fila de e-mails pode ser acessada no aplicativo de Definições ‣ Menu técnico ‣ E-mail ‣ E-mails, em seguida selecione todos os e-mails com falha no envio e cliquem em Tentar Novamente

Estes e-mails entrarão novamente na fila de envio e devem ser enviados na próxima vez que a ação automática de envio de e-mails da fila for executada.

Limite diário 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.
  • 50 e-mails por dia para bases de dados de teste e bases um-app-grátis.

Importante

Em uma base de dados grátis de um aplicativo, se o aplicativo Marketing por e-mail estiver instalado, o limite de e-mails será de 20 e-mails por dia.

Nota

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 [email protected] não pôde ser entregue. Essa caixa de e-mails está desativada (554.30). - mta4471.mail.bf1.yahoo.com --- Abaixo dessa linha há 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, 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)) e selecione Menu de depuração ‣ Gerenciar mensagens no menu suspenso resultante.

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.

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 um 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.


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 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 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.

 


🗂️ Docs Funcionais