Como configurar envio de e-mail com OAuth2 (Gmail e Outlook) no sistema Mestre
5 min
Criado por Adriano Bertoldi Reiter em 11/03/2026 11:35
Atualizado por Adriano Bertoldi Reiter em 11/03/2026 15:31

Configuração de envio de e-mail com OAuth2 no Mestre (Gmail e Outlook)


IMPORTANTE

O Google e a Microsoft passaram a exigir métodos mais seguros para envio de e-mails por sistemas. Por isso, o envio de e-mails pelo sistema Mestre deve ser configurado utilizando OAuth2, um padrão de autenticação que permite ao usuário autorizar o sistema a enviar e-mails sem expor sua senha.

Resumo executivo (leitura de 10 segundos)
  • Gmail e Outlook exigem autenticação OAuth2 para envio de e-mail.
  • É necessário criar um aplicativo nas plataformas Google ou Microsoft.
  • Depois, inserir as credenciais geradas no cadastro de e-mail do sistema Mestre.
  • Por fim, autorizar o acesso e realizar o teste de envio.
Atenção
  • Se o Redirect URI estiver incorreto, o sistema não conseguirá gerar o código de autorização.
  • No Outlook, o campo Client Secret deve ficar vazio dentro do Mestre.
  • Se o acesso falhar, pode ser necessário remover a autorização do aplicativo e autorizar novamente.
Importante
  • O OAuth2 permite que o sistema envie e-mails sem armazenar a senha do usuário.
  • A autorização precisa ser concedida pelo usuário da conta de e-mail.
  • Após autorizado, o sistema poderá enviar e-mails automaticamente.

Como funciona

O OAuth2 é um mecanismo de autenticação segura usado por grandes provedores como Google e Microsoft.

Em vez de informar a senha do e-mail no sistema, o usuário concede permissão diretamente ao provedor.

O fluxo ocorre da seguinte forma:

  • O sistema solicita autorização para acessar o e-mail.
  • O usuário faz login na conta (Google ou Microsoft).
  • O usuário concede permissão.
  • O provedor gera um token de autorização.
  • O sistema passa a usar esse token para enviar e-mails.

Esse processo aumenta a segurança e evita bloqueios de envio por parte dos provedores.

O que fazer (passo a passo)

Configuração para Gmail

  1. Acesse o console do Google Cloud.
  2. Clique em Criar credenciais.
  3. Escolha ID do cliente OAuth.
  4. Selecione Aplicativo para computador.
  5. Defina um nome para o aplicativo.
  6. Guarde o Client ID e o Client Secret.

Depois configure o cadastro de e-mail no Mestre com os seguintes dados:

  • Servidor SMTP: smtp.gmail.com
  • Porta: 587
  • Modo de comunicação: Explicit TLS
  • Usuário: e-mail completo
  • Auth URI: https://accounts.google.com/o/oauth2/v2/auth
  • Token URI: https://www.googleapis.com/oauth2/v4/token
  • Scope: https://mail.google.com
  • Redirect URI: http://localhost

Caso precise autorizar novamente o acesso, acesse:

https://myaccount.google.com/permissions

Esse procedimento permite revogar e conceder novamente a autorização ao sistema.


Configuração para Outlook / Microsoft

  1. Acesse o portal Azure.
  2. Abra Registro de Aplicativos.
  3. Clique em Novo Registro.
  4. Defina um nome para o aplicativo.
  5. Crie um Client Secret em Certificados e Segredos.
  6. Adicione permissões de API para envio de e-mail.

Depois configure o cadastro de e-mail no Mestre:

  • Auth URI: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
  • Token URI: https://login.microsoftonline.com/common/oauth2/v2.0/token
  • Scope: https://outlook.office.com/.default offline_access
  • Redirect URI: http://127.0.0.1
  • Client ID: obtido no registro do aplicativo
  • Client Secret: deixar vazio

Depois de salvar a configuração, clique em OAuth2 e conceda a autorização da conta de e-mail. Após isso, o sistema já poderá realizar o teste de envio. :contentReference[oaicite:1]{index=1}

Perguntas rápidas

Preciso informar a senha do e-mail no sistema?

Não. O OAuth2 utiliza autorização por token, sem necessidade de armazenar senha.

O que fazer se o envio parar de funcionar?

Revogue a autorização do aplicativo e realize a autorização novamente.

Posso usar Gmail e Outlook?

Sim. O sistema Mestre é compatível com ambos, desde que configurados corretamente.

O que acontece se o Redirect URI estiver errado?

O sistema não conseguirá gerar o código de autorização necessário para enviar e-mails.


Caso ainda tenha dúvidas ou encontre dificuldades na configuração, abra um chamado para nossa equipe de suporte informando os dados da conta de e-mail e o erro apresentado.

Este artigo foi útil para você?
Últimos artigos visitados