GSP250

Visão geral

Os bots do Google Chat fornecem pontos de acesso fáceis de usar para os dados e serviços da sua organização. Os usuários podem conversar com os bots em um chat. Para criá-los, uma das opções é usar o Google Apps Script. Isso também facilita o acesso a outros Serviços do Google, como Drive, Gmail, Agenda, Documentos, Planilhas e muito mais.

Neste laboratório, você vai aprender como funcionam os bots do Google Chat. Para isso, vamos criar um bot simples do Google Chat usando o Google Apps Script.

Atividades deste laboratório

Neste laboratório, você vai executar as seguintes tarefas:

• Criar um app de chat usando um modelo com manipuladores de eventos pré-preenchidos.
• Configurar e publicar o bot do Google Chat.

Configuração e requisitos

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.

• Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.

Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.

Como iniciar seu laboratório e fazer login no console do Google Cloud

1. Clique no botão Começar o laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento. No painel Detalhes do Laboratório, à esquerda, você vai encontrar o seguinte:

   • O botão Abrir Console do Google Cloud
   • O tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações, se forem necessárias

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Username"}}}

   Você também encontra o nome de usuário no painel Detalhes do Laboratório.

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de Olá.

   {{{user_0.password | "Password"}}}

   Você também encontra a senha no painel Detalhes do Laboratório.

6. Clique em Próxima.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.

Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.

Tarefa 1: Criar um app de chat usando um modelo

Para implementar o bot, crie um projeto do Google Apps Script usando o modelo de app de chat.

Observação: fazer login no console do Google Cloud configura o projeto e as credenciais. Antes de clicar no link do editor do Apps Script na etapa 1, faça login no console do Google Cloud.

1. Clique neste link da página inicial do Google Apps Script para abrir o editor on-line.

2. Em Inicializadores de complementos do Google Workspace, clique em App de chat (versão intermediária).

3. Clique em Projeto sem título (nome atual).

4. Na caixa de diálogo Editar nome do projeto, renomeie o projeto como Friendly Bot e clique em Renomear.

Eventos do Google Chat

A maioria das interações do bot do Apps Script com o Google Chat é baseada em eventos. A interação entre o usuário, o bot e o Google Chat geralmente segue uma sequência.

1. Um usuário inicia uma ação, como adicionar um bot a uma sala, iniciar uma mensagem direta com um bot ou remover o bot de uma sala.
2. A ação gera um evento destinado ao bot no Google Chat.
3. O Google Chat chama o manipulador de eventos correspondente definido no script do bot.

O Google Chat gera quatro eventos que seu bot do Apps Script pode detectar:

• ADDED_TO_SPACE: ocorre quando um usuário adiciona um bot a uma sala ou mensagem direta. No Apps Script, defina uma função onAddedToSpace() para processar esse evento.
• REMOVED_FROM_SPACE: ocorre quando um usuário remove o bot de uma sala ou mensagem direta. Esse evento não posta uma resposta no Google Chat. No Apps Script, defina uma função onRemoveFromSpace() para processar esse evento.
• MESSAGE: ocorre quando um usuário envia uma mensagem direta ou menciona o bot com "@" em uma sala. No Apps Script, defina uma função onMessage() para responder a esse evento.

Atualizar o código do manipulador de eventos MESSAGE

O modelo app de chat preenche automaticamente o arquivo de código que contém os manipuladores de eventos.

• Clique no arquivo Code.gs para ver os manipuladores de eventos pré-preenchidos.

Preste atenção aos manipuladores dos eventos MESSAGE, ADDED_TO_SPACE e REMOVE_FROM_SPACE, que executam as funções específicas mencionadas anteriormente para concluir várias tarefas, como responder a mensagens de usuários no Google Chat.

Criar um app de chat usando um modelo

Tarefa 2: Publicar e testar o chatbot

Antes de executar e testar o bot, a API Google Chat precisa ser ativada no seu projeto do Google Cloud, e o bot precisa ser publicado.

Nesta tarefa, você vai concluir toda a configuração para publicar o bot, incluindo a configuração da tela de permissão OAuth, a atualização do aplicativo Apps Script para referenciar o projeto certo do Google Cloud e a configuração da API Google Chat para publicar o bot para testes.

Configurar a tela de permissão OAuth

1. Acesse o console do Google Cloud, clique no Menu de navegação () no canto superior esquerdo e navegue até APIs e serviços > Tela de permissão OAuth.

2. Clique em Vamos começar.

3. Na página de configuração do projeto, em Informações do app, configure o seguinte e clique em Próxima:

