Webhook Integrations (Slack, Microsoft Teams & Google Chat)

Webhook Integrations

psLens dispatches real-time alert notifications (firing and resolution events) and scheduled report completion summaries to incoming webhooks. psLens automatically detects the target platform from the webhook URL and formats native rich card payloads without extra configuration:

Setting Up Google Chat Webhooks

Google Workspace spaces support incoming webhooks that allow psLens to post formatted Cards v2 alert and report messages directly into a space.

Where to Get a Google Chat Webhook URL

Open Google Chat in your web browser (creating webhooks requires the web or desktop app, not the mobile app) and open the Space where you want psLens notifications delivered.

Click the Space name at the top of the conversation header to open the space menu, then select Apps & integrations.

In the Webhooks section, click + Add webhooks (or Manage webhooks).

Enter a name for the webhook (for example, psLens Alerts) and optionally provide an avatar image URL, then click Save.

Click the three-dot menu (⋮) next to your newly created webhook and select Copy link.

The copied URL will look like this:

https://chat.googleapis.com/v1/spaces/AAQAn4B-uPg/messages?key=AIzaSy...&token=bCtXq1...

Note: If Apps & integrations → Webhooks is not visible or is greyed out, ask your Google Workspace administrator to enable incoming webhooks in the Google Admin Console under Apps → Google Workspace → Google Chat → Externaligs / Webhooks.

How Google Chat Delivery Works in psLens

• Rich Cards v2 Layout: Alert and report notifications render as structured Google Chat cardsV2 messages with a header, severity/environment metadata columns, affected item summaries, and an Open in psLens button (when server.appBaseURL is configured).
• Automatic Threading: Alert notifications automatically include a deterministic threadKey per database and alert type along with messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD, so firing alerts, reminders, and RESOLVED notifications group into the same conversation thread in your space.
• Secret Obfuscation: Both key and token query parameters in chat.googleapis.com URLs are automatically masked (***) in the psLens UI, delivery history, and application logs.

Setting Up Slack Webhooks

In Slack, open your workspace settings or visit the Slack Apps portal and create or select an app with Incoming Webhooks enabled.

Click Add New Webhook to Workspace, select the target channel, and copy the generated https://hooks.slack.com/services/... URL.

Setting Up Microsoft Teams Webhooks

In Microsoft Teams, open the target channel, click the three-dot menu (⋯) next to the channel name, and select Workflows (or Connectors).

Choose the Post to a channel when a webhook request is received workflow template, select your team and channel, and copy the generated Power Automate / Office 365 webhook URL.

Registering & Routing Webhooks in psLens

Once you have copied your webhook URL from Google Chat, Slack, or Microsoft Teams, register it in psLens either through the web UI or in config.yaml.

Via the Web UI (Recommended)

Open Settings → Notifications (/settings/notifications) and scroll to the Webhook Destinations card.

Click Add Webhook, enter an ID (e.g., gchat_ops), a Display Name (e.g., Google Chat Ops Space), and paste the Webhook URL, then click Save Webhook. psLens automatically displays a Google Chat, Slack, or MS Teams badge next to the webhook.

Click the Send Test (paper-plane) button next to the webhook to send a test card to your channel or space and confirm connectivity.

Once registered, you can route notifications to this webhook in three places:

• Global Alert Subscriptions: On Settings → Notifications, add a subscription under Notification Subscriptions, set Delivery Method to Webhook, and select your webhook from the dropdown.
• Database-Specific Alert Delivery: On Settings → Databases → [Database] → Alerts, under Notification Delivery Settings, toggle Webhook Delivery on, select your webhook, and click Save Delivery.
• Scheduled Reports: On any report page under Schedule & Notifications, toggle Webhook delivery on and select your webhook.

Via config.yaml

You can also define reusable webhooks and subscriptions directly in config.yaml (including op:// 1Password secret references):

notifications:
  webhooks:
    gchat_ops:
      name: "Google Chat Operations Space"
      url: "https://chat.googleapis.com/v1/spaces/AAAA.../messages?key=...&token=..."
    slack_alerts:
      name: "Slack Alert Channel"
      url: "https://hooks.slack.com/services/T000/B000/XXXX"
    teams_ops:
      name: "Teams Operations Channel"
      url: "https://default...powerautomate.../invoke"

  subscriptions:
    - id: "google-chat-prod"
      enabled: true
      alertTypes: ["*"]
      databases: ["PROD"]
      severityMin: "warning"
      type: "webhook"
      target: "gchat_ops"