node-red-contrib-slack-modern 0.2.1

Slack nodes for Node-RED built for modern Slack apps (Socket Mode + Web API)

npm install node-red-contrib-slack-modern

node-red-contrib-slack-modern

Slack nodes for Node-RED built for modern Slack apps. Events arrive over Socket Mode, so no public URL is needed, and any Web API method can be called.

Classic Slack apps and the RTM API they rely on are being phased out. This package replaces RTM based nodes such as slack-rtm-in while keeping the same message shape, so existing flows keep working.

Nodes

Example usage (JSON export)

Reply in a thread to every message (with Ignore events caused by this app enabled in slack in):

[slack in] → [change: topic = chat.postMessage, payload = {channel, thread_ts: payload.ts, text}] → [slack api]

Slack app setup

1. Create an app at api.slack.com/apps (or reuse one) and paste the manifest below in App Manifest, adjusting it to your needs.
2. Basic Information → App-Level Tokens: generate a token with the connections:write scope. That is the app token (xapp-…).
3. Install App: install to your workspace and copy the Bot User OAuth Token (xoxb-…).
4. Invite the bot to the channels it should listen to (/invite @your-app).

display_information:
  name: Node-RED
features:
  bot_user:
    display_name: Node-RED
    always_online: true
oauth_config:
  scopes:
    bot:
      - channels:history # messages in public channels
      - groups:history # messages in private channels
      - im:history # direct messages
      - mpim:history # group direct messages
      - channels:read # channelObject for public channels
      - groups:read # channelObject for private channels
      - users:read # userObject
      - chat:write # chat.postMessage
      - chat:write.customize # custom username and icon_emoji
      - reactions:write # reactions.add / reactions.remove
      - files:read # slack file node
settings:
  event_subscriptions:
    bot_events:
      - message.channels
      - message.groups
      - message.im
      - message.mpim
  interactivity:
    is_enabled: true
  socket_mode_enabled: true

[!IMPORTANT] Slack spreads events across all Socket Mode connections of one app. Do not connect another Socket Mode client (a second Node-RED, a Bolt app, …) with the same app token, otherwise some events will only reach the other client.

Migrating from node-red-contrib-slack

[!WARNING] Messages posted by a modern app do not always carry subtype: "bot_message". Enable Ignore events caused by this app in slack in so the app does not react to its own replies, or filter other bots by checking that msg.payload.bot_id is missing.

Development

npm install
npm run dev # tsc --watch
npm test

Releasing

Releases are staged on npm by GitHub Actions using trusted publishing, so no npm token is stored in the repository.

One-time setup:

npm trust github node-red-contrib-slack-modern --repo FilipChalupa/node-red-contrib-slack-modern --file publish.yml --env npm --allow-stage-publish

Release:

npm version minor # bumps package.json and creates the v* tag
git push --follow-tags
# after the workflow finishes:
npm stage list node-red-contrib-slack-modern
npm stage approve <stage-id> # asks for 2FA