Problemas comuns com e-mail e suas soluções
Esta página lista os problemas mais comuns de envio de e-mails e suas soluções.
Odoo não é um provedor de e-mail
O Odoo não funciona como uma caixa de entrada de e-mail clássica, como Gmail, Outlook, Yahoo, etc.
Embora o Odoo use e-mails como forma de notificar e se comunicar com usuários/clientes, ele não substitui um servidor de e-mail dedicado. Portanto, pode não se comportar da maneira quando comparado a uma caixa de entrada de e-mail tradicional.
As principais diferenças são as seguintes:
By default, once a notification or transactional email (quote, invoice, direct message to a contact) is sent out successfully, the email object is deleted. The email message's content lives in the chatter of the related record. It prevents cluttering the database with multiple copies of the content of the same email (when sent to multiple recipients) if the content is already present in the chatter.
There is no concept of (blind) carbon copy ([B]CC). Odoo uses the concept of followers added to a chatter to automatically decide when and how a contact is notified <email-outbound-notifications> or receives a copy of an email.
Incoming emails are handled by checking if the TO email address is a valid email address in the Odoo database or, in case of a reply email, if there is a reference in the email header that matches a message sent from the Odoo database. All other emails will be bounced and not temporarily parked in a spam or quarantine folder. In other words, any email unrelated to an Odoo database is lost.
Emails de saída
Como alterar do endereço de e-mail da conta de usuário administrador
Quando uma base de dados Odoo é criado, a conta do administrador principal recebe um endereço de e-mail de espaço reservado. Recomenda-se substituir o endereço de e-mail do administrador por um endereço de e-mail válido para evitar problemas de envio de e-mails.
Para fazer isso, na conta de administrador, clique no ícone do usuário, clique em Meu perfil (ou Preferências) e atualize o campo E-mail encontrado na aba Preferências. Use qualquer outro endereço de e-mail ou use seu subdomínio Odoo (ex.: company-name.odoo.com) e admin para a parte local (ex.: admin@company-name.odoo.com).
Falha na entrega
Quando uma mensagem é enviada, um ícone fa-envelope-o (envelope) é exibido no chatter. O ícone fica vermelho quando há falha na entrega para pelo menos um destinatário.
Clique com o botão esquerdo do mouse no envelope para exibir informações sobre a entrega e, se possível, as mensagens de erro relevantes <email-issues-outgoing-delivery-failure-messages>.
Clique em Ver detalhes do erro para obter informações adicionais sobre o motivo da falha, se o Odoo conseguiu processar o erro original ou o e-mail de devolução.
Clique em Enviar e fechar para tentar enviar novamente o e-mail a todos os destinatários ativados (fa-toggle-on) na coluna Tentar novamente. Todos os destinatários desativados (fa-toggle-off) serão ignorados.
Clique em Ignorar tudo para ignorar todos os e-mails com falha no momento e mudar o ícone do envelope de vermelho para branco.
Os e-mails não enviados também aparecem na fila de e-mails do Odoo. Para acessá-la, ative o modo de desenvolvedor <developer-mode> e vá para .
Os e-mails com falha exibem o status Falha na entrega. Clique em Tentar novamente para colocar um e-mail com falha na fila de e-mails novamente. Ele aparecerá com o status Enviando. O e-mail será enviado novamente na próxima vez que a ação agendada para a fila de e-mails for executada.
Opcionalmente, os e-mails em fila podem ser enviados imediatamente clicando em Enviar agora. Clique em Cancelar e-mail para removê-lo da fila de e-mails.
Mensagens de erro comuns
Limite diário atingido
O Odoo limita o número de e-mails que podem ser enviados de uma base de dados do Odoo Online. A maioria dos provedores de serviços de e-mail (ex.: Google, Yahoo, etc.) colocará o IP do servidor do Odoo na lista de bloqueio se o servidor de e-mail do Odoo estiver enviando muitos e-mails para endereços que não existem ou que não são mais válidos. Isso também se aplica a e-mails de spam não solicitados enviados por uma base de dados do Odoo.
O limite padrão diário de e-mails varia entre 5 e 200 e-mails. O limite exato depende de vários fatores (sujeito a alterações):
Type of database subscription (one app free, trial, paying subscription)
Apps installed (i.e., Email Marketing, Marketing Automation)
If a database migration is ongoing
Se o limite diário for atingido, você poderá:
Contact Odoo Support <email-issues-support> to increase your email quota. The following factors will be taken into account:
Numbers of users on the database
Apps installed
Bounce rate (the percentage of email addresses that did not receive emails because they were returned by an email server on their way to the final recipient).
Whether your email aliases are correctly set up and use the appropriate custom domains <email-outbound-alias-domain>.
Ao usar um domínio personalizado, verifique se SPF <email-domain-spf>, DKIM <email-domain-dkim> e DMARC <email-domain-dmarc> estão configurados corretamente para que os servidores de e-mail do Odoo possam enviar e-mails em nome do seu domínio personalizado <email-outbound-custom-domain-odoo-server>.
Use an external outgoing email server to be independent of Odoo's email limit.
Wait until the next day, and retry sending the email. To do so, activate the developer mode <developer-mode>, go to , and click Retry next to the unsent email.
Erro de SMTP
O Simple Mail Transport Protocol (SMTP) é um padrão usado para transmitir e-mails entre servidores e/ou clientes de e-mail.
Se você usar um servidor STMP externo para enviar e-mails<email-outbound-custom-domain-smtp-server>, existe um conjunto padrão de códigos de erro SMTP. Embora os números de código não sejam específicos do Odoo, o conteúdo exato da mensagem de erro pode variar conforme o servidor de e-mail.
A mensagem de erro indica que você tentou enviar um e-mail de um endereço de e-mail não verificado. Averiguar a configuração do servidor de envio de e-mail ou o endereço DE padrão da sua base de dados é um bom ponto de partida para solucionar o problema e verificar se você colocou o endereço de e-mail na lista de permissões do sendgrid.com.
Normalmente, a inserção do conteúdo da mensagem de erro em uma pesquisa no Google pode fornecer informações sobre a causa raiz e como corrigir o problema.
Se o problema não puder ser resolvido e continuar ocorrendo, entre em contato com o suporte da Odoo <email-issues-support>.
Nenhum erro preenchido
O Odoo nem sempre é capaz de fornecer informações sobre o motivo da falha na entrega. Os diferentes provedores de e-mail implementam sua própria política sobre e-mails devolvidos, e nem sempre é possível que o Odoo a interprete corretamente.
Se houver um problema recorrente com o mesmo cliente ou o mesmo domínio, entre em contato com o suporte da Odoo <email-issues-support>.
Tempo de execução
A hora exata em que um e-mail é enviado é tratada por um utilitário do sistema cron (ação programada) que pode ser usado para programar tarefas executadas automaticamente em intervalos predeterminados. O Odoo usa essa abordagem para enviar e-mails que são considerados "não urgentes" (ou seja, formatos de newsletter como distribuições em massa, automação de marketing e eventos). Isso evita a sobrecarga dos servidores de e-mail e, em vez disso, prioriza a comunicação individual.
Um cron é uma ação que o Odoo executa em segundo plano para executar um código específico para concluir uma tarefa. O Odoo também cria acionadores cron em determinados fluxos de trabalho que podem acionar uma ação programada antes da data especificada. Geralmente, não é recomendável executar uma ação programada manualmente ou alterar sua frequência, pois isso pode criar erros ou interromper fluxos de trabalho específicos.
Por padrão, para a fila de e-mail normal, o :guilabel:`E-mail: Gerenciador de filas de e-mail" é executado a cada 60 minutos. O menor intervalo de execução para um cron é de 5 minutos. A Odoo recomenda um intervalo de 15 minutos para garantir a operação adequada. Se o intervalo for muito curto, nem todos os e-mails poderão ser processados, o que pode fazer com que o cron atinja o tempo limite.
Os e-mails considerados urgentes (de uma pessoa para outra, como pedidos de venda, faturas, pedidos de compra etc.) são enviados imediatamente. Eles não são exibidos em , a menos que sua entrega falhe.
As campanhas de e-mail são enviadas assim que possível (ao clicar no botão Enviar) ou em um horário programado (ao clicar no botão Agendar).
Para a fila de marketing por e-mail, o Marketing por e-mail: Fila de processos cron é executado uma vez por dia, mas será ativado automaticamente mais cedo se uma campanha for agendada fora dessa frequência padrão. Se uma lista de e-mails contiver um grande número de destinatários, não é recomendável acionar o cron manualmente várias vezes, pois isso não acelerará o tempo de processamento e poderá gerar erros.
Para obter mais informações sobre os crons ao usar o Odoo.sh, consulte Perguntas técnicas frequentes sobre o Odoo.sh.
Campanhas de marketing por e-mail presas na fila
Se várias campanhas de marketing por e-mail forem colocadas na fila, elas serão processadas em ordem cronológica com base na data de criação.
O cron tentará processar a Campanha_1, depois a Campanha_2 e, finalmente, a Campanha_3. Ele não iniciará o processamento da Campanha_2 até que termine o processamento da Campanha_1.
Se uma campanha de e-mail nunca sair da fila, pode haver um problema com a campanha no topo da fila. Para solucionar o problema, podemos remover a Campanha_1 da fila clicando no botão Cancelar e verificar se as outras duas campanhas são enviadas. Em seguida, podemos tentar corrigir a Campanha_2 ou entrar em contato com o suporte da Odoo <email-issues-support>.
E-mails recebidos
Se ocorrer problema com os e-mails recebidos, pode não haver uma indicação per se no Odoo. É o cliente de e-mail que enviar, que tentar entrar em contato com uma base de dados, que receberá uma mensagem de devolução (na maioria das vezes, uma mensagem de erro 550: caixa de entrada indisponível).
O e-mail não foi recebido
Entre em contato com o suporte da Odoo <email-issues-support> se houver um problema recorrente com o mesmo cliente ou domínio.
Odoo.sh
Você pode usar os logs da base de dados para entender e corrigir problemas. Os logs são uma coleção armazenada de todas as tarefas concluídas em uma base de dados, trazendo uma representação somente de texto, com registros de data e hora de cada ação realizada na base de dados do Odoo. Isso pode ser útil para monitorar e-mails enviados da base de dados. Também é possível visualizar as falhas de envio pelos logs, quando indicam que houve tentativas repetidas de envio da mensagem. Os logs mostram todas as ações de servidores de e-mail da base de dados.
Os logs em tempo real estão localizados na pasta ~/logs/ (acessada pela linha de comando ou no painel Odoo.sh). Os arquivos de logs são criados todos os dias às 5:00 AM (UTC).
Os dois arquivos mais recentes, do dia atual e do anterior, são denominados odoo.log e odoo.log.1.
Os arquivos de log de datas mais antigas são compactados e nomeados usando suas datas. Use os comandos grep e zgrep (para arquivos compactados) para pesquisar os arquivos.
Veja também:Para mais informações sobre logs e como acessá-los através do painel do Odoo.sh, consulte a documentação de logs do Odoo.sh <odoo-sh/branches/tabs/logs>.
Para obter mais informações sobre como acessar os registros por meio da linha de comando, consulte a documentação de logs para desenvolvedores <reference/cmdline/server/logging>.
Informações para o suporte da Odoo
Aqui está uma lista de informações úteis que devem ser incluídas ao entrar em contato com o suporte da Odoo:
An export of the full email from the inbox. These are usually in .eml or .msg file formats containing technical information required for an investigation. The exact process to download the file depends on your third-party email provider.
Ao usar um software de e-mail local (ex.: Thunderbird, Apple Mail, Outlook, etc.) para sincronizar e-mails, geralmente é possível exportar as cópias locais de e-mails como arquivos EML/MSG. Consulte a documentação do software utilizado para obter mais informações.
Se possível, o arquivo EML/MSG deve ser baseado no e-mail original cujo envio está falhando ou causando problemas.
Para e-mails recebidos: se possível, entre em contato com o remetente do e-mail original e solicite uma cópia EML/MSG do e-mail original. Enviar de uma cópia do e-mail original (encaminhado) traz apenas informações parciais relacionadas à solução de problemas.
Para e-mails enviados: forneça o EML/MSG do e-mail ou especifique qual registro na base de dados foi afetado (ex.: número do pedido de vendas, nome do contato, número da fatura) e a data/hora em que o e-mail foi enviado (ex.: e-mail enviado em 10 de janeiro de 2024 às 11h45 CET).
An explanation of the exact flow that is being followed to normally receive those emails in Odoo. Try to answer the following questions:
Is this a notification message from a reply being received in Odoo?
Is this a message being sent from the Odoo database?
Is there an incoming email server being used, or is the email being redirected/forwarded through a custom email server or provider?
Is there an example of an email that has been correctly forwarded?
Have you changed any email-related settings recently? Did it stop working after those changes?
An answer to the following questions:
Is it a generic issue or is it specific to a use case? If specific to a use case, which one?
Is it working as expected? In case the email is sent using Odoo, the bounce email should reach the Odoo database and display the red envelope <email-issues-outgoing-delivery-failure>.