Slack

Slack integration enables notifications to be sent as direct messages or to channels in your Slack workspace.

Configuration

To create a chat channel with Slack, configure the following:

Prerequisites

Before configuring Slack in Notiflows:

1. A Slack workspace
2. A Slack app created at api.slack.com/apps

Creating a Slack App

1. Go to api.slack.com/apps
2. Click Create New App > From scratch
3. Enter an app name and select your workspace
4. Go to OAuth & Permissions and add the following bot token scopes:
   • chat:write — Send messages
   • chat:write.public — Send messages to channels without joining
   • channels:read — List public channels
   • groups:read — List private channels
   • users:read — Look up users (optional, for user ID resolution)
   • users:read.email — Look up users by email (optional)
5. Click Install to Workspace and authorize the app
6. Copy the Bot User OAuth Token (xoxb-...)

Setup in Notiflows

1. Navigate to Channels in your project
2. Click Create Channel
3. Select Chat as the channel type
4. Select Slack as the provider
5. Paste your Bot Token
6. Save the channel

User Channel Settings

To send Slack notifications to a user, set their Slack channel settings via the Admin API:

curl -X PUT /api/admin/v1/users/:user_external_id/channel-settings/:channel_id \
  -d '{ "settings": { "slack_user_id": "U0123456789" } }'

At least one must be provided. To find a user's Slack member ID, open their profile in Slack and click Copy member ID.

Templates

Chat templates support two content types:

• Markdown — Simple markdown formatting, converted to Slack's mrkdwn format
• JSON — Slack Block Kit format for rich messages

Use Liquid templating for dynamic content:

New order from {{ actor.first_name }}: #{{ data.order_id }}

Available variable contexts:

• recipient.* — Recipient user data
• actor.* — User who triggered the notification
• data.* — Custom payload passed when triggering the notiflow