From c5d02434178023724c1ff6839481b9f0fd246286 Mon Sep 17 00:00:00 2001
From: Gabi Simons <263580637+gabi-simons@users.noreply.github.com>
Date: Tue, 28 Apr 2026 12:19:44 +0000
Subject: [PATCH] fix(setup): add Interactivity & Shortcuts step to Slack setup

Slack interactive buttons (channel approval cards) require Interactivity
to be enabled in the app settings. Without it, button clicks silently
fail to reach the host. Added the step to both the setup wizard
post-install checklist and the add-slack SKILL.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .claude/skills/add-slack/SKILL.md |  8 +++++++-
 setup/channels/slack.ts           | 10 +++++++++-
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/.claude/skills/add-slack/SKILL.md b/.claude/skills/add-slack/SKILL.md
index addbd67..d09db61 100644
--- a/.claude/skills/add-slack/SKILL.md
+++ b/.claude/skills/add-slack/SKILL.md
@@ -76,7 +76,13 @@ pnpm run build
 10. Under **Subscribe to bot events**, add:
     - `message.channels`, `message.groups`, `message.im`, `app_mention`
 11. Click **Save Changes**
-12. Slack will show a banner asking you to **reinstall the app** — click it to apply the new event subscriptions
+
+### Interactivity
+
+12. Go to **Interactivity & Shortcuts** and toggle **Interactivity** on
+13. Set the **Request URL** to the same `https://your-domain/webhook/slack`
+14. Click **Save Changes**
+15. Slack will show a banner asking you to **reinstall the app** — click it to apply the new settings
 
 ### Configure environment
 
diff --git a/setup/channels/slack.ts b/setup/channels/slack.ts
index ac31cca..6d1ff56 100644
--- a/setup/channels/slack.ts
+++ b/setup/channels/slack.ts
@@ -381,7 +381,15 @@ function showPostInstallChecklist(info: WorkspaceInfo): void {
         `     • Request URL: https://<your-public-host>/webhook/slack`,
         '     • Subscribe to bot events: message.channels, message.groups,',
         '       message.im, app_mention',
-        '     • Save, then reinstall the app when Slack prompts',
+        '     • Save Changes',
+        '',
+        '  3. In your Slack app → Interactivity & Shortcuts:',
+        '     • Toggle "Interactivity" on',
+        `     • Request URL: https://<your-public-host>/webhook/slack`,
+        '     • Save Changes',
+        '',
+        '  4. Slack will prompt you to reinstall the app — do it to apply',
+        '     the new settings',
       ].join('\n'),
       6,
     ),