Conectar o Gmail ao atendimento por OAuth
Configure Webmail (Gmail) com OAuth2, diferencie o App Google opcional do canal e teste entrada e resposta em um ticket.
Neste artigo
Antes de começar
- Conta Google autorizada pela empresa
- Projeto Google Cloud e cliente OAuth para Aplicativo da Web, se usar credenciais próprias
- Gmail API e consentimento configurados no projeto dessas credenciais
- Conta de teste externa para validar recebimento e resposta
Escolher o caminho correto
No novo canal Webmail (Gmail), Configuração OAuth2 é o caminho recomendado na tela atual. Ela autoriza o acesso à caixa com credenciais de aplicativo, sem colocar a senha pessoal da conta Google no formulário. Configuração SMTP (Envio) é uma seção separada e só deve ser usada quando a operação precisar desse método e o provedor o permitir.
Preparar as credenciais OAuth2 próprias
- 1
No Atendeu Rápido, abra Administração > Canais > Adicionar Canal, escolha Webmail (Gmail) e expanda Configuração OAuth2.
- 2
Anote o Redirect URI exibido no seu ambiente; não copie um endereço de print ou de outro cliente.
- 3
No Google Cloud da empresa, crie ou selecione um projeto, habilite a Gmail API e configure a tela de consentimento com os usuários ou a publicação exigidos pela organização.
- 4
Crie um cliente OAuth do tipo Aplicativo da Web e cadastre exatamente aquele Redirect URI como redirecionamento autorizado.
- 5
Guarde Client ID e Client Secret do mesmo cliente OAuth em local seguro para preencher o formulário.

Quando usar um App Google próprio
Em Configuração > Configurações > Apps > Google, Novo App Google permite cadastrar credenciais da empresa para sobrescrever o aplicativo padrão da plataforma. A lista vazia nessa área, por si só, não significa que não exista configuração padrão. Não cadastre um app próprio apenas porque a lista está vazia.
- 1
Se a empresa optar pelo App Google próprio, abra Novo App Google nessa área e preencha Client ID e Client Secret do mesmo cliente OAuth.
- 2
Cadastre no Google Cloud o Redirect URI fixo exibido nessa tela; confira o valor no seu ambiente, sem transcrevê-lo de uma captura pública.
- 3
Em Serviços habilitados, mantenha Gmail ativo para este uso. Só altere Google Calendar, YouTube ou outros serviços após verificar suas dependências.
- 4
Revise o escopo e conclua o cadastro. Depois volte ao canal Gmail para a autorização da caixa e o teste de mensagens.
Preencher e autorizar o canal Gmail
- 1
No novo canal Webmail (Gmail), informe Nome do Canal e revise Canal padrão e Atribuições.
- 2
Expanda Configuração OAuth2 (Recomendado para Gmail) e preencha Client ID e Client Secret do cliente OAuth escolhido.
- 3
Confira o Redirect URI da tela com o endereço autorizado no Google Cloud. O botão Configurar OAuth2 fica indisponível enquanto faltarem dados necessários.
- 4
Acione Configurar OAuth2 e siga a autorização apresentada. Verifique qual conta Google foi selecionada e conceda apenas os acessos esperados.
- 5
Conclua a criação do canal conforme os comandos exibidos e confirme seu estado na lista Canais / Sessões.

Usar SMTP só se a operação precisar
Configuração SMTP (Envio) mostra Usuário (e-mail de autenticação), Senha de aplicativo e SMTP avançado. A tela avisa que, para Gmail, OAuth2 é mais confiável e a autenticação por senha simples pode ser bloqueada. Só configure SMTP quando esse caminho for necessário e permitido pela política da conta.

Fazer um teste manual de ida e volta
Use duas caixas autorizadas para teste: a caixa Gmail conectada ao canal e outra caixa externa controlada pela equipe. O exemplo abaixo é um roteiro manual, não uma mensagem enviada automaticamente pelo sistema.
- 1
Na caixa externa, crie um e-mail para a caixa conectada com o assunto Teste Gmail — AR-001 e o texto Mensagem fictícia para validar o canal. Não precisa conter anexos ou dados de clientes.
- 2
No Atendeu Rápido, procure o atendimento desse teste e confira remetente, assunto, conteúdo e direcionamento esperado.
- 3
Responda pelo ticket com o texto Recebido no teste AR-001. Esta é uma resposta de validação.
- 4
Volte à caixa externa e confira se a resposta chegou, se veio da conta esperada e se mantém o contexto do assunto.
- 5
Registre o resultado de cada direção e o horário. Se uma etapa falhar, investigue-a separadamente antes de liberar a caixa para a equipe.
Identificar em qual etapa ocorreu a falha
- Botão Configurar OAuth2 indisponível: confira os campos obrigatórios e o cliente OAuth usado antes de tentar autorizar.
- App Google próprio não aparece: confirme se a empresa realmente o cadastrou; uma lista vazia pode usar a configuração padrão da plataforma.
- 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.
