Configurar a API Google Chat

Cada app do Google Chat que você cria requer um projeto do Google Cloud com a API Chat ativada e configurada. Nesta página, mostramos como configurar a API Chat.

Pré-requisitos

Configurar a API Chat

  1. No console do Google Cloud, pesquise "API Google Chat", clique em API Google Chat e em Gerenciar.

    Acessar a API Chat

  2. Clique na guia Configuração e insira as seguintes informações necessárias:

    • Nome do app: o nome que as pessoas usam ao interagir com seu app do Chat.
    • URL do avatar: um URL HTTPS que aponta para uma imagem quadrada (por exemplo, PNG ou JPEG) de pelo menos 128 x 128 que aparece como o avatar do seu app do Chat.
    • Descrição: uma descrição da finalidade do app do Chat que aparece abaixo do nome do app do Chat.

  3. Para ativar os recursos interativos, clique em Ativar recursos interativos, que permite que os usuários interajam com o app do Chat, e use a tabela a seguir para concluir a configuração:

    Field Descrição
    Funcionalidade Um conjunto de campos que determina como o app do Chat pode interagir com os usuários:
    • Receber mensagens individuais: os usuários podem encontrar e enviar mensagens para o app do Chat no Google Chat.
    • Participar de espaços e conversas em grupo: os usuários podem adicionar o app Chat a espaços e conversas em grupo.
    Configurações de conexão O endpoint do app do Chat, que é um destes:
    • URL do app: um endpoint HTTPS que hospeda a implementação do app do Chat.
    • Projeto do Apps Script: um ID de implantação para um projeto do Apps Script que implementa um app do Chat.
    • Nome do tópico do Cloud Pub/Sub: um tópico do Pub/Sub que o app do Chat assina como um endpoint.
    • Dialogflow: registra o app do Chat com uma integração com o Dialogflow. Para mais informações, consulte Criar um app do Dialogflow para o Google Chat que entenda linguagem natural.
    Comandos de barra Comandos que podem ser exibidos aos usuários no Google Chat. Permite que os usuários confiram as ações principais do seu app do Chat no Google Chat e escolham uma ação específica. Para mais informações, consulte Responder a comandos de barra como um app do Chat.
    Visualizações de links Padrões de URL que o app do Chat reconhece e disponibiliza mais conteúdo para quando os usuários enviam links. Para mais informações, consulte Visualizar links.
    Visibilidade Até cinco pessoas ou um ou mais Grupos do Google podem acessar e instalar o app do Chat. Use este campo para testar o app do Chat ou compartilhar o app com sua equipe. Para mais informações, consulte Configurações de visibilidade e publicação do app do Chat.

  4. Para registrar erros no Cloud Logging sempre que o app do Chat retornar um erro, marque a caixa de seleção Registrar erros no Logging. Para mais informações, consulte Registros de erros de consulta para apps do Chat.

  5. Clique em Salvar. Quando você salva a configuração do app do Chat, ele fica disponível para os usuários especificados na organização do Google Workspace.

Conceder a outras pessoas permissão para configurar um app do Chat

É possível conceder acesso a usuários específicos à página de configuração do app do Chat. Use os papéis do IAM Proprietário dos apps do Chat e Visualizador de apps do Chat. Os usuários com esses papéis não podem navegar até a página de configuração dos apps do Chat usando o painel APIs e serviços, mas podem acessar a página de configuração navegando até o console do Google Cloud para o projeto host do app do Chat da seguinte maneira:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Em que PROJECT_ID é o ID do projeto do Google Cloud que hospeda o app do Chat.