Slack Trigger
Type ID: slackTrigger · Kind: Trigger · Trigger style: poll · Ports: 1 in, 1 out (0 in when used as the workflow's root trigger)
Polls the Slack conversations.history API on an interval and triggers the workflow when new messages matching the configured filters are posted in a channel.
Credentials
Connect a Slack Bot (slack_bot) or Slack User (slack_user) credential via the integration picker.
With a Slack Bot connection the bot must be a member of the channel; with a Slack User connection the person must be, and the trigger stops seeing the channel if they leave.
Properties
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Poll Interval | pollIntervalMs | number | Yes | 90000 | Defines the interval, in milliseconds, at which Slack is checked for new messages. A minimum polling interval of 90 seconds is enforced; any value below 90,000 ms will default to 90,000 ms | Always |
| Event | event | options | Yes | messagePosted | messagePosted (Message Posted) | Always |
| Channel ID | channelId | string | Yes | '' | Slack channel ID to monitor, e.g. C1234567890 | Always |
| Output | output | options | No | simple | simple (Simplified), raw (Raw) | Always |
| Filters | filters | object | No | {} | See sub-table | Always |
| Options | options | object | No | {} | See sub-table | Always |
filters (object)
| Property | Key | Type | Required | Default | Possible values |
|---|---|---|---|---|---|
| User ID | userId | string | No | '' | Only trigger on messages from this Slack user ID |
| Text Contains | textContains | string | No | '' | Only trigger on messages containing this text |
| Exclude Bot Messages | excludeBots | boolean | No | true | Exclude messages from bots |
| Message Subtype | subtype | string | No | '' | Filter by message subtype, e.g. bot_message, file_share |
options (object)
| Property | Key | Type | Required | Default | Possible values |
|---|---|---|---|---|---|
| Max Messages Per Poll | maxMessages | number | No | 10 | Max messages processed per poll (clamped to 1-100) |
| Include Replies Also Sent to Channel | includeThreadReplies | boolean | No | false | Also trigger on thread replies that were sent to the channel as well. Replies that stay inside a thread are never returned by Slack for channel history, so this trigger cannot see them. |
Notes
channelIdis required; the node throws if it's missing.- If the channel has no messages in the poll window, or none survive filtering, the node returns
nulland the workflow does not trigger. - Filters are applied after fetch:
excludeBotsdrops messages with abot_idorbot_messagesubtype, and thread replies (thread_tsset and different fromts) are dropped unlessincludeThreadRepliesis set. - Emits one item containing
messages(array) and asummary(count,channel,users,previews— first 50 characters of each message,pollInterval,polledAt). - For webhook-based Slack events and interactive components, see the Slack Events Trigger and Slack Interactions Trigger.