Skip to content
English
Do you need help? Customer portal
neowit.io
  • There are no suggestions because the search field is empty.

Connect a Slack workspace to Workflow engine

Connect a Slack workspace so your workflows can send direct messages and post to channels. For organization admins setting Slack up. For the workflow nodes this integration registers (Slack DM, Post to Channel) and how to configure them, see Slack in Workflows.

Prerequisites

  • A Slack workspace where you have permission to install apps.
  • Admin access to Neowit Settings → Integrations.

Option A: Add to Slack (recommended)

If your Neowit deployment has the Slack app configured for one-click install:

  1. In Settings → Integrations, choose Slack.
  2. Click Add to Slack.
  3. Approve the requested permissions in Slack.
  4. You're redirected back to Neowit with the integration configured automatically.

Option B: Install your own Slack app

If one-click install isn't available, create a Slack app and paste its bot token:

  1. Go to api.slack.com/apps → Create New App → From scratch.
  2. Name it (e.g. "Neowit Workflows") and pick your workspace.
  3. Under OAuth & Permissions, add these Bot Token Scopes:
    Scope Purpose
    chat:write Send messages to channels and users
    channels:read List and look up public channels
    channels:join Auto-join public channels when posting
    groups:read List and look up private channels
    users:read Look up user information
    users:read.email Look up users by email address
  4. Click Install to Workspace and Allow.
  5. Copy the Bot User OAuth Token (starts with xoxb-).
  6. In Neowit Settings → Integrations → Add Integration, choose Slack, paste the token, and save. Neowit verifies the token and registers the Slack nodes.

Note: The bot token is admin-equivalent for messaging. Store it securely and never commit it to version control. If it leaks, revoke it on the OAuth & Permissions page and reinstall the app.

Posting to channels

  • Public channels — the bot auto-joins a public channel the first time it posts.
  • Private channels — invite the bot first with /invite @YourBotName; otherwise the post fails with not_in_channel.