Conectar o Gmail ao atendimento por OAuth
Autorize uma conta Gmail para receber e responder e-mails como tickets sem divulgar credenciais do Google.
Antes de começar
- Conta Google autorizada pela empresa
- Projeto Google Cloud com Gmail API habilitada
- Tela de consentimento OAuth configurada
- Cliente OAuth para Aplicativo da Web
- Conta de teste externa para validar recebimento e resposta
Entender OAuth e SMTP
O OAuth autoriza o Atendeu Rápido a acessar a caixa do Gmail. A configuração de envio pode também solicitar SMTP e uma senha de aplicativo. Esse fluxo é diferente do canal genérico Email (IMAP/SMTP).
Preparar o aplicativo no Google Cloud
- 1
Crie ou selecione o projeto usado pela empresa.
- 2
Habilite a Gmail API.
- 3
Configure a tela de consentimento e os usuários de teste ou a publicação exigida pela organização.
- 4
Crie um cliente OAuth do tipo Aplicativo da Web.
- 5
No Atendeu Rápido, abra Configuração > Configurações > Apps > Google e selecione Novo App Google.
- 6
Copie da tela o Redirect URI e cadastre exatamente o mesmo valor como URI de redirecionamento autorizado.
Criar e autorizar o canal
- 1
Em Administração > Canais, selecione Adicionar Canal.
- 2
Escolha Webmail (Gmail), informe um nome claro e conclua os campos de direcionamento disponíveis.
- 3
Salve o canal antes de iniciar a autorização, quando a tela solicitar essa ordem.
- 4
Abra a edição do canal e selecione Configurar OAuth ou Conectar.
- 5
Entre com a conta Google correta e aceite somente os acessos previstos para o atendimento.
- 6
Retorne ao Atendeu Rápido e confirme os estados Autenticado e Conectado.
Configurar o envio e validar
- 1
Se a tela solicitar SMTP, ative a verificação em duas etapas na conta usada pela empresa.
- 2
Gere uma senha de aplicativo no Google e informe-a somente no campo protegido.
- 3
Envie um e-mail de uma conta externa para a caixa conectada.
- 4
Confirme a criação do ticket e responda pela tela de atendimento.
- 5
Verifique se a resposta chegou com o remetente e o assunto corretos.
- redirect_uri_mismatch: compare protocolo, domínio, caminho e barra final do Redirect URI.
- Acesso negado: confira usuário de teste, publicação do consentimento e política da conta corporativa.
- Falha no envio: revise usuário SMTP, senha de aplicativo e bloqueios da conta.
- E-mail não vira ticket: confirme canal conectado, destinatário e regra de direcionamento.
Se ainda houver dúvida, continue pelos artigos relacionados abaixo.