Pular para o conteúdo
Documentação do usuário

Gerenciar mensagens recebidas

Uma mensagem recebida é um e-mail entregue a uma base de dados do Odoo. Qualquer pessoa pode enviar um e-mail para um alias de e-mail criado na base de dados ou responder a um e-mail enviado anteriormente através do cabeçalho reply-to.

Aliases de e-mail

Aliases específicos do modelo

Alguns aplicativos têm seus aliases específicos (equipes de vendas, equipes da central de ajuda, projetos, etc.). Esses aliases são usados para:

  • Create a record when an email is sent directly to the alias,

  • Receive replies to an email initially sent from a record.

No exemplo exibido acima, o envio de um e-mail para info@company-name.odoo.com criará uma nova oportunidade ou um novo lead automaticamente atribuído à equipe de vendas correspondente. Se um e-mail for enviado do chatter de uma oportunidade existente, o reply-to será info@company-name.odoo.com. A resposta será publicada no chatter correto, de acordo com o cabeçalho message-id.

Catch-all

Se um aplicativo não tiver um alias, será usado um alias de fallback genérico: o catchall. Um e-mail enviado de um chatter tem um endereço de resposta definido para esse alias catchall. Uma resposta enviada para o catchall é postada no chatter correto graças ao cabeçalho message-id.

Por padrão, a parte local catchall será usada. Ative o developer-mode e vá para Definições › Técnico › E-mails: Domínio de alias para acessar a configuração.

Um e-mail para o catchall deve sempre ser uma resposta a um e-mail anterior enviado da base de dados. Se um e-mail for enviado diretamente para o catchall, o remetente receberá a seguinte mensagem:

Bounce email from "MAILER-DEAMON" explaining how to contact the database.

Quando um e-mail é enviado do aplicativo Contatos, o endereço de resposta é catchall@company-name.odoo.com porque não há alias no modelo de contato.

Ressaltar

Da mesma forma que o alias catchall é usado para criar o endereço de resposta, o alias devolvido é usado para criar o return-path do e-mail. O return-path é usado quando os e-mails não podem ser entregues ao destinatário e um erro é retornado ao remetente.

Por padrão, o nome devolvido será usado. Habilite o developer-mode e vá para Definições › Técnico › E-mails: Domínio de alias para acessar a configuração.

Quando ocorre um erro, uma notificação é recebida e exibida em um envelope vermelho no chatter. Em alguns casos, o envelope vermelho pode conter apenas uma mensagem "sem erro", o que significa que há um erro que não pôde ser tratado pelo Odoo.

Uma notificação também será exibida no ícone Mensagens na barra de navegação.

An email sent to a contact had an issue and the error is reported on the navbar.

Receber e-mails com a configuração padrão do Odoo

No Odoo Online e no Odoo.sh, os endereços de alias de e-mail, de resposta e de devolução são pré-configurados. Esses endereços usam o domínio de alias adicionado automaticamente a uma base de dados padrão.

Se o aplicativo CRM estiver instalado e for criada uma equipe de vendas com o alias info, o endereço info@mydatabase.odoo.com poderá ser usado imediatamente. O mesmo se aplica a qualquer outro alias criado em outros aplicativos.

O domínio da base de dados está pronto para ser usado para receber e-mails sem nenhuma configuração adicional.

Usar múltiplos subdomínios do Odoo

No Odoo Online, o único subdomínio do Odoo é aquele definido na criação da base de dados.

No Odoo.sh, é possível usar diversos subdomínios do Odoo. Nas configurações da filial, é possível adicionar outros subdomínios do Odoo, desde que ainda não sejam usados em outra filial. Esses domínios devem então ser adicionados aos domínios de alias usados por uma empresa.

Setting up an Odoo subdomain on a branch.

Como usar um domínio personalizado para mensagens recebidas

O domínio de alias <email-outbound-alias-domain> deve ser selecionado nas configurações gerais. Se você tiver várias empresas, cada uma delas deverá ser configurada.

The alias domain in the general settings.

Todos os aliases usarão esse domínio personalizado. As respostas de modelos com alias configurados são enviadas para [alias]@my-custom-domain.com. As respostas de outros modelos são enviadas para o catchall por meio de catchall@my-custom-domain.com.

Technical schema of mailing route when using a custom domain in Odoo.

Como esse domínio personalizado é usado, todos os e-mails que usam um alias (respostas, devoluções e envios diretos) são enviados para um endereço do domínio. Assim, eles são entregues ao servidor de e-mail vinculado ao domínio (registro MX). Para exibi-los no chatter ou criar novos registros, é necessário recuperar esses e-mails recebidos na base de dados do Odoo.

Method

Benefits

Drawbacks

Redirections <email-inbound-custom-domain-redirections>

Easy to set up, emails are directly sent to the database.

Each alias of a database needs to be configured.

Incoming mail servers <email-inbound-custom-domain-incoming-server>

Allows to keep a copy of the email in your mailbox (with IMAP). Allows to create records in the chosen model.

