Envie e receba e-mails no Odoo com um servidor de e-mail¶

Usuários do Odoo Online ou do Odoo.sh¶

Como o Odoo configura seus próprios servidores de e-mail para a base de dados, os e-mails enviados e recebidos já funcionam imediatamente. Portanto, para os clientes do Odoo Online e do Odoo.sh, nada precisa ser configurado!

A menos que seja necessário um servidor de e-mail externo para enviar grandes lotes de e-mails em massa, basta usar a base de dados online padrão do Odoo normalmente, pois ela já foi pré-configurada para enviar e-mails.

Escopo desta documentação¶

Este documento é dedicado principalmente a bases de dados locais do Odoo que não se beneficiam de uma solução pronta para enviar e receber e-mails no Odoo, ao contrário do Odoo Online e do Odoo.sh. Os servidores de entrada e saída devem ser configurados para bases de dados locais.

As seções a seguir contêm informações sobre como integrar um servidor de e-mail externo ao Odoo.

Sistema padrão de notificações¶

Os documentos no Odoo (como uma oportunidade de CRM, um pedido de venda, uma fatura, etc.) têm um tópico de discussão, chamado chatter.

Quando um usuário da base de dados publica uma mensagem no chatter, essa mensagem é enviada por e-mail para os seguidores do documento como uma notificação (exceto para o remetente). Se um seguidor responder à mensagem, a resposta atualiza o chatter e o Odoo retransmite outra resposta aos seguidores como uma notificação. As mensagens enviadas de volta ao chatter por usuários ou usuários externos aparecerão no chatter a partir de seus respectivos e-mails ou como o nome listado em seus registros Contatos.

Essas notificações são enviadas usando um endereço de origem padrão. Para obter mais informações, consulte Usar um endereço de e-mail padrão.

Gerenciar mensagens de saída¶

Como administrador do sistema, vá para Definições ‣ Configurações gerais ‣ Mensagens no Odoo e ative a opção Servidores de e-mail personalizados. Em seguida, clique em Salvar. Em seguida, clique em Servidores de envio de e-mails e clique em Criar para criar um novo registro de servidor de envio de e-mail no Odoo. Faça referência aos dados SMTP do servidor de e-mail externo. Depois que todas as informações tiverem sido preenchidas, clique em Testar conexão.

Restrição de porta¶

Observe que a porta 25 está bloqueada por motivos de segurança nas plataformas Odoo Online e Odoo.sh. Em vez disso, tente usar as portas 465, 587 ou 2525.

Use um endereço de e-mail “De” padrão¶

Às vezes, o endereço “De” (de saída) de um e-mail pode pertencer a um domínio diferente, e isso pode ser um problema.

Por exemplo, se um cliente com o endereço de e-mail mary@customer.example.com responder a uma mensagem, o Odoo tentará redistribuir esse mesmo e-mail para os outros assinantes no thread. No entanto, se o domínio customer.example.com proibir esse tipo de uso por segurança, o e-mail que o Odoo está tentando redistribuir será rejeitado pelos servidores de e-mail de alguns destinatários.

Para evitar esse problema, o Odoo envia todos os e-mails usando um endereço “De” do mesmo domínio autorizado.

Acesse os Parâmetros do sistema ativando o modo de desenvolvedor e acessando o menu Definições ‣ Técnico ‣ Parâmetros ‣ Parâmetros do sistema.

Para forçar o endereço de e-mail a partir do qual os e-mails são enviados, uma combinação das seguintes chaves precisa ser definida nos parâmetros do sistema da base de dados:

• mail.default.from: aceita a parte local ou um endereço de e-mail completo como valor

• mail.default.from_filter: aceita um nome de domínio ou um endereço de e-mail completo como valor

O campo pode ser um nome de domínio ou um endereço de e-mail completo, ou pode permanecer vazio. Se o endereço de e-mail do remetente não corresponder a esse filtro definido, o e-mail será encapsulado usando uma combinação dos dois parâmetros do sistema: mail.default.from e mail.catchall.domain.

