Skip to main content
The Slack plugin connects Lukan to your Slack workspace using Socket Mode — no public URL needed.

​
Setup

​
1. Create a Slack App

  1. Go to api.slack.com/apps and create a new app
  2. In OAuth & Permissions, add bot scopes: chat:write, app_mentions:read, channels:history, im:history, groups:history
  3. In Socket Mode, enable it and create an App-Level Token with connections:write scope
  4. In Event Subscriptions, subscribe to app_mention and message.im
  5. Install the app to your workspace

​
2. Configure in Lukan

lukan plugin install slack
lukan sk config set botToken "xoxb-YOUR-BOT-TOKEN"
lukan sk config set appToken "xapp-YOUR-APP-TOKEN"
lukan plugin start slack

​
Configuration

FieldDescription
botTokenBot User OAuth Token (xoxb-...)
appTokenApp-Level Token for Socket Mode (xapp-...)
allowedChannelsChannel IDs where the bot responds (empty = everywhere)
allowedUsersUser IDs allowed to interact (empty = all)
prefixCommand prefix filter

​
Pipeline Approvals

Slack works as a notification channel for approval gates. You can use:
  • Channel ID (C01ABC123) — sends to the channel
  • User ID (U01XYZ789) — sends a DM to the user
To find IDs: right-click the channel or user in Slack and select Copy Link or View Details.