Programar reuniões no Google Chat

Nível de programação: intermediário
Duração: 25 minutos
Tipo de projeto: complemento do Google Workspace que estende o Chat.

Objetivos

• Entenda o que a solução faz.
• Entenda o que os serviços do Apps Script fazem na solução.
• Prepare o ambiente.
• Configure o script.
• Execute o script.

Sobre esta solução

Agende uma reunião no Google Agenda usando uma mensagem direta ou um espaço no Google Chat. Você pode definir detalhes específicos para a reunião, como assunto, horário de início ou duração, ou usar as configurações padrão para o agendamento de reuniões instantâneas.

Como funciona

O script do app Chat usa comandos de barra e caixas de diálogo para receber detalhes da reunião dos usuários e programar um evento da agenda. O script inclui configurações padrão de reunião que podem ser personalizadas para atender às suas necessidades.

Serviços do Apps Script

Esta solução usa os seguintes serviços:

• Serviço de agenda: cria o evento da agenda com base nas informações da reunião fornecidas.
• Serviço básico: usa a classe Session para receber o fuso horário do script. A Agenda usa esse fuso horário ao programar o evento.
• Serviço de utilitários: formata a data do evento da agenda e codifica o ID do evento para ajudar a receber o URL.

Pré-requisitos

• Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat.

• Um projeto do Google Cloud. Para criar um, consulte Criar um projeto do Google Cloud.

Configurar o ambiente

Abra seu projeto na nuvem no console do Google Cloud.

Se ele ainda não estiver aberto, abra o projeto na nuvem que você pretende usar para esta amostra:

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

   Selecione um projeto na nuvem

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

Ativar a API

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

• No seu projeto na nuvem, ative a API Google Chat.

  Ativar a API

Configurar a tela de permissão OAuth

Todos os apps do Chat exigem uma configuração de tela de consentimento. Ao configurar a tela de permissão do OAuth do seu app, você define o que o Google mostra aos usuários e registra o app para que ele possa ser publicado mais tarde.

1. No console do Google Cloud, acesse Menu > Google Auth platform > Branding.

   Acessar Branding

2. Se você já tiver configurado o Google Auth platform, poderá definir as seguintes configurações da tela de permissão OAuth em Branding, Público-alvo e Acesso a dados. Se você receber uma mensagem informando que Google Auth platform ainda não foi configurado, clique em Começar:
1. Em Informações do app, no campo Nome do app, insira um nome para o app.
2. Em E-mail para suporte do usuário, escolha um endereço de e-mail de suporte para que os usuários possam entrar em contato com você se tiverem dúvidas sobre o consentimento deles.
3. Clique em Próxima.
4. Em Público-alvo, selecione Interno.
5. Clique em Próxima.
6. Em Informações de contato, insira um Endereço de e-mail para receber notificações sobre mudanças no seu projeto.
7. Clique em Próxima.
8. Em Concluir, leia a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a Política de dados do usuário dos serviços de API do Google.
9. Clique em Continuar.
10. Clique em Criar.
3. Por enquanto, você pode pular a adição de escopos. No futuro, quando você criar um app para uso fora da sua organização do Google Workspace, mude o Tipo de usuário para Externo. Em seguida, adicione os escopos de autorização necessários para o app. Para saber mais, consulte o guia completo Configurar a permissão OAuth.

Configurar o script

Criar o projeto do Apps Script

1. Clique no botão a seguir para abrir o projeto do Apps Script Agendar reuniões no Google Chat.
   Abrir o projeto
2. Clique em Visão geral .
3. Na página de visão geral, clique em Fazer uma cópia .

Criar uma implantação de teste

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

Configurar a API Chat

1. No console do Google Cloud, acesse a página API Chat.
   Acessar a API Chat
2. Clique em Configuração.
3. Configure a API Chat com as seguintes informações:
   • Nome: Meeting Scheduler
   • URL do avatar: https://goo.gle/3SfMkjb.
   • Descrição: Quickly create meetings.
   • Funcionalidade: marque as duas caixas para permitir que os usuários enviem mensagens diretamente para o app e o adicionem a espaços.
   • Configurações de conexão: clique em Apps Script e insira o ID de implantação principal.
   • Comandos: adicione comandos de barra para /help e /schedule_Meeting seguindo estas etapas:
     1. Clique em Adicionar comando e configure-o com as seguintes informações:
        • ID do comando: 1.
        • Descrição: Learn what this app does.
        • Tipo de comando: Slash command.
        • Nome do comando de barra: /help.
     2. Clique em Adicionar comando novamente e configure com as seguintes informações:
        • ID do comando: 2.
        • Descrição: Schedule a meeting.
        • Tipo de comando: Slash command.
        • Nome do comando de barra: /schedule_Meeting.
        • Marque a caixa Abre uma caixa de diálogo.
   • Permissões: selecione Pessoas e grupos específicos do seu domínio e digite seu endereço de e-mail.
4. Clique em Salvar.

Executar o script

1. Abra o Google Chat.

   Acessar o Google Chat

2. Clique em Iniciar um chat .

3. Pesquise o nome do app, Meeting Scheduler.

4. Envie uma mensagem inicial, como hello, para solicitar a autorização.

5. Quando o app responder, clique em Configurar e autorize o app. Se a tela de permissão OAuth mostrar o aviso Este app não foi verificado, selecione Avançado > Acessar {Nome do projeto} (não seguro).

6. Envie /schedule_Meeting para o app.

7. Na caixa de diálogo, adicione pelo menos um endereço de e-mail do convidado. Você pode atualizar os outros campos ou usar as entradas padrão.

8. Clique em Enviar.

9. Para ver a reunião, clique em Abrir evento da Agenda.

Revisar o código

Clique para revisar o código do Apps Script desta solução hospedada no GitHub:

Ver no GitHub

Próximas etapas

• Estender o chat
• Criar um app do Google Chat com o Apps Script