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

# Setup

> Step-by-step guide to connecting Google Chat to Prizm via OAuth or webhook so alert notifications post to a chat space.

<script type="application/ld+json">
  {`{
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "Google Chat Setup",
            "description": "Step-by-step guide to connecting Google Chat to Prizm via OAuth or webhook so alert notifications post to a chat space.",
            "url": "https://docs.dqlabs.ai/integrations/googlechat/setup",
            "publisher": {
              "@type": "Organization",
              "name": "DQLabs Inc",
              "logo": "https://media.brand.dev/332adc35-5bc4-4d2b-bf78-256aa4a5e414.svg"
            }
            }`}
</script>

## Connecting Google Chat to Prizm

Prizm supports two ways to connect Google Chat: **OAuth** (recommended) and **Webhook**. Choose the method that fits your Google Workspace setup.

When you click **Connect** on the Google Chat tile, Prizm will ask you to select the authentication type.

### Prerequisites

<Tabs>
  <Tab title="OAuth">
    * A Google Workspace account with access to the Google Chat spaces where notifications should be sent
    * Permission to authorize OAuth applications in your Google Workspace
  </Tab>

  <Tab title="Webhook">
    * A Google Chat space where alert notifications should be posted
    * Permission to manage webhooks in that Google Chat space
  </Tab>
</Tabs>

### Connect Google Chat in Prizm

<Tabs>
  <Tab title="OAuth">
    <Steps>
      <Step title="Open Integration settings">
        Navigate to **Organization** → **Integration** and click **Add**, then select **Google Chat** from the channel catalog.

        <Frame>
          <img src="https://mintcdn.com/dqlabs/dtdmSyFB72mT69bj/images/image-63.png?fit=max&auto=format&n=dtdmSyFB72mT69bj&q=85&s=ed9bda00cbcc3bf0915e9cde1c33f361" alt="Image" width="2482" height="1096" data-path="images/image-63.png" />
        </Frame>
      </Step>

      <Step title="Select OAuth">
        When prompted to select an authentication type, choose **OAuth**.

        <Frame>
          <img src="https://mintcdn.com/dqlabs/dtdmSyFB72mT69bj/images/image-64.png?fit=max&auto=format&n=dtdmSyFB72mT69bj&q=85&s=384b1ef07d1ab27ef905875aa28a8065" alt="Image" width="2488" height="858" data-path="images/image-64.png" />
        </Frame>
      </Step>

      <Step title="Authorize with Google">
        You are redirected to Google's sign-in page. Sign in with the Google Workspace account that has access to the target Chat spaces and grant the requested permissions. You are then redirected back to Prizm with the integration active.
      </Step>

      <Step title="Test and save">
        Click **Test Notification** to confirm Prizm can post to the space. Click **Update Integration** to save.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Webhook">
    <Steps>
      <Step title="Create a webhook in Google Chat">
        Open Google Chat and navigate to the space where you want Prizm alerts to appear. Click the space name at the top to open the space settings, then select **Manage webhooks**. Click **Add webhook**, enter a name (e.g., `Prizm Alerts`) and optionally an avatar URL, then click **Save**. Copy the generated webhook URL before closing the dialog.
      </Step>

      <Step title="Open Integration settings">
        Navigate to **Organization** → **Integration** and locate the **Google Chat** tile. Click the pencil icon to open the configuration.
      </Step>

      <Step title="Select Webhook">
        When prompted to select an authentication type, choose **Webhook**.
      </Step>

      <Step title="Enter channel name and webhook URL">
        Enter a display name in **Channel Name** that identifies this space within Prizm (e.g., `data-alerts`). Paste the webhook URL copied from Google Chat into **WebHook URL**.
      </Step>

      <Step title="Add additional spaces (optional)">
        Click the **+** icon in the top-right of the configuration panel to add another channel row. Repeat for each Google Chat space Prizm should send notifications to.
      </Step>

      <Step title="Test and save">
        Click **Test Notification** to confirm Prizm can post to the space. Click **Update Integration** to save.
      </Step>
    </Steps>

    ### Configuration reference

    | Field            | Required | Description                                                                                                                          |
    | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
    | **Channel Name** | Yes      | Display name for this Google Chat space within Prizm (e.g., `data-alerts`). Used when selecting notification targets in alert rules. |
    | **WebHook URL**  | Yes      | Incoming webhook URL generated in the Google Chat space settings (begins with `https://chat.googleapis.com/`).                       |

    <Note>
      Google Chat webhook URLs grant posting access to anyone who holds the URL. If a webhook URL is exposed, delete it in the space webhook settings, create a new one, and update the URL in Prizm.
    </Note>
  </Tab>
</Tabs>