Conectar o Microsoft Outlook 365 ao Odoo usando o Azure OAuth

O Odoo é compatível com o Azure OAuth da Microsoft para o Microsoft 365. Para enviar e receber e-mails seguros de um domínio personalizado, basta definir algumas configurações na plataforma do Azure e no back-end da base de dados do Odoo. Essa configuração funciona com um endereço de e-mail pessoal ou com um endereço criado por um domínio personalizado.

Configuração no portal do Microsoft Azure

Criar um novo aplicativo

Para começar, acesse o Portal do Microsoft Azure. Faça login com a conta do Microsoft Outlook Office 365, se tiver uma, caso contrário, faça login com a conta pessoal Microsoft. Um usuário com acesso administrativo às configurações do Azure precisará se conectar e realizar a seguinte configuração. Em seguida, navegue até a seção denominada Gerenciar Microsoft Entra ID (antigo Azure Active Directory).

Agora, clique em Adicionar (+), localizado no menu superior, e selecione Registro de aplicativo. Na tela Registrar um aplicativo, renomeie o Nome para Odoo ou algo reconhecível. Na seção Tipos de conta suportados, selecione Contas em qualquer diretório organizacional (qualquer diretório Microsoft Entra ID - Multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).

Under the Redirect URL section, select Web as the platform, and then input https://<web base url>/microsoft_outlook/confirm in the URL field. The web.base.url is subject to change depending on the URL used to log in to the database.

Nota

The documentation about the web.base.url explains how to freeze a unique URL. It is also possible to add different redirect URLs on the Microsoft app.

After the URL has been added to the field, Register the application, so it is created.

Permissões de API

As permissões de API devem ser definidas em seguida. O Odoo precisará de permissões específicas de API para poder ler (IMAP) e enviar (SMTP) e-mails na configuração do Microsoft 365. Primeiro, clique no link permissões de API, localizado na barra de menu à esquerda. Em seguida, clique no botão (+) Adicionar uma permissão e selecione Microsoft Graph em APIs da Microsoft comumente usadas. Depois, selecione a opção Permissões delegadas.

Na barra de pesquisa, procure as seguintes Permissões delegadas e clique em Adicionar permissões em cada uma delas:

  • SMTP.Send

  • IMAP.AccessAsUser.All

Nota

A permissão User.Read será adicionada por padrão.

As permissões de API necessárias para a integração do Odoo estão listadas no Microsoft Graph.

Atribuir usuários e grupos

Depois de adicionar as permissões de API, navegue de volta para o Visão geral do Aplicativo na parte superior do menu da barra lateral esquerda.

Agora, adicione usuários a esse aplicativo. Na tabela de visão geral Noções básicas, clique no link rotulado Gerenciar aplicativo no diretório local ou na última opção no canto inferior direito da tabela.

Adicione usuários/grupos clicando no link Aplicativo gerenciado no diretório local para o aplicativo criado.

No menu da barra lateral esquerda, selecione Usuários e Grupos. Em seguida, clique em (+) Adicionar usuário/grupo. Dependendo da conta, é possível adicionar um Grupo e um Usuário ou somente Usuários. As contas pessoais só permitirão a adição de Usuários.

Em Usuários ou Grupos, clique em Nenhum selecionado e adicione os usuários ou grupos de usuários que enviarão e-mails da Conta Microsoft no Odoo. Adicione os usuários/grupos, clique em Selecionar e, em seguida, atribua-os ao aplicativo.

Criar credenciais

Agora que o aplicativo do Microsoft Azure está configurado, é preciso criar credenciais para a configuração do Odoo. Elas incluem o ID do cliente e o Segredo do cliente. Para começar, o ID do cliente pode ser copiado da página Visão geral do aplicativo. O ID do cliente ou ID do aplicativo está localizado sob o Nome de exibição na visão geral Noções básicas do aplicativo.

ID do aplicativo/cliente localizado na Visão geral do aplicativo.

