> 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/english/skyone-studio/artificial-intelligence/agents/ai-agent-publication-channels/how-to-set-up-google-chat-in-skyone-studio.md).

# How to set up Google Chat in Skyone Studio

### Overview

This documentation details the process of configuring **Google Chat** as a publishing channel in **Skyone Studio**. The integration allows AI agents to interact directly on the Google platform using service account credentials and the activation of specific APIs in Google Cloud.&#x20;

The configuration process is divided between the **Google Cloud** console and the **Skyone Studio** environment.

### Step-by-Step

[**\[Step 01\]: Service account creation and configuration in Google Cloud**](#step-1-service-account-creation-and-configuration-in-google-cloud)

[**\[Step 02\]: JSON Key generation**](#step-2-json-key-generation)

[**\[Step 03\]: Create Google Chat account in Skyone Studio**](#step-3-create-google-chat-account-in-skyone-studio)

[**\[Step 04\]: Configure publishing in Google Chat**](#step-4-configure-publishing-in-google-chat)

[**\[Step 05\]: Google Chat API activation**](#step-5-google-chat-api-activation)

[**\[Step 06\]: App and Endpoint definition**](#step-6-app-and-endpoint-definition)

***

#### Step 1: Service account creation and configuration in Google Cloud

1. Access the [Google Cloud console](https://console.cloud.google.com/welcome/new?hl=pt-BR\&pli=1) and select the desired project.
2. In the side menu, navigate to **APIs & Services** and click **Credentials**.
3. Click **Create Credentials** and select the **Service account** option.
4. In the **Service** **account name** field, enter a suitable name and click **Create and continue**.
5. In the next step, under **Permissions**, define the roles. To do this, search for "Google Chat" in the selection box and select the **Chat Apps Owner** option.
6. Click the **Add another role** option and add Chat Apps Viewer.
7. Click **Continue**.
8. To finish, click **Done**.

#### Step 2: JSON Key generation

1. In the service accounts list, click on the newly created account.
2. Access the **Keys** tab.
3. Click **Add Key** > **Create new key**.
4. Select the **JSON** format and click **Create**.

{% hint style="warning" %}
**Important:** The file will be automatically downloaded to your computer. Keep it in a safe place, as it is essential for authentication in **Skyone Studio.**
{% endhint %}

#### Step 3: Create Google Chat account in Skyone Studio

1. Access **Skyone Studio** and navigate to the **Publish** menu.
2. Select the **Google Chat** option and click **Manage accounts**.
3. Click **Create account**.
4. In the **Service account key** field, upload the **JSON** file previously downloaded.
5. Click **Create**.

#### Step 4: Configure publishing in Google Chat

1. Still in the **Publish** area, select the desired agent flow.
2. Under **Users and Groups**, select an existing user or create a new one.
3. Click **Save Publication**.
4. Copy the **Webhook URL** displayed on the screen. You will need this information for the next integration steps.
5. Click **Finish** to complete the process.

#### Step 5: Google Chat API activation

1. Return to the Google Cloud console and select the **APIs & Services** menu.
2. Check if the **Google Chat API** is in the list of enabled services.
3. If the API is not visible, click **Enable APIs and Services**.
4. Search for "**Google Chat API**" in the search field and select the corresponding result.
5. Click **Enable** to activate the feature.
6. Confirm that the **Google Chat API** is now displayed in your active services list to continue with the integration.

#### Step 6: App and Endpoint definition

1. After the previous activation, click the **Configuration** tab.
2. Under **App status,** select the Live - available to users option.
3. Under App information, fill in the basic details:
   * **App name:** Define the name that will appear in the chat.
   * **Avatar URL:** Link to the application's profile image.
   * **Description:** Brief summary of the bot's functionality.
4. In the **HTTP endpoint URL** field, paste the URL generated by **Skyone Studio** (copied from the channel publishing screen).
5. Keep the **Enable interactive features** option active.
6. Under **Connection settings**, select the **HTTP endpoint URL** option.
7. Under **Triggers**, select the Use an HTTP endpoint URL for all triggers option.
8. In the **HTTP endpoint URL** field, paste the URL from Step 4.
9. Under **Visibility**, enable the option **Make this Chat app available to specific people and groups in Skyone**.
10. Enter the emails in the specific box.
11. Under Logging, enable the **Log errors to Logging** option (optional).
12. Click **Save**.

{% hint style="danger" %}
**Alert**: The endpoint URL is unique for each publication. If you change this URL in Google Cloud for a chat already in use, the current connection will be interrupted immediately.
{% 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:

```
GET https://docs.skyone.cloud/english/skyone-studio/artificial-intelligence/agents/ai-agent-publication-channels/how-to-set-up-google-chat-in-skyone-studio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
