Skip to main content

Google Chat Alerts Configuration

Collate integrates with Google Chat using Webhooks to deliver alert messages directly to your Google Chat Spaces. This lets you receive real-time notifications within your Google Chat workspace.

Setting Up a Google Chat Webhook

Follow these steps to create a Webhook in your Google Chat Space:

Step 1: Access Google Chat

  1. Open Google Chat.
  2. Sign in with your Google account.
  3. Navigate to the Space where you want to receive alerts (or create a new Space).

Step 2: Create a New Webhook

  1. Click on the Space name at the top of the chat window.
  2. From the dropdown menu, select Space Settings.
  3. Click Apps & Integrations in the left menu.
  4. Click Add Webhooks.

Step 3: Configure the Webhook

  1. Enter a Name for the webhook (for example, “Collate Alerts”).
  2. Select the Avatar or icon for the webhook (optional).
  3. Click Create.

Step 4: Copy Your Webhook URL

  1. You’ll see your new webhook listed with a Webhook URL.
  2. Copy the complete Webhook URL (it looks like https://chat.googleapis.com/v1/spaces/XXXXXXXXXXXXXXX/messages?key=...&token=...).
  3. Keep this URL safe - you’ll need it to configure Collate.

Configuring Google Chat Webhooks in Collate

Once you have your Google Chat Webhook URL, follow these steps to configure it in Collate:

Step 1: Access Alert Configuration

  1. In Collate, navigate to Alerts & Notifications from the main menu.
  2. Select the type of alert you want to configure:

Step 2: Add Google Chat as a Destination

  1. Click Add Destination.
  2. Select Google Chat from the available destination options.
  3. Paste your Google Chat Webhook URL into the Google Chat Webhook URL field.

Step 3: Test the Connection

  1. Click Test Connection to verify the webhook is working.
  2. A test message will be sent to your Google Chat Space.
  3. If successful, you’ll see a confirmation message and the test message in your Space.

Step 4: Save and Enable

  1. Click Save to store the Alert configuration.
  2. The Google Chat destination is now ready to receive alerts.

Best Practices

  • Dedicated Spaces: Create separate Google Chat Spaces for different types of alerts (for example, “Data Quality Alerts”, “Pipeline Failures”, “Governance Events”).
  • Space Members: Ensure all relevant team members are added to the Google Chat Space.
  • Multiple Webhooks: Configure multiple Google Chat webhooks to send different alert types to different Spaces.
  • Notifications: Enable notifications for the Space so team members don’t miss important alerts.
  • Monitoring: Regularly review alerts in your Google Chat Space to ensure they’re being delivered.

Reference

For more information about Google Chat Webhooks, visit the Google Chat Webhooks Documentation.