Em seguida, o Valor do segredo do cliente precisa ser recuperado. Para obter esse valor, clique em Certificados e segredos no menu da barra lateral esquerda. Em seguida, um Segredo do cliente precisa ser produzido. Para fazer isso, clique no botão (+) Novo segredo do cliente.

Uma janela à direita será preenchida com um botão chamado Adicionar um segredo do cliente. Em Descrição, digite Odoo Fetchmail ou algo reconhecível e, em seguida, defina a data de expiração.

Importante

Um novo Segredo de cliente precisará ser produzido e configurado se o primeiro expirar. Nesse caso, poderá haver uma interrupção do serviço, portanto, a data de expiração deve ser observada e definida para a data mais distante possível.

Em seguida, clique em Adicionar quando esses dois valores forem inseridos. Serão criados o Valor do segredo do cliente e o ID do segredo. É importante copiar o Valor ou Valor do segredo do cliente em um bloco de notas, pois ele será criptografado após sair desta página. O ID do segredo não é necessário.

Valor secreto do cliente ou Valor nas credenciais do aplicativo.

Após essas etapas, os seguintes itens devem estar prontos para serem configurados no Odoo:

  • ID de cliente (ID do cliente ou ID do aplicativo)

  • Segredo do cliente (Valor ou Valor do segredo do cliente)

Isso conclui a configuração no lado do Portal do Microsoft Azure.

Configuração no Odoo

Inserir as credenciais do Microsoft Outlook

Primeiro, abra a base de dados do Odoo e navegue até o módulo Aplicativos. Em seguida, remova o filtro Aplicativos da barra de pesquisa e digite Outlook. Depois disso, instale o módulo chamado Microsoft Outlook.

Em seguida, navegue até Definições ‣ Configurações gerais e, na seção Mensagens, verifique se a caixa de seleção Servidores de e-mail personalizados está marcada. Isso popula uma nova opção de Credenciais do Outlook.

Salve o progresso.

Em seguida, copie e cole o ID do cliente (ID do aplicativo) e o Segredo do cliente (valor do segredo do cliente) nos respectivos campos e Salve as configurações.

Credenciais do Outlook nas Configurações Gerais do Odoo.

Configurar o servidor de envio de e-mail

Na página Configurações gerais, na configuração Servidores de e-mail personalizados, clique no link Servidores de envio de e-mail para configurar a conta da Microsoft.

Em seguida, crie um novo servidor de e-mail e marque a caixa de seleção Outlook. Em seguida, preencha o Nome (pode ser qualquer coisa) e o e-mail do Microsoft Outlook Nome de usuário.

Se o campo Filtro de estiver vazio, digite um domínio ou endereço de e-mail.

Em seguida, clique em Conectar sua conta Outlook.

Uma nova janela da Microsoft será aberta para concluir o processo de autorização. Selecione o endereço de e-mail que está sendo configurado no Odoo.

Página de permissão para conceder acesso do aplicativo recém-criado e o Odoo.

Em seguida, permita que o Odoo acesse a conta da Microsoft clicando em Sim. Depois disso, a página navegará de volta para o recém-configurado Servidor de envio de e-mail no Odoo. A configuração carrega automaticamente o token no Odoo, e um marcador informando Token válido do Outlook aparece em verde.

Indicador de token válido do Outlook.

Por fim, clique em Testar conexão. Uma mensagem de confirmação deve aparecer. A base de dados do Odoo pode então enviar e-mails seguros e protegidos pelo Microsoft Outlook usando a autenticação OAuth.

Configuração com um único servidor de envio de e-mail

A configuração de um único servidor de envio é a configuração mais simples disponível para o Microsoft Azure e não requer direitos de acesso extensos para os usuários na base de dados.

Um endereço de e-mail genérico seria usado para enviar e-mails para todos os usuários do banco de dados. Por exemplo, ele poderia ser estruturado com um alias de notificações (notifications@example.com) ou contato (contact@example.com). Esse endereço deve ser definido como o Filtro DE no servidor. Esse endereço também deve corresponder à combinação de chaves {mail.default.from}@{mail.catchall.domain} nos parâmetros do sistema.

Veja também

