Slack: Bot Mentioned

Trigger Communications

Triggers when someone @-mentions your bot in a Slack channel. Great for building chatbots, support workflows, and interactive automations.

At a Glance

Field	Value
Trigger ID	slack-mentions
Category	Communications
Tags	slack, messaging, mentions, chatbot, communication, notification

Trigger Configuration

Field	Type	Required	Description
channelId	string	Yes	The Slack channel ID to monitor for mentions (e.g. C01ABC2DEF3). Find this in the channel details panel.
botToken	string	Yes	Slack Bot User OAuth Token (xoxb-...). Requires conversations:history and auth:test scopes.

Trigger Result

Field	Type	Required	Description
channelId	string	Yes	The Slack channel ID where the mention occurred
userId	string	Yes	The Slack user ID of the person who mentioned the bot
text	string	Yes	The full message text containing the mention
timestamp	string	Yes	Slack message timestamp (ts) — unique identifier for the message
threadTs	string	No	Thread timestamp if the mention was in a thread (empty if top-level message)
triggeredAt	string	Yes	Timestamp when the mention was detected (UTC, RFC3339 format)

Workflow Root Example

json
{  "nodes": {    "root": {      "type": "slack-mentions",      "payload": {        "channelId": "C01ABC2DEF3",        "botToken": "configured-in-b3os"      },      "children": [        "log_event"      ]    },    "log_event": {      "type": "log",      "payload": {        "message": "Triggered at {{$trigger.triggeredAt}}"      },      "children": []    }  }}

Downstream nodes can use {{$trigger.triggeredAt}} and any result fields listed above. Event triggers usually expose the raw source payload under a field such as event, body, trade, or raw.