Receção de Email do Office 365 no Odoo

Contexto: Este guia aplica-se a quem migrou do Odoo SaaS para o Odoo SH e usa o Office 365 com domínio próprio para email. O objetivo é configurar a receção de emails no Odoo SH usando uma caixa partilhada (Shared Mailbox) do Office 365 com autenticação OAuth 2.0.

Requisitos prévios:

• Domínio de email no Office 365 (ex: magikevolution.com)

• Acesso ao Azure Active Directory (portal.azure.com)

• Acesso ao Exchange Admin Center

• Acesso de administrador ao Odoo SH

Parte 1 — Configurar o Office 365

1.1 — Criar uma Shared Mailbox para o catchall

Uma Shared Mailbox é gratuita (não requer licença adicional) e é a solução ideal para receber emails do Odoo.

1. Acede ao Microsoft 365 Admin Center

2. Vai a Grupos → Caixas de correio partilhadas

3. Clica em Adicionar uma caixa de correio partilhada

4. Define o endereço de email: odoocatchall@magikevolution.com

5. Em Delegação, adiciona o teu utilizador licenciado com permissões de Acesso total

6. Guarda

1.2 — Criar regra de reencaminhamento no Exchange

Para que todos os emails enviados para os aliases do Odoo cheguem à caixa catchall:

1. Acede ao Exchange Admin Center

2. Vai a Mail flow → Rules

3. Clica em Add a rule → Create a new rule

4. Preenche a regra:

   • Nome: Copiar aliases Odoo para catchall

   • Condição: The recipient domain is → magikevolution.com

   • Exceção: The recipient is → odoocatchall@magikevolution.com

   • Ação: Add recipients → To the Bcc field → odoocatchall@magikevolution.com

5. Guarda e ativa a regra

Nota: Usar Bcc em vez de Redirect garante que o email continua a chegar à caixa original do destinatário E uma cópia vai para o catchall do Odoo.

Parte 2 — Registar App no Azure AD para OAuth 2.0

2.1 — Criar o registo da app

1. Acede ao portal.azure.com

2. Vai a Azure Active Directory → App registrations

3. Clica em New registration e preenche:

   • Name: Odoo IMAP

   • Supported account types: Multiple Entra ID Tenants

   • Redirect URI: Web → https://www.magikevolution.com/microsoft_outlook/confirm

4. Clica em Register

5. Copia e guarda o Application (client) ID e o Directory (tenant) ID

2.2 — Adicionar permissões

1. Na app criada, vai a API permissions → Add a permission → Microsoft Graph

2. Seleciona Delegated permissions e adiciona:

   • IMAP.AccessAsUser.All

   • Mail.Read

   • Mail.ReadWrite

   • offline_access

   • User.Read

3. Clica em Add permissions

4. Clica em Grant admin consent for [o vosso tenant] e confirma

2.3 — Criar o Client Secret

1. Vai a Certificates & secrets → New client secret

   • Description: Odoo

   • Expires: 24 months

2. Clica em Add

3. Copia imediatamente o valor gerado (coluna Value) — só aparece uma vez

Parte 3 — Configurar o Odoo SH

3.1 — Definir o Alias Domain

1. No Odoo, vai a Definições → Técnico → Email → Alias Domains

2. Define o alias domain como magikevolution.com

3. Guarda

Nota: Este passo é crítico — é o que associa os aliases dos módulos (CRM, Helpdesk, etc.) ao vosso domínio de email.

3.2 — Instalar o módulo Microsoft Outlook

1. Vai a Definições → Aplicações

2. Remove o filtro "Instaladas"

3. Pesquisa por microsoft_outlook

4. Instala o módulo

3.3 — Ativar e configurar o OAuth Microsoft

1. Vai a Definições e pesquisa por Outlook

2. Na secção Usar um servidor Outlook, ativa a opção

3. Preenche:

   • Client ID: o Application (client) ID do passo 2.1

   • Client Secret: o valor gerado no passo 2.3

4. Guarda

3.4 — Configurar o servidor de email de entrada

1. Vai a Definições → Técnico → Email → Servidores de Email de Entrada

2. Clica em Criar e preenche:

1. Clica em Conectar com Microsoft

2. Autentica com as credenciais da conta que tem acesso delegado à Shared Mailbox

3. Após autenticação bem-sucedida, clica em Testar Ligação

4. Guarda

Parte 4 — Testar o fluxo completo

1. Envia um email de uma conta externa (ex: Gmail) para um alias do Odoo (ex: sys.support@magikevolution.com)

2. Confirma que o email chegou à caixa odoocatchall@magikevolution.com no Outlook

3. No servidor de email de entrada do Odoo, clica em Obter para forçar a recolha

4. Confirma que o email foi importado e criou o registo correto no módulo correspondente (Helpdesk, CRM, etc.)

Notas finais

• O Odoo faz polling à caixa de email a cada 5 minutos automaticamente

• Os emails enviados pelo Odoo aparecem nos Enviados da conta configurada no servidor de saída do Office 365

• Para adicionar novos aliases (ex: vendas@magikevolution.com), basta configurá-los nos respetivos módulos do Odoo — a regra de reencaminhamento no Exchange trata do resto automaticamente

• Se o Client Secret expirar (após 24 meses), é necessário gerar um novo no Azure AD e atualizar nas Definições do Odoo