Em outras palavras, se o endereço de e-mail do autor não corresponder a mail.default.from_filter, o endereço de e-mail será substituído por mail.default.from (se contiver um endereço de e-mail completo) ou por uma combinação de mail.default.from e mail.catchall.domain.

Se o from_filter contiver um endereço de e-mail completo e se o mail.default.from for igual a esse endereço, todos os endereços de e-mail diferentes do mail.default.from serão encapsulados no mail.default.from.

Utilização do filtro “From” em um servidor de e-mail de saída¶

O campo FROM Filtering permite o uso de um servidor de e-mail de saída específico, dependendo do endereço de e-mail From ou do domínio do qual o Odoo está enviando em nome. Essa configuração pode ser usada para melhorar a capacidade de entrega ou a taxa de sucesso de envio de e-mails enviados do banco de dados. A configuração do campo FROM Filtering também pode ser usada para enviar de diferentes domínios em um ambiente com várias empresas. Acesse esse campo no Odoo navegando até Settings ‣ Discuss ‣ Custom Mail Servers ‣ Outgoing Mail Servers ‣ New.

Quando um e-mail é enviado do Odoo enquanto o campo FROM Filtering está definido, um servidor de e-mail é escolhido na seguinte sequência:

1. Primeiro, o Odoo procura por um servidor de e-mail que tenha o mesmo valor FROM Filtering que o valor De (endereço de e-mail) definido no e-mail de saída. Por exemplo, se o valor De (endereço de e-mail) for test@example.com, somente os servidores de e-mail que tiverem o valor FROM Filtering igual a test@example.com serão retornados.

2. No entanto, se não forem encontrados servidores de e-mail que usem o valor From, o Odoo procurará um servidor de e-mail que tenha o mesmo domínio que o valor De (endereço de e-mail) definido no e-mail de saída. Por exemplo, se o endereço de e-mail De for test@example.com, somente os servidores de e-mail que tiverem o valor FROM Filtering igual a example.com serão retornados.

Se nenhum servidor de e-mail for encontrado após a verificação do domínio, o Odoo retornará todos os servidores de e-mail que não têm nenhum valor FROM Filtering definido.

Se essa consulta não retornar nenhum resultado, o Odoo realizará uma busca por um servidor de e-mail usando o parâmetro do sistema: mail.default.from. Primeiro, o endereço de e-mail listado tenta corresponder a um servidor de e-mail e, em seguida, o domínio tenta encontrar uma correspondência. Se nenhum servidor de e-mail for encontrado, o Odoo retornará o primeiro servidor de envio de e-mail (classificado por prioridade).

Configure servidores dedicados diferentes para e-mails transacionais e em massa¶

No Odoo, um servidor de e-mail separado pode ser usado para e-mails transacionais e e-mails em massa. Exemplo: Use Postmark ou SendinBlue para e-mails transacionais e Amazon SES, Mailgun, Sendgrid ou Mailjet para e-mails em massa.

Para fazer isso, primeiro ative o modo de desenvolvedor, e, em seguida, acesse o menu Definições ‣ Técnico ‣ Servidores de envio de e-mails. Lá, crie duas configurações de servidor de e-mail de saída: uma para os e-mails transacionais e outra para o servidor de envio em massa. Certifique-se de dar prioridade ao servidor transacional em relação ao servidor de envio, fornecendo um número de prioridade mais baixo para o servidor de e-mail transacional.

Agora, acesse o menu Marketing de E-mail ‣ Definições e ative a opção Servidor dedicado. Escolha o servidor de e-mail apropriado. Com essas configurações, o Odoo usa o servidor com a prioridade mais baixa para e-mails transacionais e o servidor aqui selecionado para e-mails em massa. Observe que, nesse caso, os registros Sender Policy Framework (SPF) do domínio devem ser definidos para incluir os servidores de e-mail transacional e de envio em massa.

