> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy to Google Chat

> Deploy your Agent to Google Chat so your team can access it in Google Workspace.

Deploy your [Agent](/agents/overview) to Google Chat so team members can interact with it in direct messages and Spaces within Google Workspace.

<Info>
  **Prerequisites:**

  * An Agent created in Cassidy
  * Google Workspace admin access
  * A [Google Cloud](https://console.cloud.google.com/) project (or the ability to create one)
</Info>

## Connect Cassidy to Google Chat

<Steps>
  <Step title="Navigate to your Agent">
    Go to **Agents** and select the Agent you want to deploy. Click **Edit** to open the Agent settings.

    <Frame>
      <img src="https://mintcdn.com/cassidy/bnQyOLzaMrYsTovN/images/integrations/deploying-agents-to-google-chat-img-0.png?fit=max&auto=format&n=bnQyOLzaMrYsTovN&q=85&s=652bb9af1066b69193712c8b877a88a2" alt="Agents page showing the list of available Agents" width="2462" height="1216" data-path="images/integrations/deploying-agents-to-google-chat-img-0.png" />
    </Frame>
  </Step>

  <Step title="Open the Deployments tab">
    Navigate to the **Deployments** tab and select **Google Chat**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/bnQyOLzaMrYsTovN/images/integrations/deploying-agents-to-google-chat-img-1.png?fit=max&auto=format&n=bnQyOLzaMrYsTovN&q=85&s=177ac037ba7b8b2c009ddcb4af9d67a9" alt="Agent settings with the Deployments tab selected" width="2490" height="1186" data-path="images/integrations/deploying-agents-to-google-chat-img-1.png" />
    </Frame>
  </Step>

  <Step title="Copy the webhook URL">
    Copy the **Webhook URL** provided by Cassidy. You'll need this when configuring the Chat bot in Google Cloud.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-2.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=3c3759f0277f8a8494eae40022eb6161" alt="Cassidy Deployments tab showing the Webhook URL for Google Chat" width="2556" height="1394" data-path="images/integrations/deploying-agents-to-google-chat-img-2.png" />
    </Frame>
  </Step>

  <Step title="Set up a Google Cloud account">
    Go to the [Google Cloud Console](https://console.cloud.google.com/). If you don't have an account, select your country, agree to the Terms of Service, and click **Agree and Continue**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-3.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=675c674c8bb9730f8baf75ce9b3bb1d9" alt="Google Cloud Console setup page with Terms of Service" width="1220" height="1128" data-path="images/integrations/deploying-agents-to-google-chat-img-3.png" />
    </Frame>
  </Step>

  <Step title="Create a Google Cloud project">
    Go to [Create a Project](https://console.cloud.google.com/projectcreate). Enter your project name and organization, select a location, and click **Create**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-4.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=6d8bc9ccb281f3c8dc5d8643c7145496" alt="Google Cloud new project creation form" width="1916" height="1390" data-path="images/integrations/deploying-agents-to-google-chat-img-4.png" />
    </Frame>
  </Step>

  <Step title="Enable the Google Chat API">
    Navigate to the [Chat API Library](https://console.cloud.google.com/apis/library/chat.googleapis.com). Make sure the correct project is selected and click **Enable**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-5.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=20448457aa4d59c539fca0f697e84f31" alt="Google Cloud API Library showing the Google Chat API Enable button" width="2976" height="1254" data-path="images/integrations/deploying-agents-to-google-chat-img-5.png" />
    </Frame>
  </Step>

  <Step title="Create a service account">
    Go to [Chat API Credentials](https://console.cloud.google.com/apis/api/chat.googleapis.com/credentials). Click the **Create Credentials** dropdown and select **Service Account**. Name it (for example, "Cassidy Service Account") and click **Create and Continue**. Skip optional steps and click **Done**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-6.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=4f9c393813afecf4149d5472e3a407fe" alt="Google Cloud Credentials page showing the Create Credentials menu" width="2958" height="1086" data-path="images/integrations/deploying-agents-to-google-chat-img-6.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-7.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=0807d5216684d9efa8037a77f8b174f9" alt="Service account creation form with name and description fields" width="1288" height="1402" data-path="images/integrations/deploying-agents-to-google-chat-img-7.png" />
    </Frame>
  </Step>

  <Step title="Access the service account">
    On the **Credentials** tab, click the pencil icon next to the service account you just created.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-8.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=31e1e4f00d289ec21c1fb912ca26bded" alt="Credentials tab showing the service account with the edit icon" width="2002" height="1396" data-path="images/integrations/deploying-agents-to-google-chat-img-8.png" />
    </Frame>
  </Step>

  <Step title="Generate a JSON key">
    Go to the **Keys** tab, click **Add Key**, then select **Create New Key**. Choose **JSON** and click **Create** to download the key file.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-9.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=7ade4a3bf31863e130d116c4ba51e964" alt="Service account Keys tab showing the Add Key menu" width="2982" height="1174" data-path="images/integrations/deploying-agents-to-google-chat-img-9.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/bnQyOLzaMrYsTovN/images/integrations/deploying-agents-to-google-chat-img-10.png?fit=max&auto=format&n=bnQyOLzaMrYsTovN&q=85&s=18d14c151e95b61451ae4a9983d3ed56" alt="Create private key dialog with JSON selected" width="1162" height="716" data-path="images/integrations/deploying-agents-to-google-chat-img-10.png" />
    </Frame>
  </Step>

  <Step title="Configure the Chat bot">
    Go to [Chat API Configuration](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat) and set up the following:

    * Check **Build this Chat app as a Workspace add-on**
    * Fill in the **Application Info** (name, avatar URL, description)
    * Ensure **Enable Interactive Features** is enabled
    * Under **Connection Settings**, select **HTTP endpoint URL**
    * For **Triggers**, choose **Use a common HTTP endpoint URL for all triggers** and paste the **Webhook URL** from Cassidy
    * Under **Visibility**, select **Make this Chat app available to specific people and groups** and enter your email for testing

    Click **Save**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/bnQyOLzaMrYsTovN/images/integrations/deploying-agents-to-google-chat-img-11.png?fit=max&auto=format&n=bnQyOLzaMrYsTovN&q=85&s=3ef01fa65990f1158bf2448d7ce2a57a" alt="Google Chat API configuration showing application info and interactive features" width="1262" height="1600" data-path="images/integrations/deploying-agents-to-google-chat-img-11.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/bnQyOLzaMrYsTovN/images/integrations/deploying-agents-to-google-chat-img-12.png?fit=max&auto=format&n=bnQyOLzaMrYsTovN&q=85&s=ccdd81fb8a4bced2f12c62a76298d24a" alt="Google Chat API configuration showing connection settings and triggers with the Webhook URL" width="1134" height="1476" data-path="images/integrations/deploying-agents-to-google-chat-img-12.png" />
    </Frame>
  </Step>

  <Step title="Upload the service account key in Cassidy">
    Return to your Agent's **Deployments** tab in Cassidy. Under **Service Account Key**, click **Upload JSON File** and upload the key file you downloaded.

    <Frame>
      <img src="https://mintcdn.com/cassidy/bnQyOLzaMrYsTovN/images/integrations/deploying-agents-to-google-chat-img-13.png?fit=max&auto=format&n=bnQyOLzaMrYsTovN&q=85&s=700a9277a6ac74cdf8433cf81c64b52b" alt="Cassidy deployment settings showing the Upload JSON File button for the service account key" width="1848" height="1002" data-path="images/integrations/deploying-agents-to-google-chat-img-13.png" />
    </Frame>
  </Step>

  <Step title="Create the deployment">
    Click **Create Google Chat Deployment**. Optionally toggle on **Show Knowledge Base References** to display source citations in responses.

    <Frame>
      <img src="https://mintcdn.com/cassidy/bnQyOLzaMrYsTovN/images/integrations/deploying-agents-to-google-chat-img-14.png?fit=max&auto=format&n=bnQyOLzaMrYsTovN&q=85&s=37d4b568d5ae127669655b30ab5430df" alt="Cassidy Google Chat deployment settings with Show Knowledge Base References toggle" width="1838" height="952" data-path="images/integrations/deploying-agents-to-google-chat-img-14.png" />
    </Frame>
  </Step>

  <Step title="Test in Google Chat">
    Open Google Chat, start a new chat, and search for your Agent name. Send a message to confirm it responds.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-15.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=3b8ac54b25dfbc4586bbf614ef95274c" alt="Google Chat conversation showing the Agent responding to a test message" width="1600" height="1155" data-path="images/integrations/deploying-agents-to-google-chat-img-15.png" />
    </Frame>
  </Step>
</Steps>

<Tip>If you only need a few people to access the Agent, enter their emails in the **Visibility** setting and skip publishing to the Marketplace.</Tip>

## Publish to your workspace

To make the Agent available to your entire Google Workspace organization, publish it through the Google Workspace Marketplace.

<Steps>
  <Step title="Enable the Workspace Marketplace SDK">
    Go to the [Apps Marketplace API](https://console.cloud.google.com/apis/library/appsmarket-component.googleapis.com) and click **Enable**.
  </Step>

  <Step title="Set up OAuth consent">
    Go to the [OAuth Consent Screen](https://console.cloud.google.com/auth/overview). Click **Get Started**, enter your app name, support email, and set the audience type to **Internal**. Click **Create**.
  </Step>

  <Step title="Configure Marketplace settings">
    In the [Google Workspace Marketplace SDK](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk), go to **App Configuration**:

    * Set app visibility to **Private**
    * Set installation settings to **Individual + Admin Install**
    * Ensure **Workspace add-on** is selected under App Integrations
    * Enter your contact info for developer information

    Click **Save Draft**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-16.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=3f459bbe0aa8f6c9b245808b0a10d1bd" alt="Google Workspace Marketplace SDK App Configuration page" width="1100" height="810" data-path="images/integrations/deploying-agents-to-google-chat-img-16.png" />
    </Frame>
  </Step>

  <Step title="Create a store listing and publish">
    Go to the [Store Listing](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) tab. Fill in the app details (name, description, graphics), save as draft, then click **Publish**.

    Your Agent should now appear in the Google Workspace Marketplace under [internal apps](https://workspace.google.com/marketplace/mydomainapps).

    <Frame>
      <img src="https://mintcdn.com/cassidy/RZ75CscZWMGVg8C6/images/integrations/deploying-agents-to-google-chat-img-17.png?fit=max&auto=format&n=RZ75CscZWMGVg8C6&q=85&s=88674b0891e10687a21437928cfdea22" alt="Google Workspace Marketplace showing the published Cassidy Agent as an internal app" width="1600" height="1131" data-path="images/integrations/deploying-agents-to-google-chat-img-17.png" />
    </Frame>
  </Step>
</Steps>

## Using your Agent in Google Chat

### Direct messages

Search for the Agent by name and start a direct message conversation. The Agent remembers the full conversation history across the thread.

### Spaces

Add the Agent to a Google Chat Space and @mention it to start a conversation. The Agent replies in-thread and remembers messages where it was mentioned.

## Next steps

<CardGroup cols={2}>
  <Card title="Deploy to Slack" icon="slack" href="/integrations/slack/deploy-agent">
    Make your Agent available in Slack channels and DMs.
  </Card>

  <Card title="Deploy via email" icon="envelope" href="/agents/deploy/email">
    Deploy your Agent to a dedicated email address.
  </Card>

  <Card title="Deploy via embed" icon="code" href="/agents/deploy/embed">
    Embed your Agent on your website for external users.
  </Card>
</CardGroup>