Depends on a CRON, meaning emails are not retrieved immediately in the database. Each alias of a database needs to be configured.

MX record <email-inbound-custom-domain-mx>

Only one record needs to be created to make all aliases work properly.

Using a subdomain is required. Requires advanced technical knowledge.

Redirecionamentos

Se a base de dados estiver hospedada no Odoo Online ou no Odoo.sh, é recomendável usar redirecionamentos. Isso permite que as mensagens sejam recebidas na base de dados sem atraso.

Para obter mais informações sobre a configuração do Microsoft Exchange, visite Microsoft Learn.

É obrigatório redirecionar o endereço catchall e bounce para o subdomínio Odoo da base de dados. Todos os outros alias usados também devem ser redirecionados.

Uma alternativa aos redirecionamentos é o encaminhamento. Com o encaminhamento, o endereço que encaminha o e-mail será identificado como o remetente, enquanto que com os redirecionamentos, o remetente original sempre permanecerá.

Alguns provedores de email, como Gmail, exigem que o endereço de redirecionamento seja explicitamente confirmado antes que os emails sejam encaminhados, caso contrário, o redirecionamento pode não funcionar.

Além disso, quando o redirecionamento é usado em vez de um servidor de email de entrada, o alias pode aparecer com o domínio @yourdb.odoo.com a menos que Local-part based incoming detection (Detecção de entrada baseada em Local-part) esteja habilitada no alias correspondente. Esta configuração pode ser encontrada em Settings › Technical › Aliases.

Servidores de recebimento de e-mails

Como mencionado anteriormente, usar redirecionamentos é o método recomendado para receber emails no Odoo. No entanto, também é possível configurar servidores de email de entrada. Usar este método significa criar um servidor de email de entrada para cada caixa de correio no seu servidor, catchall, bounce e todos os aliases do banco de dados, a fim de buscar todos os emails de entrada.

Usar endereços de email pessoais (ex: mitchell.admin@yourcompany.com) como servidores de email de entrada não é recomendado. Fazer isso pode levar a aumentos de riscos de segurança, roteamento indesejado de mensagens, problemas de privacidade e dificuldades na sincronização correta de respostas.

Os servidores de email de entrada são criados acessando Settings › Technical › Emails: Incoming Mail Servers.

Independentemente do protocolo escolhido, os e-mails são obtidos usando a ação programada E-mail: Serviço de Fetchmail.

Além disso, o uso de um servidor de recebimento de e-mails no Odoo possibilita a criação de novos registros em um modelo específico. Cada servidor de recebimento de e-mails pode criar registros em um modelo diferente.

Registro MX

Uma terceira opção é criar um registro MX na sua zona DNS que especifique o servidor de e-mail que gerencia os e-mails enviados para o seu domínio. É necessário conhecimento técnico avançado.

Abaixo são apresentadas algumas especificações, dependendo do tipo de hospedagem:

O subdomínio personalizado deve ser adicionado ao seu Odoo Portal.

O subdomínio personalizado deve ser adicionado às definições do projeto:

Adding a custom subdomain for mail to Odoo.sh project settings.

Loops de e-mail infinitos

Em alguns casos, loops de e-mail infinitos podem ser criados. O Odoo oferece alguma proteção contra esses loops, garantindo que o mesmo remetente não possa enviar muitos e-mails que criariam registros para um alias em um período de tempo específico.

Por padrão, um endereço de e-mail pode enviar até 20 e-mails em 120 minutos. Se mais e-mails forem enviados, eles serão bloqueados e o remetente receberá a seguinte mensagem:

Bounce email received after attempting contact too many times an alias.

Para alterar o comportamento padrão, ative o developer-mode e, em seguida, vá para Definições › Técnico › Parâmetros: Parâmetros do sistema para adicionar dois parâmetros.

  • For the first parameter, enter mail.gateway.loop.minutes as the Key and choose a number of minutes as the Value (120 is the default behavior).

  • For the second parameter, enter mail.gateway.loop.threshold as the Key and choose a number of emails as the Value (20 is the default behavior).

Parâmetro de sistema de domínio de alias permitidos

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 <developer-mode>. Então, acesse app Definições › Técnico › 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 de remetente, destinatário e CC (Carbon Copy) 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 › Parâmetros do sistema. Clique em Novo. Em seguida, digite mail.catchall.domain.allowed no campo Chave.

Em seguida, no campo Valor, adicione os domínios separados por vírgulas. Manualmente fa-cloud-upload (Salvar), e o parâmetro do sistema terá efeito imediato.

mail.catchall.domain.allowed system parameter set.

Detecção de entrada baseada na parte local

Ao criar um novo alias, há uma opção para ativar Detecção de entrada baseada na parte local. Se ativada, o Odoo exigirá que apenas a parte local corresponda ao roteamento de um e-mail recebido. Se esse recurso estiver desativado, o Odoo exigirá que todo o endereço de e-mail corresponda para o encaminhamento de um e-mail recebido.