How to Integrate Pingzo Alerts with Google Chat Spaces

Google Chat is a key collaboration and communication platform integrated directly into Google Workspace. It is used by teams worldwide to discuss projects, coordinate workflows, and manage operations. When your web services experience downtime, routing alerts directly to your team's Google Chat spaces ensures rapid coordination and immediate response.

Because Pingzo is built with developer-friendly alert dispatchers, you can integrate it directly with Google Chat using our native Webhook channel. Google Chat's incoming webhook interface is fully compatible with Pingzo's default webhook payload structure. This guide explains how to configure and verify this integration.

🛠️ Step 1: Create an Incoming Webhook in Google Chat

To send messages to a Google Chat space, you must first enable and configure an incoming webhook. This generates a unique API endpoint that accepts secure POST requests containing message text.

1. Open Your Google Chat Space

1. Open Google Chat in your browser or desktop application.
2. Navigate to the Space where you want to receive monitoring alerts.
3. Click on the space name header at the top of the window to open the settings dropdown.

2. Configure the Integration

1. Select Apps & integrations (or Manage webhooks depending on your Workspace version).
2. Click Add webhooks.
3. Enter a name for the webhook (e.g. Pingzo Uptime Alerts).
4. (Optional) Provide an avatar URL (such as Pingzo's logo) to customize the bot's appearance.
5. Click Save.

3. Copy the Webhook URL

Google Chat will generate a unique endpoint URL (formatted as https://chat.googleapis.com/v1/spaces/.../webhooks/...). Copy this URL to your clipboard.

⚡ Step 2: Configure the Webhook Channel in Pingzo

Pingzo's default webhook dispatcher posts a JSON payload containing structured details about the check event. Because Pingzo's payload includes a root-level text parameter containing the formatted alert summary, Google Chat's API accepts and posts the text directly into your space without requiring any intermediate code or third-party mapping gateways.

1. Add the Channel in Pingzo

1. Log into your Pingzo Dashboard and navigate to the Alert Channels page.
2. Click Add Channel.
3. Select Webhook from the channel type dropdown.
4. Name the channel (e.g. Google Chat Space).
5. In the Webhook URL destination field, paste the Google Chat webhook URL you copied in Step 1.
6. Click Save to register the channel.

2. Associate the Channel with Your Monitors

Navigate to your active monitors page, select the checks you want to track, and ensure the newly created Google Chat webhook channel is checked under their alert channel settings.

📣 Step 3: Understand the Alert Format

When a monitored service goes down or recovers, Pingzo posts the event to Google Chat. The notification will appear in your space as a message from your configured bot avatar, containing the following details:

• Service Down Event: 🔴 Pingzo Alert: [Monitor Name] is DOWN! View Status: [Your Status Page URL]
• Service Recovery Event: ✅ Pingzo Alert: [Monitor Name] is back UP! View Status: [Your Status Page URL]

This clean text layout provides immediate context and a direct link to inspect detailed logs or check public statuses, allowing your engineering team to start troubleshooting without delay.

🔒 Step 4: Verify the Connection

To confirm the webhook connection is working correctly:

1. Create a temporary monitor in Pingzo targeting a URL path you know will fail (e.g. a non-existent route that returns an HTTP 404).
2. Set the check interval to 1 minute.
3. Save the monitor and wait for the first check to execute.
4. Verify that a red alert card notification appears in your Google Chat space.
5. Once verified, delete or disable the test monitor to prevent spam.