Configurar a API Google Chat

Cada app do Google Chat criado requer o próprio 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 selecione Gerenciar.

    Acessar a API Chat

  2. Clique na guia Configuration 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 app do Chat.
    • Descrição: uma descrição da finalidade pretendida do app do Chat, que aparece abaixo do nome dele.

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

    Campo Descrição
    Funcionalidade Um conjunto de campos que determina como o app de chat pode interagir com os usuários:
    • Receber mensagens individuais: os usuários podem encontrar e enviar mensagens para o app do Chat diretamente 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 de 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 endpoint.
    • Dialogflow: registra o aplicativo do Chat com uma integração com o Dialogflow. Para mais informações, consulte Criar um app do Google Chat no Dialogflow que entenda linguagem natural.
    Comandos de barra Comandos que podem ser exibidos aos usuários no Google Chat. Permite que os usuários vejam as ações principais do seu app no Google Chat e escolham uma ação específica com que querem interagir. 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 oferece conteúdo adicional para quando os usuários enviarem 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 para compartilhar o app do Chat com sua equipe. Confira mais informações em Configurações de visibilidade e publicação do app do Chat.

  4. Para registrar erros no Cloud Logging sempre que o app de chat retornar um erro, marque a caixa de seleção Registrar erros no Logging. Saiba mais em 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.

Permitir que outras pessoas configurem 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 Leitor 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 de 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 Cloud 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.