Skip to main content

Webhook alerts

pocketPG can send real-time alerts to a Slack-compatible webhook URL when critical health issues are detected on a saved instance.

Setup

  1. Go to the Account tab.
  2. Find your instance in the Webhook Alerts section.
  3. Paste a Slack incoming webhook URL and click Save.
  4. Click Test to verify delivery.

How it works

A background loop checks saved instances with configured webhooks. For each instance:

  1. Runs the same health-check family used by the daily digest.
  2. Filters for CRITICAL severity only.
  3. Deduplicates repeated findings so the same issue does not spam the channel.
  4. Sends a Slack-compatible JSON payload when new or changed critical findings appear.
  5. Retries failed sends on a later check.

Dedup behavior

  • Same findings during the dedup window — no repeated alert.
  • New finding added — hash changes, immediate alert.
  • Finding clears — hash changes, but no "all clear" message is sent. Re-alerts only on new CRITICAL findings.
  • Delivery fails — retry on a later check.