Cross Segmento - TOTVS Backoffice Linha Protheus - BI - Mudança de autenticação Microsoft para o uso do Office365 no Workflow

Tempo aproximado para leitura: 00:02:00min

Dúvida
É possível utilizar o Workflow do Protheus com contas de e-mail do Microsoft Office 365?

Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - BI - Workflow - Todas as versões

Ocorrência 
Devido às atualizações de segurança da Microsoft que descontinuaram o suporte à Autenticação Básica (Basic Auth), a configuração nativa do Workflow (via módulo Configurador) tornou-se incompatível com contas do Microsoft Office 365 (Exchange Online).

Contas Pessoais (Outlook.com, Hotmail, Live)

• Estado Atual: A Microsoft implementou a "Iniciativa Futuro Seguro", que tornou obrigatória a Autenticação Moderna a partir de 16 de setembro de 2024.

• Impacto no Protheus: Qualquer configuração nativa do Workflow que utilize um endereço @hotmail.com ou @outlook.com com a senha habitual do utilizador (ou mesmo senhas de aplicação antigas em protocolos depreciados) deixou de funcionar. O servidor SMTP recusa a conexão se esta não for feita via OAuth2.

O motor de Workflow legado do Protheus utiliza exclusivamente o protocolo de autenticação básica (usuário e senha) para o tráfego de mensagens. Atualmente, a Microsoft exige o uso de Autenticação Moderna (OAuth2), bloqueando conexões que não utilizam tokens de segurança atualizados.

Solução 
Para restabelecer o envio de e-mails, deve-se adotar uma das alternativas abaixo:

• 1. Utilização de Provedores Alternativos Uso de provedores de e-mail ou servidores SMTP locais que ainda permitam autenticação básica ou o uso de "Senhas de Aplicativo" (Ex.: Gmail com senha de app).

• 2. Customização via TLPP/AdvPL (Recomendado) Substituição do processo de Workflow padrão pelo desenvolvimento de rotinas customizadas utilizando as classes de e-mail atualizadas da TOTVS (TMailManager, TMailMessage). Estas classes possuem suporte nativo para autenticação moderna via Token (OAuth2) através dos métodos SetOAuthToken e cOAuthToken.

Passos:
Caso opte pela adaptação via customização (AdvPL), siga a lógica de implementação abaixo:

1. Utilize a classe TMailManager para estabelecer a conexão.

2. Implemente o método SetOAuthToken para validar a autenticação moderna junto à Microsoft.

3. Realize o envio da mensagem através da classe TMailMessage.

Saiba mais:
Os Métodos de Autenticação Modernos, aplicações de e-mail não Microsoft
Substituição da Autenticação básica no Exchange Online
Configuração Básica de conta para envio de WorkFlow pelo Gmail
Application Server - E-mail - Office+365
TMailMessage - Envio do Email
TMailMangager - SetOAuthToken
TMailMng - cOAuthToken