Iris.Md logoIris.Md
← All channels

Slack

stable

Socket mode, threads, App Home, message shortcuts.

In
✓
Out
✓
Auth
OAuth + app token
§ Required environment

Env vars

IRIS_SLACK_BOT_TOKEN
Required

xoxb- bot token from your Slack app.

IRIS_SLACK_APP_TOKEN
Required

xapp- app-level token with connections:write for Socket Mode.

IRIS_SLACK_SIGNING_SECRET
Required

Signing secret used to verify event payloads.

§ Setup

Step by step

  1. 01

    Create a Slack app

    From api.slack.com/apps, create a new app from manifest and paste the manifest shipped in docs/slack-manifest.yaml.

  2. 02

    Install to your workspace

    Install the app, then copy the bot token, app token, and signing secret.

    export IRIS_SLACK_BOT_TOKEN="xoxb-..."
export IRIS_SLACK_APP_TOKEN="xapp-..."
export IRIS_SLACK_SIGNING_SECRET="..."
  3. 03

    Enable Socket Mode

    Socket Mode lets the agent run without exposing a public URL. Enable it under Settings → Socket Mode in the Slack app config.

  4. 04

    Start the channel

    Bring Slack online.

    iris channels enable slack
§ Success

You're done when

  • ✓App is installed in your workspace
  • ✓Socket Mode is enabled
  • ✓iris channels list shows slack: ok
  • ✓Mentioning @iris in a channel gets a reply