> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack: Bot Mentioned

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

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": []
    }
  }
}
```

**Reference trigger output**

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`.