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:
Por padrão, quando uma notificação ou e-mail transacional (cotação, fatura, mensagem direta para um contato) é enviado com êxito, o objeto de e-mail é excluído. O conteúdo da mensagem de e-mail permanece no chatter do registro relacionado. Isso evita sobrecarregar a base de dados com várias cópias do mesmo e-mail (quando enviado a vários destinatários), se o conteúdo já estiver presente no chatter.
Não existe o conceito de cópia carbono (cega) ([B]CC). O Odoo usa o conceito de seguidores adicionados ao chatter para decidir automaticamente quando e como um contato é notificado ou recebe uma cópia de um e-mail.
Os e-mails recebidos são administrados verificando se o endereço de e-mail PARA é um endereço de e-mail válido na base de dados do Odoo ou, no caso de um e-mail de resposta, se há uma referência no cabeçalho do e-mail que corresponda a uma mensagem enviada da base de dados do Odoo. Todos os outros e-mails serão devolvidos e não arquivados temporariamente em uma pasta de spam ou quarentena. Em outras palavras, e-mails não relacionados a uma base de dados do Odoo será perdido.
E-mails enviados¶
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.: [email protected]).
Falha na entrega¶
Quando uma mensagem é enviada, um ícone (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.
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 () na coluna Tentar novamente. Todos os destinatários desativados () 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 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.
Nota
Os e-mails enviados são periodicamente limpos da fila. Isso é controlado pela ação programada de Limpeza automática que limpa dados redundantes em sua base de dados Odoo.
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):
Tipo de assinatura da base de dados (um aplicativo gratuito, teste, assinatura paga)
Aplicativos instalados (ex.: Marketing por e-mail, Automação de marketing)
Se uma migração da base de dados estiver em andamento
Se o limite diário for atingido, você poderá:
Entre em contato com o suporte da Odoo para aumentar sua cota de e-mails. Os seguintes fatores serão levados em consideração:
Número de usuários na base de dados
Aplicativos instalados
Taxa de devolução (a porcentagem de endereços de e-mail que não receberam e-mails porque foram devolvidos pelo servidor de e-mail no caminho para o destinatário final).
Se seus aliases de e-mail estão configurados corretamente e usam os domínios personalizados apropriados.
Dica
Ao usar um domínio personalizado, verifique se SPF, DKIM e 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.
Use um servidor externo de e-mail de saída para não depender do limite de e-mails do Odoo.
Aguarde até o dia seguinte e tente enviar o e-mail novamente. Para fazer isso, ative o modo de desenvolvedor, vá para ao lado do e-mail não enviado.
Importante
O limite diário de e-mails conta todos os e-mails que saem da sua base de dados Odoo, acionados manual ou automaticamente. Por padrão, serão consideradas quaisquer mensagens internas, notificações, notas registradas, etc., se notificarem alguém por e-mail. Isso pode ser atenuado pelo recebimento de notificações pelo Odoo em vez de por e-mail.
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, 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.
Example
Erro de entrega permanente 550 SMTP de sendgrid.com:
Mail Delivery Failed
Mail delivery failed via SMTP server 'None'.
SMTPDataError: 550
The from address does not match a verified Sender Identity. Mail cannot be sent until this
error is resolved. Visit https://sendgrid.com/docs/for-developers/sending-email/sender-identity/
to see the Sender Identity requirements
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.
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.
Nota
Um dos motivos mais comuns para que um e-mail não seja enviado sem nenhuma mensagem de erro está relacionado à configuração de SPF ou DKIM. Além disso, verifique se a configuração de notificação por e-mail implementada está adaptada às suas necessidades comerciais. Consulte a documentação Comunicação por e-mail no Odoo para obter mais informações.
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.
Dica
Para editar crons, ative o modo de desenvolvdor e vá para .
Veja também
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.
Example
Se houver três campanhas: Campanha_1 (criada em 1º de janeiro), Campanha_2 (criada em 2 de janeiro) e Campanha_3 (criada em 3 de janeiro), elas serão colocadas na fila clicando em Enviar em todas as três.
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.
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 se houver um problema recorrente com o mesmo cliente ou domínio.
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).
Dica
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 obter mais informações sobre os logs e como acessá-los pelo do painel do Odoo.sh, consulte a documentação de logs do Odoo.sh.
Para obter mais informações sobre como acessar os registros por meio da linha de comando, consulte a documentação de logs para desenvolvedores.
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:
Uma exportação do e-mail inteiro da caixa de entrada. Geralmente, esses arquivos estão nos formatos
.emlou.msge contêm informações técnicas necessárias para uma investigação. O processo exato de download do arquivo depende do seu provedor de e-mail terceirizado.Veja também
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.
Dica
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).
Explicação do fluxo exato seguido para receber esses e-mails no Odoo normalmente. Tente responder às seguintes perguntas:
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 recebimento de e-mails sendo usado ou o e-mail está sendo redirecionado/encaminhado por meio de um servidor ou provedor de e-mail personalizado?
Existe um exemplo de um e-mail que foi encaminhado corretamente?
Você alterou alguma configuração relacionada a e-mails recentemente? Ele parou de funcionar depois dessas alterações?
Resposta às seguintes perguntas:
É um problema genérico ou específico de um caso de uso? Se for específico de um caso de uso, de qual?
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.