Para obter mais informações sobre o filtro DE, visite: Use um endereço de e-mail “De” padrão.

Nota

Os Parâmetros do sistema podem ser acessados ativando o modo de desenvolvedor no menu Definições ‣ Técnico ‣ Parâmetros ‣ Parâmetros do sistema.

Ao usar essa configuração, todos os e-mails enviados da base de dados usarão o endereço da caixa de e-mail notificação configurada. No entanto, deve-se observar que o nome do remetente aparecerá, mas o endereço de e-mail será alterado:

Nome do remetente real com e-mail estático.

Example

Configuração de um único servidor de envio de e-mail:

  • Nome de usuário (login) do servidor de envio de e-mail = notifications@example.com

  • Servidor de envio de e-mail Filtro DE = notifications@example.com

  • mail.catchall.domain nos parâmetros do sistema = example.com

  • mail.default.from nos parâmetros do sistema = notifications

Configuração específica do usuário (múltiplos usuários)

Além de um servidor de e-mail genérico, servidores de e-mail individuais podem ser configurados para usuários em uma base de dados. Esses endereços de e-mail devem ser definidos como Filtro DE em cada servidor individual para que essa configuração funcione.

Essa configuração é a mais difícil das duas configurações do Microsoft Azure, pois exige que todos os usuários configurados com servidores de e-mail tenham direitos de acesso às configurações para estabelecer uma conexão com o servidor de e-mail.

Definição

Cada usuário deve ter um servidor de e-mail separado configurado. O Filtro DE deve ser configurado para que somente o e-mail do usuário seja enviado desse servidor. Em outras palavras, somente um usuário com um endereço de e-mail que corresponda ao conjunto Filtro DE poderá usar esse servidor.

Veja também

Para obter mais informações sobre o filtro DE, visite: Use um endereço de e-mail “De” padrão.

Um servidor de fallback deve ser configurado para permitir o envio de notificações. O Filtro DE desse servidor deve ter o valor de {mail.default.from}@{mail.catchall.domain}.

Nota

Os Parâmetros do sistema podem ser acessados ativando o modo de desenvolvedor no menu Definições ‣ Técnico ‣ Parâmetros ‣ Parâmetros do sistema.

Importante

A configuração desse servidor de e-mail transacional pode funcionar junto com um servidor de e-mail de envio em massa. O Filtro DE do servidor de envio de e-mai em massa pode permanecer vazio, mas é necessário adicioná-lo nas configurações do aplicativo Marketing por e-mail.

Veja também

Para obter mais informações sobre a configuração do servidor de envio de e-mail em massa, visite Configure servidores dedicados diferentes para e-mails transacionais e em massa.

Example

Configuração do servidor de envio de e-mail de múltiplos usuários:

  • Caixa de e-mail do usuário nº 1
    • Nome de usuário (login) do servidor de envio de e-mail nº 1 = john@example.com

    • Servidor de envio de e-mail nº 1 Filtro DE = john@example.com

  • Caixa de e-mail do usuário nº 2
    • Nome de usuário (login) do servidor de envio de e-mail nº 2 = jane@example.com

    • Servidor de envio de e-mail nº 2 Filtro DE = jane@example.com

  • Caixa de e-mail de notificações
    • Nome de usuário (login) do servidor de envio de e-mail nº 3 = notifications@example.com

    • Servidor de envio de e-mail nº 3 Filtro DE = notifications@example.com

  • Parâmetros do sistema
    • mail.catchall.domain nos parâmetros do sistema = example.com

    • mail.default.from nos parâmetros do sistema = notifications

Configurar o servidor para e-mails recebidos

A conta de entrada deve ser configurada de forma semelhante à conta de envios de e-mail. Navegue até Servidores de envio de e-mail no Menu técnico e Crie uma nova configuração. Marque ou selecione o botão ao lado de Autenticação Outlook OAuth e digite o Nome de usuário do Microsoft Outlook. Clique em Conectar sua conta do Outlook. O Odoo informará: Token válido do Outlook Agora Teste e Confirme a conta. A conta deve estar pronta para receber e-mails na base de dados do Odoo.