Como configurar o Google Chat no Skyone Studio
Visão Geral
Esta documentação detalha o processo de configuração do Google Chat como canal de publicação no Skyone Studio. A integração permite que agentes de IA interajam diretamente na plataforma do Google, utilizando credenciais de conta de serviço e a ativação de APIs específicas no Google Cloud.
O processo de configuração é dividido entre o console do Google Cloud e o ambiente do Skyone Studio.
Passo a passo
[Passo 01]: Criação e configuração de conta de serviço no Google Cloud
[Passo 02]: Geração da Chave JSON
[Passo 03]: Criar conta do Google Chat no Skyone Studio
[Passo 04]: Configurar publicação no Google Chat
[Passo 05]: Ativação da Google Chat API
[Passo 06]: Definição do App e Endpoint
Passo 1: Criação e configuração de conta de serviço no Google Cloud
Acesse o console do Google Cloud e selecione o projeto desejado.
No menu lateral, navegue até API e Serviços e clique em Credenciais.
Clique em Criar credenciais e selecione a opção Conta de serviço.
No campo Nome da conta de serviço, insira um nome adequado e clique em Criar e continuar.
Na próxima etapa, em Permissões, defina os papéis. Para isso, na caixa seletora pesquise por "Google Chat" e selecione a opção Proprietário de apps do Chat.
Clique na opção Adicionar outro papel e adicione Visualizador de apps do Chat.
Clique em Continuar.
Para finalizar, clique em Concluído.
Passo 2: Geração da Chave JSON
Na lista de contas de serviço, clique sobre a conta recém-criada.
Acesse a aba Chaves.
Clique em Adicionar chave > Criar nova chave.
Selecione o formato JSON e clique em Criar.
Importante: O arquivo será baixado automaticamente em seu computador. Guarde-o em local seguro, pois ele é essencial para a autenticação no Skyone Studio.
Passo 3: Criar conta do Google Chat no Skyone Studio
Acesse o Skyone Studio e navegue até o menu de Publicar.
Selecione a opção Google Chat e clique em Gerenciar contas.
Clique em Criar conta.
No campo de Chave da conta de serviço, realize o upload do arquivo JSON baixado anteriormente.
Clique em Criar.
Passo 4: Configurar publicação no Google Chat
Ainda na área Publicar, selecione o fluxo do agente desejado.
Em Usuários e Grupos, selecione um usuário existente ou crie um novo.
Clique em Salvar Publicação.
Copie a URL de Webhook exibida na tela. Você precisará deste dado para os próximos dados da integração.
Clique em Concluir para finalizar o processo.
Passo 5: Ativação da Google Chat API
Retorne ao console do Google Cloud e selecione o menu APIs e Serviços.
Verifique se a Google Chat API consta na lista de serviços ativados.
Caso a API não esteja visível, clique em Ativar APIs e Serviços.
Pesquise por "Google Chat API" no campo de busca e selecione o resultado correspondente.
Clique em Ativar para habilitar o recurso.
Confirme se a Google Chat API agora é exibida na sua lista de serviços ativos para dar continuidade na integração.
Passo 6: Definição do App e Endpoint
Após a ativação anterior, clique na aba Configuração.
Em Status do app, selecione a opção Ativo, disponível aos usuários.
Em Informações do aplicativo, preencha as informações básicas:
Nome do app: Defina o nome que aparecerá no chat.
URL do avatar: Link para a imagem de perfil do aplicativo.
Descrição: Breve resumo da funcionalidade do bot.
No campo URL do endpoint HTTP, cole a URL gerada pelo Skyone Studio (copiada da tela de publicação do canal).
Deixe ativo a opção Ativar recursos interativos.
Em Configurações de conexão, selecione a opção URL do endpoint do HTTP.
Em Gatilhos, selecione a opção Usar um URL do endpoint do HTTP para todos os gatilhos.
No campo URL do endpoint do HTTP, cole a URL da etapa 4.
Em Visibilidade, ative a opção Disponibilizar o app de chat para pessoas e grupos específicos em Skyone.
Insira os e-mails na caixa específica.
Em Registro, ative a opção Registrar erros em Logging (opcional).
Clique em Salvar.
Alerta: A URL de endpoint é exclusiva para cada publicação. Se você alterar essa URL no Google Cloud para um chat que já está em uso, a conexão atual será interrompida imediatamente.
Atualizado
Isto foi útil?