/
v.6.0 - Exemplo configuração Gmail

Para configurar o envio de e-mails através do Gmail, siga estas etapas: 

  1. Acesse o Console de Desenvolvedores do Google Cloud Platform da conta Gmail que deseja configurar. https://console.developers.google.com/. 

  2. Crie um projeto ou selecione um projeto existente 

  3. Para criar uma credencial, é necessário configurar a Tela de Consentimento OAuth, fornecendo informações como: 

a. User Type: Externo 

b. Informações do app: 

i. Nome do App: Nome do aplicativo que precisa de permissão, nesse caso, Plataforma Lecom; 

ii. E-mail para suporte ao usuário: Selecionar a própria conta de e-mail; 

iii. Dados de contato do desenvolvedor: Informar a própria conta de e-mail; 

  1. Após salvar, publique o aplicativo para mudar seu status para "Em produção" 

  2. Com a tela de consentimento OAuth criada, crie uma credencial no Console de Desenvolvedores do Google Cloud Platform. 

  3. Clique em "Criar credenciais" e selecione "ID do cliente OAuth". 

a. Escolha o tipo de aplicativo "Aplicativo da Web" 

b. Em “URLs de redirecionamento autorizados” adicionar a URL que será feito o call-back. Ex: https://dominiocliente/admin/v1/email/oauth/callback 

  1. Copie o ID do cliente e o segredo do cliente gerados. 


Com essas informações podemos seguir para a tela de configuração de e-mail na Plataforma Lecom; 

  1. Escolha o tipo de autenticação: Oauth 2.0 

  2. Conexão segura: STARTTLS 

  3. URL de autenticação: A URL de autenticação OAuth 2.0 é construída concatenando diversos parâmetros necessários para iniciar o fluxo de autorização. Cada parâmetro desempenha um papel específico no processo de autenticação e autorização. 


Exemplo URL de autorização:  https://accounts.google.com/o/oauth2/auth?client_id=1234clientid&redirect_uri=https://dominiocliente/admin/v1/email/oauth/callback&response_type=code&scope=openid%20https%3A%2F%2Fmail.google.com%2F&access_type=offline&prompt=consent 

 Raiz da url:  https://accounts.google.com/o/oauth2/auth? 

Parâmetros: 

  1. client_id:  Id do cliente cadastrado nas credenciais no Console de Desenvolvedores do Google Cloud Platform 

  2. redirect_uri:  endpoint de retorno após usuário após conceder ou negar permissões ao aplicativo. 

https://dominiocliente/admin/v1/email/oauth/callback 

  1. response_type:  Define o tipo de resposta esperado do servidor de autorização. Neste caso, "code" indica que o servidor retornará um código de autorização 

  2. scope:  Define o escopo das permissões solicitadas pelo aplicativo. Neste caso, o aplicativo solicita acesso ao perfil do usuário (openid) e ao Gmail (https://mail.google.com/). 

  3. access_type:  Indica o tipo de acesso solicitado. "offline" permite que o aplicativo obtenha um token de atualização, permitindo acesso offline 

  4. prompt: Define o comportamento ao solicitar permissões. O valor consent força o consentimento explícito do usuário, garantindo que ele veja uma tela de permissão, mesmo se já tiver concedido antes. 


  1. URL de solicitação de token: https://www.googleapis.com/oauth2/v4/token 

  2. Id do cliente: Id do cliente cadastrado nas credenciais no Console de Desenvolvedores do Google Cloud Platform. 

  3. Segredo do cliente: Segredo do cliente cadastrado nas credenciais no Console de Desenvolvedores do Google Cloud Platform. 

  4. Escopo: Não é necessário preencher para configuração de servidor de e-mail Gmail. 


O Gmail não permite redirecionamento para endereços IP fixos e domínios não oficiais. Apenas URLs com domínios oficiais registrados são aceitas para o redirect_uri.