Slack

Use Slack as a messaging channel for your agent. Users can DM or @mention the bot. Novu keeps thread context, shows typing and plan cards during the turn, can attach files on replies, and can post Approve / Deny cards before gated tools run.

Capabilities

Full matrix: Channels overview.

Examples

Inbound thread

A user @mentions the agent in a thread. Novu adds an eyes reaction, shows typing and a plan card while the agent runs tools, then replies in the same thread with optional action buttons.

Tool approval

When a tool is gated, Slack shows a native approval block (Deny, Approve once, Always allow this tool). The handler resumes after the user selects an option.

Create a Slack app

When the dashboard or CLI asks for a Slack App Configuration Token:

1. Open Slack API apps.
2. Under Your App Configuration Tokens, click Generate Token.

3. Select your workspace and click Generate.
4. Copy the token (starts with xoxe.xoxp-) and paste it into Novu or the CLI.
5. Finish the install / Allow flow in Slack.

The configuration token is used once to create the Slack app. Novu does not store it.

Setup

Connect component

Use SlackConnectButton from @novu/react so end users can install the Slack app and link it to your agent from your product UI.

import { NovuProvider, SlackConnectButton } from '@novu/react';

export function SlackConnect() {
  const subscriberId = 'subscriber-id';
  const integrationIdentifier = 'slack-integration-identifier';
  const agentIdentifier = 'agent-identifier';

  return (
    <NovuProvider
      applicationIdentifier={process.env.NEXT_PUBLIC_NOVU_APPLICATION_IDENTIFIER!}
      subscriberId={subscriberId}
    >
      <SlackConnectButton
        integrationIdentifier={integrationIdentifier}
        connectionIdentifier={`${subscriberId}:${integrationIdentifier}:${agentIdentifier}`}
        connectionMode="subscriber"
        connectLabel="Install agent ↗"
        connectedLabel="Connected to Slack"
        onConnectSuccess={() => {
          // Workspace linked
        }}
        onConnectError={(error: unknown) => {
          console.error(error);
        }}
      />
    </NovuProvider>
  );
}

Props and appearance options: Connect components.

Related