Skip to main content

Google Chat

⚒️ Credenciais​

Este guia explica como criar as credenciais de acesso no Google Cloud Platform (GCP) e baixar o arquivo credentials.json para que nosso sistema consiga interagir com o Google Chat em nome do seu bot.

1. Acesse o Google Cloud Platform​

  • Entre em: https://console.cloud.google.com

  • Se ainda não tiver uma conta Google ou não estiver logado, o site vai pedir login.

  • Caso seja a primeira vez, o Google pode pedir para aceitar os termos e criar um projeto inicial. Siga os passos básicos até chegar ao painel principal.

2. Crie ou selecione um projeto​

(Se você já tiver um projeto configurado da Digital Contact Bots, pule para o passo 4).

No topo da tela, o Google vai mostrar o nome do projeto atual. Se você ainda não tiver um, clique em Selecionar Projeto → Novo Projeto.

Dê um nome simples, como: MeuBotGoogleChat.

Clique em Criar e aguarde alguns segundos.

Dica

Cada projeto é como uma “pasta” que organiza recursos e credenciais. Tudo do seu bot ficará dentro desse projeto.

3. Ative a Google Chat API​

  1. No menu de navegação, vá em APIs e Serviços. Imagem APIS
  2. Clique em Ativar APIs e Serviços (ou vá direto para a pesquisa da biblioteca).
  3. Pesquise por Google Chat API e clique nela. Imagem APIS 2
  4. Clique em Ativar. Imagem APIS 3

Pronto, seu projeto agora tem acesso à API do Google Chat.

4. Configure seu Bot​

  1. Na página da Google Chat API, clique em Gerenciar.

  2. No menu lateral, clique em Configurações.

  3. Preencha as informações básicas do seu bot:

    • Nome do bot → O nome que vai aparecer para os usuários.
    • Descrição → Breve explicação do que ele faz.
    • URL do avatar → Um link para a imagem do bot (opcional, mas recomendado). Imagem APIS 3

  4. Adicione a URL do Webhook (extremamente importante!):

    • Este é o endereço para onde o Google Chat vai enviar as mensagens recebidas.
    • Cole aqui a URL de integração da Digital Contact Bots (ex.: https://api.boteria.com.br/google-chat/webhook/<BOT_ID>). Imagem APIS 3

  5. Clique em Salvar.

5. Crie Credenciais de Conta de Serviço​

Agora precisamos do arquivo JSON de autenticação, que permitirá ao seu sistema conversar com o Google Chat.

  1. No menu lateral, clique em APIs e Serviços → Credenciais.
  2. Clique em Criar Credenciais → Conta de Serviço. Imagem APIS 3
  3. Preencha os campos obrigatórios (nome da conta de serviço e descrição).
  4. Clique em Criar e Continuar até chegar ao final do assistente. Imagem APIS 3
  5. Após criar a conta, clique sobre o email da conta de serviço recém-criada na lista.
  6. Vá para a aba Chaves.
  7. Clique em Adicionar Chave → Criar nova chave.
  8. Selecione o tipo JSON e clique em Criar.

O Google vai gerar e baixar automaticamente o arquivo, que terá um nome como credentials.json. Guarde-o com segurança. Esse é o passaporte do seu bot.

Atenção

O site não gera automaticamente, será necessário copiar a chave exposta e colar dentro do arquivo em sua máquina no campo 'private_key_id'.

✅ Pronto!​

Você agora tem:

  • A Google Chat API ativada.
  • Seu bot configurado com o webhook.
  • O arquivo credentials.json para autenticação no seu sistema.

Use esse arquivo na configuração do seu bot no sistema Digital Contact Bots para que ele possa enviar e receber mensagens do Google Chat.

Como localizar o aplicativo no campo de busca do Chat​

  1. Acesse o Google Chat no seu navegador ou aplicativo.
  2. No canto superior esquerdo, localize a barra de pesquisa.
  3. Digite o nome do aplicativo que deseja encontrar (no exemplo, "L.I.G.O").
  4. Aguarde a lista de resultados aparecer abaixo da barra de pesquisa.
  5. Clique sobre o aplicativo listado em "Apps" para abri-lo.

Imagem APIS 3

Comportamento de mídias no Google Chat​

O sistema envia todas as mídias em formato de texto, utilizando URLs para referência ao conteúdo. O comportamento varia de acordo com o tipo de mídia:

  • Imagem: Enviada com URL.
    • A imagem pode ser renderizada no chat para o cliente. Isso ocorre porque, em alguns casos, o Google pode renderizar a imagem diretamente, mantendo o binário associado à URL.
  • Áudio: Enviado apenas com URL.
    • O arquivo de áudio não é incorporado no payload, apenas referenciado.
  • Documento: Enviado apenas com URL.
    • O documento é acessado diretamente a partir do link fornecido.
  • Vídeo: Enviado apenas com URL.
    • O vídeo não é renderizado inline, sendo necessário acessar o link para visualização.
Observação

A diferença no envio de imagens (URL + mídia renderizada) em comparação aos demais formatos se deve a como determinadas plataformas tratam a renderização e o armazenamento do conteúdo.

Sessão ✍️​

A sessionKey do canal é composta por google-chat-{userId}-{botId}. Sendo que o userId pode seguir um modelo de users/{id}.