Skip to main content

Slack

The slack trigger posts rich message notifications to Slack channels using incoming webhooks.

⚙️ Configuration Variables​

WUD_TRIGGER_SLACK_{trigger_name}_CHANNEL
Requiredstring

Target Slack channel name (without #) or channel ID

Allowed values:Channel name (`wud-updates`) or Channel ID (`C12345678`)
WUD_TRIGGER_SLACK_{trigger_name}_TOKEN
Requiredstring

Slack Bot or User OAuth access token

Allowed values:`xoxb-...` or `xoxp-...`
WUD_TRIGGER_SLACK_{trigger_name}_DISABLETITLE
Optionalbooleandefault: false

Disable the default title heading to allow full custom message formatting

Channel & Bot Membership

The target Slack channel must already exist, and the WUD bot must be invited to private channels (/invite @BotName) for messages to post successfully.

info

This trigger also supports all common trigger configuration options (such as thresholds, scheduling, and batching).

🚀 Examples​

Post Notifications to a Slack Channel​

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_TRIGGER_SLACK_LOCAL_TOKEN=xoxb-123456789-abcdef
      - WUD_TRIGGER_SLACK_LOCAL_CHANNEL=wud-notifications

📖 Setup Guide: Creating a Slack Bot Token​

  1. Go to the Slack API Apps Console and click Create New App > From scratch.
  2. Under OAuth & Permissions > Scopes, add the chat:write and chat:write.public bot token scopes.
  3. Install the app to your workspace and copy the generated Bot User OAuth Token (xoxb-...).
  4. Set the token as WUD_TRIGGER_SLACK_{trigger_name}_TOKEN.