naumu
IntegrationsSlack

Slack

Connect Slack so Naumu can share updates and your team can work with the graph from Slack.

Updated June 2, 20264 min read

Connecting Naumu to Slack happens in two layers:

  1. An admin installs the Naumu app on a Slack workspace and binds it to one Naumu space. (A workspace is your team's shared Slack home; a space is a Naumu knowledge graph.)
  2. Each teammate links their own Slack account once. After that, they can chat with that space — and trigger Naumu AI actions — without leaving Slack.

A Naumu space connects to one Slack workspace at a time, and each workspace binds to one space. This keeps it clear which graph the bot is working with.

Install the app on a workspace

Installing is an admin task, and you do it entirely from inside Naumu — there is no command line or external setup.

  1. Open the space you want to connect.
  2. Go to Settings → Integrations.
  3. In the Slack card, select Connect Slack.
  4. Slack opens so you can authorize the Naumu app. Approve the requested permissions.
  5. Slack sends you back to Naumu and opens a fresh Slack connected thread, confirming the workspace is bound.

You must be a member of the space to install. Naumu checks this before sending you to Slack, so the bot is only ever bound to a space you actually belong to.

If the workspace is already connected to a different Naumu space, the install is rejected rather than silently re-bound. Disconnect the existing one first.

Installing the app connects the workspace, but it does not connect you personally. Each teammate links their own account once, so Naumu knows which Naumu user is speaking when a message arrives from Slack.

  1. In Slack, send a direct message (DM) to the Naumu bot, or @mention it in a channel.
  2. The bot replies with a Connect Naumu account button. (In a public channel, this prompt is private to you, so no one else can link your Slack identity to their account.)
  3. Select the button. A Naumu page opens to confirm the link.
  4. Sign in to Naumu if you aren't already, review the account, space, and workspace shown, then select Connect.

The link button expires after about 10 minutes. If it lapses, message the bot again for a fresh one.

You must sign into the Naumu account that belongs to the connected space. If you're signed into the wrong account, the page blocks the link and offers a Switch account option before anything is saved.

You can see who on your team has linked, and unlink your own account, under Settings → Integrations in the connected space.

Work with the graph from Slack

Once you're linked, Naumu acts as you in Slack. There are two ways to talk to it, and both work the same way:

  • Direct messages — a private, one-on-one chat with the Naumu bot.
  • @mentions in a channel — the bot reads the surrounding thread and recent channel messages for context, then replies in that thread.

Ask questions in plain language. Naumu answers from your connected space's graph and can make the same kinds of changes it makes in the Naumu chat — the agent behind Slack is the same one you use on the web. Each Slack conversation maps to a thread in Naumu, so your history is preserved on both sides.

Since Slack only shows the chat, each reply includes an Open in Naumu link to jump to the graph, notes, and views behind an answer.

Manage and disconnect

You can manage everything from Settings → Integrations in the connected space:

ActionWhoEffect
Disconnect workspaceSpace memberNaumu stops answering in that Slack workspace; anyone who messages the bot sees a one-time notice.
Unlink your accountYouNaumu stops responding to you in Slack until you reconnect.

Disconnecting in Naumu stops the bot from responding. To remove the app from Slack entirely, go to Slack → Apps → Naumu → Remove app.

  • Spaces — the space a Slack workspace binds to
  • Views — what the Open in Naumu link surfaces alongside a chat answer
Anything missing?
Tell us what would make these docs better.