Configuração de envio de e-mail com OAuth2 no Mestre (Gmail e Outlook)
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.
- 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.
- 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.
- 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
- Acesse o console do Google Cloud.
- Clique em Criar credenciais.
- Escolha ID do cliente OAuth.
- Selecione Aplicativo para computador.
- Defina um nome para o aplicativo.
- 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
- Acesse o portal Azure.
- Abra Registro de Aplicativos.
- Clique em Novo Registro.
- Defina um nome para o aplicativo.
- Crie um Client Secret em Certificados e Segredos.
- 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.