Gerenciar mensagens recebidas¶

Odoo conta com aliases genéricos de e-mail para buscar mensagens recebidas.

• As mensagens de resposta de mensagens enviadas do Odoo são encaminhadas para o tópico de discussão original (e para a caixa de entrada de todos os seus seguidores) pelo alias do modelo, se houver, ou pelo alias catchall (catchall@). As respostas a mensagens de modelos que não tenham um alias personalizado usarão o alias catchall (catchall@mycompany.odoo.com). O endereço catchall, no entanto, não tem outra ação anexada a ele, como outros aliases podem ter, ele é usado apenas para coletar respostas.

• Mensagens devolvidas são usadas como um Return-Path. Um exemplo em que isso é especialmente útil é no Odoo Email Marketing. Nesse caso, as devoluções são desativadas com base no fato de o e-mail ter sido devolvido muitas vezes (5) no último mês e as devoluções estarem separadas por uma semana. Isso é feito para evitar colocar alguém na lista de bloqueio devido a um erro do servidor de e-mail. Se essas circunstâncias forem atendidas, o e-mail será considerado inválido e será colocado na lista de bloqueio. Uma nota de registro é adicionada ao contato em Endereços de e-mail colocados na lista de bloqueio no Menu de configuração de e-mail marketing.

  As mensagens que forem devolvidas no chatter (fora do app Marketing de E-mail) receberão um ícone de envelope vermelho indicando a falha na entrega. Isso pode ser útil para saber que um pedido de venda ou uma fatura não chegou ao destino final.

• Mensagens originais: vários objetos de negócios têm seu próprio alias para criar novos registros no Odoo a partir de e-mails recebidos:

  • Canal de vendas (para criar Leads ou Oportunidades no Odoo CRM)

  • Canal de suporte (para criar chamados no Odoo Central de Ajuda)

  • Projetos (para criar novas Tarefas no Odoo Projeto)

  • Cargos (para criar Candidatos no Odoo Recrutamento)

Dependendo do servidor de e-mail, pode haver vários métodos para buscar e-mails. O método mais fácil e mais recomendado é gerenciar um endereço de e-mail por alias do Odoo no servidor de e-mail.

• Crie os endereços de e-mail correspondentes no servidor de correio eletrônico (catchall@, bounce@, sales@, etc.).

• Defina o nome de domínio do alias nas Definições ‣ Configurações gerais ‣ Mensagens. Alterar o Domínio do alias alterará o domínio do catchall para a base de dados.

• Se o tipo de hospedagem da base de dados for Odoo on-premise, crie um Servidor de entrada de e-mails no Odoo para cada alias. Para criar um novo servidor de entrada, vá para: Definições ‣ Mensagens ‣ Servidores de e-mail personalizados ‣ Servidores de entrada de e-mails ‣ Novo Preencha o formulário de acordo com as configurações do provedor de e-mail. Deixe o campo Ações a realizar em e-mails de entrada em branco. Depois que todas as informações forem preenchidas, clique em TESTAR E CONFIRMAR.

  

• Se o tipo de hospedagem da base de dados for Odoo Online ou Odoo.sh, é recomendável redirecionar ou encaminhar as mensagens recebidas para o nome de domínio do Odoo em vez do servidor de e-mail externo. Dessa forma, as mensagens recebidas podem ser recebidas sem atraso. Os redirecionamentos para todos os endereços de e-mail devem ser definidos para o nome de domínio do Odoo no servidor de e-mail (por exemplo, catchall@mydomain.ext para catchall@mycompany.odoo.com).

Todos os aliases são personalizáveis no Odoo. Os aliases de objetos podem ser editados em sua respectiva visualização de configuração, navegando até Definições ‣ Menu técnico ‣ E-mail ‣ Aliases.

