Guia de início rápido do app Chat do Google Apps Script

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Crie um app Google Chat que você possa enviar mensagens e responder usando eco.

Objetivos

  • Configurar o ambiente.
  • Configure o script.
  • Publique o app.
  • Execute o script.

Pré-requisitos

Configurar o ambiente

Abra seu projeto do Cloud no console do Google Cloud

Abra o projeto do Cloud que você pretende usar neste exemplo, caso ele ainda não esteja aberto:

  1. No console do Google Cloud, acesse a página Selecionar um projeto.

    Selecionar um projeto do Cloud

  2. Selecione o projeto do Google Cloud que você quer usar. Se preferir, clique em Criar projeto e siga as instruções exibidas na tela. Se você criar um projeto do Google Cloud, talvez seja necessário ativar o faturamento para o projeto.

Ativar a API Chat

Antes de usar as APIs do Google, você precisa ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.

  • No console do Google Cloud, ative a API Google Chat.

    Ativar a API

Todos os apps que usam o OAuth 2.0 exigem uma configuração de tela de consentimento. A configuração da tela de permissão OAuth do app define o que é exibido aos usuários e avaliadores e registra o app para que você possa publicá-lo mais tarde.

  1. No console do Google Cloud, acesse Menu > APIs e serviços > Tela de permissão OAuth.

    Acessar a tela de permissão OAuth

  2. Selecione o tipo de usuário do seu app e clique em Criar.
  3. Preencha o formulário de registro do app e clique em Salvar e continuar.

  4. Por enquanto, você pode pular a adição de escopos e clicar em Salvar e continuar. No futuro, quando você criar um app para uso fora da organização do Google Workspace, vai ser necessário adicionar e verificar os escopos de autorização exigidos.

  5. Se você tiver selecionado Externo para o tipo de usuário, adicione usuários de teste:
    1. Em Testar usuários, clique em Adicionar usuários.
    2. Insira seu endereço de e-mail e outros usuários de teste autorizados e clique em Salvar e continuar.
  6. Leia o resumo do registro do app. Para fazer alterações, clique em Editar. Se o registro do app parecer OK, clique em Voltar ao painel.

Configurar o script

Para configurar o script, use um modelo e defina seu projeto do Cloud no Apps Script.

Criar o script a partir do modelo

  1. Acesse a página Primeiros passos do Apps Script.
  2. Clique no modelo App de chat. Talvez seja necessário rolar para baixo para ver esse modelo.
  3. Clique em Projeto sem título, digite Quickstart app e clique em Renomear.

Copiar o número do projeto do Cloud

  1. Acesse seu projeto do Cloud no Console do Google Cloud.
  2. Clique em Configurações e utilitários > Configurações do projeto.
  3. Copie o número do projeto.

Definir o projeto do Cloud no projeto do Apps Script

  1. No projeto do Apps Script do Chat, clique em Configurações do projeto Ícone de configurações do projeto.
  2. Em Projeto do Google Cloud Platform (GCP), clique em Alterar projeto.
  3. Em GCP project number, cole o número do projeto do Google Cloud.
  4. Clique em Definir projeto.

Agora você tem um código de app em funcionamento que pode ser testado (conforme descrito nas etapas abaixo) e depois personalizado para atender aos seus requisitos.

Verifique se você está conectado à Conta do Google correta ao abrir o modelo do Apps Script. Às vezes, a conta atual pode mudar para sua conta padrão sem que você perceba.

Criar uma implantação de teste

Você precisa de um ID de implantação para este projeto do Apps Script para que possa usá-lo na próxima etapa.

Para encontrar o ID de implantação principal, faça o seguinte:

  1. No projeto Apps Script do app Chat, clique em Implantar > Testar implantações.
  2. Copie o ID de implantação principal para usar em uma etapa posterior e clique em Concluído.

Publicar o app Chat

Publique o app de chat no console do Google Cloud.

  1. No console do Google Cloud, pesquise Google Chat API e clique na API Google Chat.
  2. Selecione Gerenciar.

  3. Clique em Configuração e configure o app Chat:

    1. No campo Nome do app, insira Quickstart app.
    2. No campo URL do avatar, insira https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. No campo Descrição, use Quickstart app.
    4. Em "Funcionalidade", selecione Receber mensagens individuais e Participar de espaços e conversas em grupo.
    5. Em "Configurações de conexão", selecione Projeto do Apps Script e cole o ID de implantação no campo.
    6. Em "Permissões", selecione Pessoas e grupos específicos no seu domínio e digite seu e-mail.

  4. Clique em Salvar e atualize a página.

  5. Na página de configuração, em Status do aplicativo, defina o status como Ativo – disponível para os usuários.

  6. Clique em Salvar.

O app Chat está pronto para responder a mensagens.

Executar o script

  1. Abra o Chat.
  2. Envie uma nova mensagem direta para o app clicando em Iniciar um chat > Encontrar apps.
  3. Na página "Encontrar apps", pesquise Quickstart App.
  4. Ao lado de Guia de início rápido, clique em Chat.
  5. Na nova mensagem direta com o app, digite Hello e pressione enter.

Agradecemos por adicionar o app e repetir sua mensagem.

Próximas etapas

  • Criar cards interativos: as mensagens do card são compatíveis com um layout definido, elementos de IU interativos, como botões, e rich media, como imagens. Use mensagens de cartão para apresentar informações detalhadas, coletar informações dos usuários e orientá-los a avançar.
  • Suporte a comandos de barra: os comandos de barra permitem registrar e anunciar comandos específicos que os usuários podem fornecer ao app digitando um comando que começa com uma barra (/), como /help.
  • Caixas de diálogo de inicialização: são caixas de diálogo baseadas em janelas que o app pode abrir para interagir com um usuário. Vários cartões podem ser conectados sequencialmente, o que ajuda os usuários a concluir processos de várias etapas, como o preenchimento de dados do formulário.