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

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

Fonte: https://docs.kmee.com.br/odoo/modulos/administracao/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.

Importante

O servidor Odoo está sujeito a um limite diário de e-mails para evitar abusos. O limite padrão é de 200 e-mails enviados por dia para bases de dados com uma assinatura **Enterprise**. Esse limite pode ser aumentado em certas condições. Consulte o [FAQ](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/problemas-com-e-mails/) ou entre em contato com o suporte para obter mais informações.

## 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](https://www.odoo.com/trial) e do [Odoo.sh](https://www.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.

Aviso

Se ninguém na empresa for contratado para gerenciar servidores de e-mail, o Odoo Online e o Odoo.sh são altamente recomendados. Nesses tipos de hospedagem Odoo, o envio e o recebimento de e-mails funcionam instantaneamente e são monitorados por profissionais. No entanto, uma empresa pode usar seu próprio servidor de e-mail se quiser gerenciar a reputação do servidor de e-mail por conta própria. Para obter mais informações, consulte [Configurar registros DNS para enviar e-mails no Odoo](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/registros-dns-para-envio-de-e-mail/)

[]()

## 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](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/servidor-de-e-mail/#email-communication-default).

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

Veja também

- Connect Gmail to Odoo using Google OAuth
- Connect Microsoft Outlook 365 to Odoo using Azure OAuth

Nota

Garantir que o domínio de saída tenha SPF, DKIM e DMARC configurados no DNS melhorará a capacidade de entrega. Para obter mais informações, consulte [Configurar registros DNS para enviar e-mails no Odoo](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/registros-dns-para-envio-de-e-mail/).

[]()

### 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](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode) 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

Nota

O `mail.default.from_filter` funciona apenas para configurações `odoo-bin` ou para o servidor de e-mail padrão do Odoo; caso contrário, esse parâmetro pode ser definido usando o campo `from_filter` em `ir.mail_server`.

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

Exemplo

In the following example, the from email address is replaced with the combination of the the two system parameters (`mail.default.from` and `mail.catchall.domain`). This is the defaultnotifications configuration in Odoo: `“Admin” <admin@example.com>` => `“Admin” <notifications@mycompany.com>`.

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

![Configurações do servidor de e-mail de saída e as configurações do filtro FROM.](https://docs.kmee.com.br/odoo/referencias/img/applications/general/email_communication/email_servers/from-filter-setting.png)

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

Nota

Se vários servidores de e-mail forem encontrados, o Odoo utilizará o primeiro de acordo com sua prioridade. Por exemplo, se houver dois servidores de e-mail, um com prioridade `10` e outro com prioridade `20`, então o servidor de e-mail com prioridade `10` será usado primeiro.

[]()

### 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](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/api-do-mailjet/) para e-mails em massa.

Importante

Um servidor de e-mail de saída padrão já está configurado. Não crie um servidor alternativo, a menos que um servidor de e-mail de saída externo específico seja necessário por motivos técnicos.

Para fazer isso, primeiro ative o [modo de desenvolvedor](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode), 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.

Veja também

- [Configurar registros DNS para enviar e-mails no Odoo](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/registros-dns-para-envio-de-e-mail/)

[]()

## 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](https://www.odoo.com/page/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](https://www.odoo.com/page/crm))
  > - Canal de suporte (para criar *chamados* no [Odoo Central de Ajuda](https://www.odoo.com/page/helpdesk))
  > - Projetos (para criar novas *Tarefas* no [Odoo Projeto](https://www.odoo.com/page/project-management))
  > - Cargos (para criar *Candidatos* no [Odoo Recrutamento](https://www.odoo.com/page/recruitment))

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

  ![Configuração do servidor de entrada de e-mails no Odoo.](https://docs.kmee.com.br/odoo/referencias/img/applications/general/email_communication/email_servers/incoming-server.png)

- 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](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode). 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.

Nota

Esse valor pode ser alterado no [modo de desenvolvedor](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode). Acesse as **Definições -> Técnico -> Automação -> Ações agendadas** e procure por **E-mail: Serviço de Fetchmail**.

### 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](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode) 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](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode). 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.

Exemplo

Quando o Odoo recebe e-mails com o prefixo de alias com `comercial` nos endereços de e-mail do remetente, no destinatário e/ou CC (ex.: <comercial@gmail.com>, <comercial@odoo.net>), a base de dados trata o e-mail erroneamente como o alias `comercial` completo (com um domínio diferente) e, portanto, cria um chamado/lead/oportunidade/etc.

To add the `mail.catchall.domain.allowed` system parameter, first, activate the [developer mode](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode). Then, go to **Settings app -> Technical -> Parameters section -> System Parameters**. Click **Create**. Then, type in `mail.catchall.domain.allowed` for the **Key** field.

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.

![Parâmetro do sistema mail.catchall.domain.allowed definido com chave e valor destacados.](https://docs.kmee.com.br/odoo/referencias/img/applications/general/email_communication/email_servers/allowed-domain.png)