Para editar aliases catchall e bounce, primeiro ative a opção modo de desenvolvedor. Em seguida, vá para Definições ‣ Técnico ‣ Parâmetros ‣ Parâmetros do sistema para personalizar os aliases (mail.catchall.alias & mail.bounce.alias). Esses tipos de alterações devem ser concluídos antes da base de dados entrar em operação. Se um cliente responder depois que uma alteração for feita, o sistema não reconhecerá o alias antigo e a resposta não será recebida.

Por padrão, as mensagens de entrada são obtidas a cada 5 minutos para bases de dados locais.

Parâmetros do sistema que evitam loops de feedback¶

Há dois parâmetros de sistema que ajudam a evitar a ocorrência de loops de e-mail no Odoo. Esses parâmetros foram introduzidos no Odoo 16 para evitar que os aliases criem muitos registros e para evitar loops de feedback no endereço de e-mail catchall reply-to. Eles estão presentes na base de dados, mas não nos Parâmetros do sistema. Para substituir os seguintes padrões, eles precisam ser adicionados.

Os dois parâmetros do sistema são os seguintes:

• mail.gateway.loop.minutes (120 minutos por padrão)

• mail.gateway.loop.threshold (20 por padrão)

Adicione esses campos no Odoo ativando primeiro o modo de desenvolvedor e, em seguida, acessando as Definições ‣ Menu técnico ‣ Parâmetros ‣ Parâmetros do sistema. Altere os valores desses parâmetros, conforme necessário.

Quando um e-mail é recebido na base de dados do Odoo no endereço de e-mail catchall ou em qualquer alias, o Odoo analisa os e-mails recebidos durante um determinado período de tempo definido no parâmetro do sistema mail.gateway.loop.minutes. Se o e-mail recebido foi enviado para um alias, o Odoo fará referência ao parâmetro do sistema mail.gateway.loop.threshold e determinará o valor como o número de registros que esse alias tem permissão para criar no período de tempo determinado (valor de mail.gateway.loop.minutes).

Além disso, quando um e-mail for recebido no endereço de e-mail catchall, o Odoo fará referência aos e-mails recebidos na base de dados durante o período de tempo definido (conforme indicado pelo valor no parâmetro do sistema: mail.gateway.loop.minutes). Em seguida, o Odoo determinará se algum dos e-mails recebidos corresponde aos e-mails recebidos durante o período especificado e evitará a ocorrência de um loop de feedback se um e-mail duplicado for detectado.

Parâmetro de sistema para permitir de domínio de alias¶

Os aliases de recebimento de e-mail são definidos na base de dados do Odoo para criar registros ao receber e-mails. Para visualizar os aliases definidos na base de dados do Odoo, primeiro ative o modo modo de desenvolvedor. Então, acesse app Definições ‣ Técnico ‣ seção E-mail ‣ Aliases.

O seguinte parâmetro do sistema, mail.catchall.domain.allowed, definido com valores de domínio de alias permitidos, separados por vírgulas, filtra os e-mails direcionados corretamente aos aliases. Definir domínios para os quais o alias pode criar um chamado, lead, oportunidade etc. elimina os falsos positivos em que há endereços de e-mail com apenas o prefixo do alias (e não o domínio).

Em alguns casos, a base de dados do Odoo faz correspondências quando um e-mail é recebido com o mesmo prefixo de alias e um domínio diferente no endereço de e-mail recebido. Isso ocorre nos endereços de e-mail do remetente, do destinatário e do CC de um e-mail recebido.

Para adicionar o parâmetro de sistema mail.catchall.domain.allowed", comece ativando :ref:`modo de desenvolvedor <developer-mode>. Em seguida, vá para app Definições ‣ Técnico ‣ seção Parâmetros ‣ Parâmetros do sistema. Clique em Criar. Em seguida, digite mail.catchall.domain.allowed no campo Chave.

Em seguida, no campo Valor, adicione os domínios separados por vírgula (se houver mais de um domínio). Pressione manualmente Salvar e o parâmetro do sistema terá efeito imediato.