> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/agentes/canais-de-publicacao-de-agentes-de-ia/como-configurar-o-google-chat-no-skyone-studio.md).
# 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-1-criacao-e-configuracao-de-conta-de-servico-no-google-cloud)
[**\[Passo 02\]: Geração da Chave JSON**](#passo-2-geracao-da-chave-json)
[**\[Passo 03\]: Criar conta do Google Chat no Skyone Studio**](#passo-3-criar-conta-do-google-chat-no-skyone-studio)
[**\[Passo 04\]: Configurar publicação no Google Chat**](#passo-4-configurar-publicacao-no-google-chat)
[**\[Passo 05\]: Ativação da Google Chat API**](#passo-5-ativacao-da-google-chat-api)
[**\[Passo 06\]: Definição do App e Endpoint**](#passo-6-definicao-do-app-e-endpoint)
***
#### Passo 1: Criação e configuração de conta de serviço no Google Cloud
1. Acesse o [console do Google Cloud](https://console.cloud.google.com/welcome/new?hl=pt-BR\&pli=1) e selecione o projeto desejado.
2. No menu lateral, navegue até **API e Serviços** e clique em **Credenciais**.
3. Clique em **Criar credenciais** e selecione a opção **Conta de serviço**.
4. No campo **Nome da conta de serviço**, insira um nome adequado e clique em **Criar e continuar**.
5. 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**.
6. Clique na opção **Adicionar outro papel** e adicione Visualizador de apps do Chat.
7. Clique em **Continuar**.
8. Para finalizar, clique em **Concluído**.
#### Passo 2: Geração da Chave JSON
1. Na lista de contas de serviço, clique sobre a conta recém-criada.
2. Acesse a aba **Chaves**.
3. Clique em **Adicionar chave** > **Criar nova chave**.
4. Selecione o formato **JSON** e clique em **Criar**.
{% hint style="warning" %}
**Importante:** O arquivo será baixado automaticamente em seu computador. Guarde-o em local seguro, pois ele é essencial para a autenticação no **Skyone Studio**.
{% endhint %}
#### Passo 3: Criar conta do Google Chat no Skyone Studio
1. Acesse o **Skyone Studio** e navegue até o menu de Publicar.
2. Selecione a opção **Google Chat** e clique em **Gerenciar contas**.
3. Clique em **Criar conta**.
4. No campo de **Chave da conta de serviço**, realize o upload do arquivo **JSON** baixado anteriormente.
5. Clique em **Criar**.
#### Passo 4: Configurar publicação no Google Chat
1. Ainda na área **Publicar**, selecione o fluxo do agente desejado.
2. Em **Usuários e Grupos**, selecione um usuário existente ou crie um novo.
3. Clique em **Salvar Publicação**.
4. Copie a **URL de Webhook** exibida na tela. Você precisará deste dado para os próximos dados da integração.
5. Clique em **Concluir** para finalizar o processo.
#### Passo 5: Ativação da Google Chat API
1. Retorne ao console do Google Cloud e selecione o menu **APIs e Serviços**.
2. Verifique se a **Google Chat API** consta na lista de serviços ativados.
3. Caso a API não esteja visível, clique em **Ativar APIs e Serviços**.
4. Pesquise por "**Google Chat API**" no campo de busca e selecione o resultado correspondente.
5. Clique em **Ativar** para habilitar o recurso.
6. 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
1. Após a ativação anterior, clique na aba **Configuração**.
2. Em **Status do app**, selecione a opção Ativo, disponível aos usuários.
3. Em Informações do aplicativo, preencha as informações básicas:
1. **Nome do app:** Defina o nome que aparecerá no chat.
2. **URL do avatar:** Link para a imagem de perfil do aplicativo.
3. **Descrição:** Breve resumo da funcionalidade do bot.
4. No campo **URL do endpoint HTTP**, cole a URL gerada pelo **Skyone Studio** (copiada da tela de publicação do canal).
5. Deixe ativo a opção **Ativar recursos interativos**.
6. Em **Configurações de conexão**, selecione a opção **URL do endpoint do HTTP**.
7. Em **Gatilhos**, selecione a opção Usar um **URL do endpoint do HTTP para todos os gatilhos**.
8. No campo **URL do endpoint do HTTP**, cole a URL da etapa 4.
9. Em **Visibilidade**, ative a opção **Disponibilizar o app de chat para pessoas e grupos específicos em Skyone**.
10. Insira os e-mails na caixa específica.
11. Em Registro, ative a opção **Registrar erros em Logging** (opcional).
12. Clique em **Salvar**.
{% hint style="danger" %}
**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.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/agentes/canais-de-publicacao-de-agentes-de-ia/como-configurar-o-google-chat-no-skyone-studio.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.