Cada app do Google Chat que você cria precisa de um Projeto do Google Cloud com a API Chat ativada e configurada. Esta página mostra como configurar a API Chat.
Pré-requisitos
- Uma empresa Conta do Google Workspace com acesso a Google Chat.
- Crie um projeto do Google Cloud.
- Configure a tela de permissão OAuth.
- Ative a API Google Chat.
Escolha um nome de exibição, avatar e descrição para o app do Chat
Para chamar a API Chat, você precisa configurar uma App Google Chat com as seguintes informações:
Campo | Descrição | Formato |
---|---|---|
Nome do app | O nome de exibição do app do Chat. | Até 25 caracteres alfanuméricos |
URL do avatar | A imagem que aparece como o nome do seu app do Chat avatar. | Um URL HTTPS que aponta para uma imagem quadrada (PNG ou JPEG). O tamanho recomendado é de 256 por 256 pixels ou mais. |
Descrição | Uma breve descrição de que a finalidade App Chat. | Até 40 caracteres alfanuméricos |
O nome, o avatar e a descrição do app do Chat são exibidos para os usuários na interface do Chat. Para algumas APIs Chat de gravação, o Chat usa essas informações para atribuir os ações que um app do Chat realiza no Chat.
Por exemplo, se você chamar o método spaces.create()
, o Chat
inclui o nome do app do Chat no
descrição de quem criou o espaço, conforme mostrado na imagem abaixo:
![O app Google Chat cria um espaço para um usuário.](https://developers.google.cn/static/workspace/chat/images/auth-user-create-space.png?authuser=19&hl=pt-br)
spaces.create()
é usado para criar um
em nome de um usuário.
Para interagir com os apps do Chat, os usuários também podem ver ou usar este informações da seguinte maneira:
- Invoque o app do Chat @mencionando o nome dele.
- Encontre e inicie uma mensagem direta com o app do Chat. No menu Apps, as mensagens diretas exibem o Nome e avatar do app de chat.
- Na barra de escrita, os usuários podem navegar pelos apps do Chat e conferir nome, avatar e descrição.
Configurar o app do Chat no console do Google Cloud
Quando tiverem os detalhes do app do Chat, abra o Cloud e configure a API Chat:
No console do Google Cloud, acesse a página da API Chat e clique no Configuração:
Em Informações do aplicativo, preencha o Nome do aplicativo, o URL do avatar, e Descrição.
Em "Recursos interativos", clique no botão de alternância Ativar recursos interativos. para desativar os recursos interativos do App Chat. Você pode configurar isso mais tarde. Para saber mais sobre como configurar e criar recursos interativos, consulte Receber e responder a interações do usuário.
Opcional: em Registros, marque a caixa de seleção Registrar erros no Logging para usar o Google Cloud Logging. Para mais informações, consulte Registros de erros de consulta para apps do Chat.
Clique em Salvar.
Conceder a outras pessoas permissão para configurar um app do Chat
Você pode conceder acesso a usuários específicos para a página de configuração do app do Chat. Use o IAM para proprietário de apps de chat e leitor de apps de chat papéis de segurança na nuvem. Os usuários com estas funções não podem acessar os apps do Chat de configuração do Terraform usando as APIs e de serviços, mas pode acesse a página de configuração no console do Google Cloud da Projeto host do Cloud do app de chat da seguinte forma:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
Em que PROJECT_ID
é o ID do projeto da
Projeto do Google Cloud que hospeda o app do Chat.
Temas relacionados
- Escolher a arquitetura de um app do Chat
- Se quiser configurar o app do Chat para recursos interativos, faça o seguinte: consulte Receber e responder a interações do usuário