Merge pull request #6 from brianleach/channel-first-docs

Docs: recommend a Slack channel id over a DM user id

Author: brianleach

.env.example

@@ -3,7 +3,8 @@
 NTFY_TOPIC=your-private-topic-name
 
 # Second channel: Slack. Alerts are mirrored here in addition to ntfy.
-# Set to your Slack user id (U...) for a DM, or a channel id (C...). The
+# Set to a Slack channel id (C..., recommended: alerts land in a channel) or
+# your user id (U...) for a DM. The
 # scheduled session sends it via the Slack MCP. Leave empty to use ntfy only.
 SLACK_USER_ID=
 

README.md

@@ -179,7 +179,7 @@ session through the Slack MCP, so it needs no egress allowlist change — handy
 backstop while you sort out ntfy. To enable, set your Slack target in `.env`:
 
 ```bash
-echo 'SLACK_USER_ID=U0XXXXXXX' >> .env   # your user id (DM) or a channel id (C...)
+echo 'SLACK_USER_ID=C0XXXXXXX' >> .env   # a channel id (C..., recommended) or your user id (U..., DMs you)
 ```
 
 The Slack MCP connector must be enabled on the session/routine. Leave

RUN.md

@@ -120,7 +120,8 @@ for you to send. After Step 3:
   all empty and `notice` is null, send nothing.
 - If `slack_user_id` is null, Slack is disabled — skip (ntfy only).
 - Otherwise use the Slack MCP `slack_send_message` with `channel_id` =
-  `slack_user_id` (a `U...` id DMs that user). Send ONE message per alert:
+  `slack_user_id` (recommended: a `C...` channel id, which posts to that
+  channel; a `U...` user id DMs that user instead). Send ONE message per alert:
   - For each entry in `high`: a clear "🚗 R2 ORDER INVITE detected" message with
     the subject, sender, received time, the one-line reason, and the `gmail_url`.
   - For each entry in `maybe`: a "🔍 POSSIBLE R2 invite — check manually" message

r2_monitor.py

@@ -97,7 +97,8 @@ def _load_dotenv() -> None:
 # Slack is a SECOND notification channel, sent alongside ntfy. The script can't
 # reach the Slack MCP itself, so it records what to send in state/last_run.json
 # and the scheduled session (RUN.md) mirrors it to this Slack user/channel via
-# the Slack MCP. Set SLACK_USER_ID (a user id "U..." for a DM, or a channel id)
+# the Slack MCP. Set SLACK_USER_ID (a channel id "C..." recommended, or a
+# user id "U..." for a DM)
 # in .env to enable; leave empty to use ntfy only.
 SLACK_USER_ID = os.environ.get("SLACK_USER_ID", "").strip()