From 3fe22389771e677daaa53187c6fec0b90e3ce9a7 Mon Sep 17 00:00:00 2001 From: Amp Date: Sat, 3 Oct 2026 07:17:37 +0000 Subject: [PATCH 1/2] Document Slack subscriptions Explain how to subscribe a Slack channel to public incident events, what the feed contains, and how delivery differs from email and RSS. Amp-Thread-ID: https://ampcode.com/threads/T-01a0f259-2463-7649-ba6a-0251b256031f Co-authored-by: James Brooks --- v3.x/guide/subscribers.mdx | 39 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/v3.x/guide/subscribers.mdx b/v3.x/guide/subscribers.mdx index 5737201..349b026 100644 --- a/v3.x/guide/subscribers.mdx +++ b/v3.x/guide/subscribers.mdx @@ -41,6 +41,45 @@ Every email includes an unsubscribe link. Cachet queues all notifications, so we Cachet can also email dashboard users when an incident has seen no activity for a configurable number of hours. This feature is off by default; configure it on the "Manage Notifications" page. +## Slack subscriptions + +Subscribe a Slack channel to public incident events using Cachet's Slack RSS feed. Slack manages this subscription; +it does not create a Cachet email subscriber. + +Append `/slack.rss` to the public status page URL: + +```text +https://status.example.com/slack.rss +``` + +Include `CACHET_PATH` when Cachet is served from a path, for example `https://example.com/status/slack.rss`. + +Install the [RSS app from the Slack Marketplace](https://slack.com/marketplace/A0F81R7U7-rss). In the target channel, +run: + +```text +/feed subscribe https://status.example.com/slack.rss +``` + +Each incident report and update is a separate feed item containing its status, message, affected components, and a +link to the event. The feed only includes published incidents with **Guests** visibility. It excludes +authenticated-only, hidden, and future incidents. + + + `/rss` groups an incident and its update history into one item. `/slack.rss` publishes each report and update as + a separate item. + + +Slack records the newest item when a feed is added and does not post older items. Cachet caches the feed for up to 60 +seconds, and Slack polls it on its own schedule. Use `/feed list` to view a channel's subscriptions and +`/feed remove ID` to remove one. + +If feed links use HTTP instead of HTTPS, set `APP_URL` to the public HTTPS URL. When Cachet is behind a reverse proxy, +also configure [`CACHET_TRUSTED_PROXIES`](/v3.x/configuration/environment#application). + +See [Slack's RSS documentation](https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack) for feed management +commands and troubleshooting. + ## Managing subscribers The "Subscribers" section of the dashboard lists every subscriber and their verification status. From here you may From c1a94a490430c5634c82d95f2c7dd540437b3f32 Mon Sep 17 00:00:00 2001 From: James Brooks Date: Sat, 3 Oct 2026 08:20:47 +0100 Subject: [PATCH 2/2] Update subscribers.mdx --- v3.x/guide/subscribers.mdx | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/v3.x/guide/subscribers.mdx b/v3.x/guide/subscribers.mdx index 349b026..2bea329 100644 --- a/v3.x/guide/subscribers.mdx +++ b/v3.x/guide/subscribers.mdx @@ -54,8 +54,7 @@ https://status.example.com/slack.rss Include `CACHET_PATH` when Cachet is served from a path, for example `https://example.com/status/slack.rss`. -Install the [RSS app from the Slack Marketplace](https://slack.com/marketplace/A0F81R7U7-rss). In the target channel, -run: +In the channel you want to receive updates to, run: ```text /feed subscribe https://status.example.com/slack.rss @@ -74,9 +73,6 @@ Slack records the newest item when a feed is added and does not post older items seconds, and Slack polls it on its own schedule. Use `/feed list` to view a channel's subscriptions and `/feed remove ID` to remove one. -If feed links use HTTP instead of HTTPS, set `APP_URL` to the public HTTPS URL. When Cachet is behind a reverse proxy, -also configure [`CACHET_TRUSTED_PROXIES`](/v3.x/configuration/environment#application). - See [Slack's RSS documentation](https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack) for feed management commands and troubleshooting.