Campo	Valor
Nome do app	Friendly Bot
E-mail para suporte do usuário	Selecione o ID de e-mail no menu suspenso. Esse também é seu E-mail do usuário, que aparece no painel à esquerda das instruções do laboratório.

4. Em Público-alvo, selecione Interno e clique em Próxima.

5. Em Dados de contato, forneça o endereço de e-mail e clique em Próxima.

6. Aceite a política e clique em Continuar e depois em Criar.

Clique em Verificar meu progresso para conferir o objetivo.

Configurar a tela de consentimento do usuário

Identificar o número do projeto do Google Cloud e atualizar o aplicativo do Apps Script para fazer referência a ele

1. No Menu de navegação (), clique em Visão geral do Cloud > Painel.

2. No painel, procure a seção Informações do projeto.

3. Anote o número do projeto para usar na próxima etapa e configurar seu projeto.

4. Volte ao editor do Apps Script e navegue até as Configurações do projeto do Friendly Bot ().

5. Em Projeto do Google Cloud Platform (GCP), clique em Alterar projeto.

6. Em Número do projeto do GCP, insira o número que você copiou anteriormente. Em seguida, clique em Definir projeto.

Configurar e publicar o chatbot

1. No editor do Apps Script, clique em Implantar > Testar implantações (canto superior direito da tela) para conferir o ID da implantação principal do teste. Depois clique em Copiar ao lado do ID da implantação principal.

2. No console do Google Cloud, acesse Menu de navegação () > APIs e serviços > Biblioteca.

3. Na biblioteca, pesquise API Google Chat e selecione a API na lista de resultados.

A API Google Chat já deve estar ativada nesse projeto. Caso contrário, clique em Ativar.

4. Clique em Gerenciar e na guia Configuração da API Google Chat.

5. Na caixa de diálogo Configuração, defina os campos com os seguintes valores:

Campo	Valor
Nome do app	Friendly Bot
URL do avatar	https://goo.gl/kv2ENA
Descrição	Bot do laboratório do Apps Script
Funcionalidade	Ativar a opção Participar de espaços e conversas em grupo
Configurações de conexão	Marque Apps Script e cole no campo ID de implantação aquele ID de implantação principal que você copiou na etapa 1.
Visibilidade

6. Clique em Salvar.

7. Depois que as mudanças forem salvas, role até a parte de cima da caixa de diálogo Configuração para atualizar o Status do app para ATIVO: disponível aos usuários.

Talvez seja necessário atualizar a página para ver o campo Status do app. Se o valor de Status do app já for ATIVO: disponível aos usuários, você pode deixar esse valor, mas salve a página novamente na próxima etapa.

8. Clique em Salvar novamente.

Testar o chatbot

Você chegou à seção final para testar seu bot no Google Chat. Agora siga estas etapas:

1. Clique no link Google Chat para abrir o app.

2. Selecione Iniciar um chat.

3. Pesquise Friendly bot.

4. Nos resultados, selecione o Friendly Bot (bot do laboratório do Apps Script) que você criou. Isso vai iniciar um chat.

Quando a conversa for aberta, você vai ver uma mensagem do bot agradecendo por adicioná-lo a uma mensagem direta.

Thank you for adding me to a direct message, student XXXXX!

Essa resposta é iniciada pela função onAddedToSpace, que responde ao evento específico de adição do bot a um espaço de chat.

5. Por fim, mande uma mensagem para o bot, como "Olá, bot!".

O bot vai responder repetindo sua mensagem. Por exemplo:

You said "Olá, bot!"

Essa resposta é iniciada pela função onMessage, que responde ao evento específico de usuários que enviaram mensagens diretas ao bot.

Parabéns!

Você criou rapidamente um bot do Google Chat que responde às mensagens dos usuários.

Próximas etapas / Saiba mais

• Confira outros recursos que o Workspace oferece:
  • Google Apps Script: acesse as Planilhas Google, o Maps e o Gmail usando apenas quatro linhas de código
• Confira estes recursos úteis:
  • Site da documentação do Google Chat
  • Guia de início rápido de bots do Apps Script
  • Como criar novos bots
  • Como publicar bots
  • Como criar cards interativos
  • Referência dos cards
  • Referência de objetos de evento
  • Referência do serviço avançado do Gmail
  • Referência da API Calendar Apps Script
  • Centro de aprendizagem do Google Workspace

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Manual atualizado em 18 de agosto de 2025

Laboratório testado em 18 de agosto de 2025

Copyright 2025 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.