ContractPlus | Autenticação OAuth 2.0 no envio de e-mails
6 min
Criado por Eduardo Martins Dos Santos em 13/11/2026 10:13
Atualizado por Eduardo Martins Dos Santos em 13/11/2026 10:23

Objetivo

A funcionalidade permite que o ContractPlus envie e-mails autenticando a conta de origem via OAuth 2.0, em substituição ao SMTP com usuário e senha. A mudança garante a continuidade dos envios após a descontinuação, pelo Google, da autenticação SMTP com credenciais simples, e também está disponível para contas Microsoft 365.

Aplicação da funcionalidade

A funcionalidade se aplica exclusivamente a:

  • Envio de alertas configurados no Gestor de E-mail, executado pelo Monitor de Serviços;
  • Envio de cotações a fornecedores, configurado em Parâmetros Gerais > Contract Web > Configurações de e-mail;
  • Contas de e-mail Google e Microsoft 365.

Agenda e Contatos não são afetados. Configurações que continuarem em SMTP com usuário e senha seguem funcionando como antes.

Pré-requisito

Antes de iniciar o processo, verifique se a empresa possui um aplicativo registrado no provedor de e-mail (Google ou Microsoft 365) e tenha em mãos as credenciais desse aplicativo:

  • Google: Client ID e Client Secret;
  • Microsoft 365: Client ID e Tenant ID;

O registro do aplicativo é feito pela própria empresa, no console de administração do provedor.

Para o envio de alertas, o Monitor de Serviços deve estar instalado e em execução.

Como utilizar

1. Configure o e-mail de origem dos alertas

No SAP Business One:

  1. Acesse ContractPlus > Configuração > Gestor de E-mail.
  2. Clique em E-mail de origem.
  3. No campo Autenticação, selecione OAuth 2.0.
  4. Selecione o provedor: Google ou Microsoft 365.
  5. Informe o Client ID e, para Google, o Client Secret.
  6. Inicie a autorização da conta.

2. Autorize a conta no provedor

Na página de consentimento aberta no navegador:

  1. Entre com a conta que enviará os e-mails.
  2. Permita o acesso solicitado pelo ContractPlus.
  3. Retorne ao ContractPlus e salve a configuração.

A autorização não exige privilégio de administrador na estação. Após a autorização, a renovação do acesso é automática e não requer nenhuma configuração adicional.

3. Configure o e-mail das cotações

No SAP Business One:

  1. Acesse ContractPlus > Configuração > Parâmetros Gerais.
  2. Abra a aba Contract Web e localize Configurações de e-mail.
  3. No campo Autenticação, selecione OAuth 2.0.
  4. Selecione o provedor e informe as credenciais do aplicativo.
  5. Autorize a conta conforme o passo 2 e clique em Salvar e por fim Atualizar.

Essa configuração é independente da configuração do Gestor de E-mail. Para que todos os envios usem OAuth 2.0, configure as duas.

Comportamento esperado

Com a configuração em SMTP

Os envios continuam funcionando com usuário e senha até a descontinuação por parte dos provedores. Ao abrir as telas de configuração, é exibido um aviso sobre a descontinuação do SMTP, uma vez por usuário em cada tela, até 31/12/2026.

Após a autorização via OAuth 2.0

Os e-mails passam a ser enviados autenticados pela conta autorizada. Os templates de e-mail existentes são mantidos e não precisam ser recriados.

Durante os envios

O acesso à conta é renovado automaticamente, sem intervenção do usuário.

Em caso de falha no envio automático

A falha é registrada e exibida ao abrir o Gestor de E-mail, já que o Monitor de Serviços é executado sem usuário na tela.

Pontos de atenção

  • O Gestor de E-mail e as Configurações de e-mail das cotações são independentes: alterar um não altera o outro.
  • Se o E-mail de origem for diferente da conta autorizada, o sistema exibe um aviso, mas não bloqueia o envio. Isso permite usar um alias verificado da conta.
  • Contas Google configuradas em SMTP com usuário e senha deixarão de enviar e-mails após a descontinuação desse método pelo Google.
  • Em bases já instaladas, os campos de OAuth 2.0 são criados na atualização da versão. Em bases novas, são criados pela opção Criar tabelas de usuário no SAP.
  • Agenda e Contatos não utilizam a autenticação OAuth 2.0.

Exemplo prático

Uma empresa envia os alertas de contratos e as cotações a fornecedores por uma conta Google configurada em SMTP com usuário e senha (cenário ilustrativo).

  1. O administrador registra um aplicativo no Google e obtém o Client ID e o Client Secret.
  2. No Gestor de E-mail, altera a Autenticação do e-mail de origem para OAuth 2.0 e autoriza a conta.
  3. Em Parâmetros Gerais > Contract Web, repete a configuração para o envio das cotações.
  4. Os alertas e as cotações passam a ser enviados via OAuth 2.0, com os mesmos templates de antes.
Este artigo foi útil para você?
Últimos artigos visitados