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.: admin@company-name.odoo.com).
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
For more information on logs and how to access them via the Odoo.sh dashboard, refer to the Odoo.sh logs documentation.
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.