Skip to content

Slack alerts

Herald can deliver two kinds of notification to Slack: watchlist firings (your standing questions, every time they return a new answer) and anomaly alerts (significant swings Herald noticed that you didn’t configure). Both arrive as rich messages — one paragraph, the metric that moved, a link back to the briefing context. Slack is a Starter-and-up feature.

  1. Go to Settings → Integrations → Slack.
  2. Click Connect Slack. You’ll be sent to Slack’s OAuth screen.
  3. Pick the workspace Herald should post to.
  4. Approve chat:write and channels:read scopes.

Herald does not need DM permissions, user scopes, or your message history. It only posts.

After connecting, choose the default channel for each alert class:

  • Watchlist firings — most teams use #metrics or a dedicated #herald channel.
  • Anomaly alerts — same, or a separate #alerts if you want noisier channels quarantined.

You can override per-watchlist in each watchlist’s settings — e.g. churn watchlists to #revenue, activation watchlists to #growth.

A watchlist firing reads like a briefing paragraph, not a dashboard ping:

New free-trial DAU watchlist hit DAU for trials started this week dropped below 50 on Thursday. First time in 28 days. Bob at Acme is one of them — worth a personal reply. View the briefing context →

Short, named, and actionable. Herald never posts “metric crossed threshold” without context.

Herald throttles Slack on principle. No more than three messages per Product per day except for critical anomalies (a full hour of zero events, a Stripe webhook lapse, a forecast miss of more than one standard deviation). If you’re getting noise, the answer is usually a tighter watchlist, not a mute.

Settings → Integrations → Slack → Disconnect. Herald stops posting immediately. You can also revoke the Slack app from the workspace admin panel — Herald catches the revocation and emails you confirmation within the hour.

Herald doesn’t read your Slack channels. We post, we don’t listen. If you want to forward a customer escalation from Slack into Herald, forward the message to your ingest email instead.