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. 1

    No Atendeu Rápido, abra Administração > Canais > Adicionar Canal, escolha Webmail (Gmail) e expanda Configuração OAuth2.

  2. 2

    Anote o Redirect URI exibido no seu ambiente; não copie um endereço de print ou de outro cliente.

  3. 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. 4

    Crie um cliente OAuth do tipo Aplicativo da Web e cadastre exatamente aquele Redirect URI como redirecionamento autorizado.

  5. 5

    Guarde Client ID e Client Secret do mesmo cliente OAuth em local seguro para preencher o formulário.

Novo canal Webmail Gmail com nome, canal padrão e Configuração OAuth2 expandida
A própria tela do canal mostra a sequência de preparação no Google Cloud. O print contém apenas o formulário vazio.
Imagem ampliada

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. 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. 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. 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. 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. 1

    No novo canal Webmail (Gmail), informe Nome do Canal e revise Canal padrão e Atribuições.

  2. 2

    Expanda Configuração OAuth2 (Recomendado para Gmail) e preencha Client ID e Client Secret do cliente OAuth escolhido.

  3. 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. 4

    Acione Configurar OAuth2 e siga a autorização apresentada. Verifique qual conta Google foi selecionada e conceda apenas os acessos esperados.

  5. 5

    Conclua a criação do canal conforme os comandos exibidos e confirme seu estado na lista Canais / Sessões.

Campos atuais Client ID e Client Secret do Gmail OAuth2, vazios e sem o URI técnico
Use as credenciais do mesmo cliente OAuth. O URI de retorno foi retirado do recorte por segurança; copie-o diretamente do sistema.
Imagem ampliada

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.

Seção atual Configuração SMTP de um canal Gmail com campos vazios de usuário e senha de aplicativo
SMTP aparece como seção separada; a imagem não contém dados de uma conta real.
Imagem ampliada

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. 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. 2

    No Atendeu Rápido, procure o atendimento desse teste e confira remetente, assunto, conteúdo e direcionamento esperado.

  3. 3

    Responda pelo ticket com o texto Recebido no teste AR-001. Esta é uma resposta de validação.

  4. 4

    Volte à caixa externa e confira se a resposta chegou, se veio da conta esperada e se mantém o contexto do assunto.

  5. 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.