Setting up Guru's App for Slack

Guru’s Slack app makes it easy to access your team’s knowledge directly within Slack. This guide walks through how to install the app, invite it to channels, and configure Knowledge Agents to provide automatic answers.

👥

Access Required

  • You must be a Guru workspace admin to install the Slack app.
  • You may need to be a Slack admin depending on your org’s app permissions.
  • To use Knowledge Agents, you must be on the All-In-One or Enterprise plan.

Installing the Guru app for Slack

  1. Navigate to Manage > Apps and Integrations in the Guru web app.
  2. Click Slack and select Add Slack workspace.
  3. Follow the prompts to authenticate and connect Guru to your Slack workspace.
  4. Guru will match users by email:
    • If emails match between Slack and Guru, the user is automatically linked.
    • If there’s a mismatch, an admin can manually link accounts using the command:
      link user @SlackUsername GuruEmailAddress
  5. When setup is complete, the Guru app will introduce itself in Slack.

✍️

Note

For Enterprise Grid, make sure to select the correct Slack workspace from the dropdown in the top right during setup.

Slack install screenshot


Inviting Guru to Slack channels

To activate Guru in a channel:

  • Run /invite @guru in any public or private Slack channel.
  • Or go to Channel > Integrations > Add apps > Guru.

Learn more from Slack’s Help Center.


Enabling Knowledge Agents in Slack

If your workspace has Knowledge Agents enabled, Guru can provide AI-generated answers to questions in Slack—either automatically or when directly mentioned (e.g., @guru how do I request paid time off?).

Connecting a channel to the default Knowledge Agent

  1. Go to Manage > Knowledge Agents.
  2. Find Guru’s Default Knowledge Agent, which has access to all Collections and sources.
  3. Make sure the Slack channel has added the Guru app (via Channel > Integrations > Add Apps > Guru).
  4. Optionally, toggle Limit responses to sources shared with All Members to avoid sharing restricted content.

Connecting a channel to a specific Knowledge Agent

To create a focused knowledge experience:

  1. Navigate to Manage > Knowledge Agents.
  2. Set up a Knowledge Agent with:
    • Access permissions
    • Source selection
    • A custom response prompt
  3. Go to the Slack Channel tab in the Agent setup.
  4. Add the Guru app to the selected channel.
  5. Optionally, enable Limit responses to sources shared with All Members.

💡

Tip

Create a “HR Buddy” Knowledge Agent to answer HR-related questions in internal channels.

💡

Tip

Seeing different answers in Slack vs. Guru's web app?
This may be due to the Limit responses to sources shared with All Members setting being enabled in Slack. Admins can adjust this under Manage > Knowledge Agents.

Once configured, Guru will suggest answers automatically in the connected channels. All Slack users will see the suggested answers, but only licensed Guru users can take actions like:

  • 👍 Mark as helpful
  • 👎 Mark as unhelpful
  • Search Guru
  • Ask an Expert

Managing Admin tools and commands

Admins can manage Guru’s Slack integration using commands inside Slack.

Viewing available admin commands

  • DM @guru help admin
  • Or go to the Messages tab in the Guru Slack app and type help admin

Linking users

If Guru didn’t automatically link users, use: link user @SlackUsername GuruEmailAddress

Showing team configuration

To see which Slack users are linked to Guru accounts: show team config

Or click Show Team in the Guru app in Slack.


Frequently asked questions

What happens if the admin who installed Guru leaves?
Guru will assign another admin as the integration owner. If no admin is available, the Slack integration will be disabled. A new admin can reinstall it under Manage > Apps and Integrations.

Can I link one Guru workspace to multiple Slack accounts?
Yes, you can link one Guru workspace to multiple Slack workspaces.
However, you cannot link one Slack workspace to multiple Guru workspaces unless you use Slack Enterprise Grid.

Why do I see “you can not associate this Slack team with another Guru team”?
This error means your Slack team was previously linked to another Guru workspace. Contact Guru Support for help.

Why didn’t Guru suggest an answer?
Check the following:

  • Is Guru connected to Slack in Settings > Apps and Integrations?
  • Has the app been invited to the channel (/invite @guru)?
  • Is the channel connected to a Knowledge Agent?
    • If so, does the person asking the question have the correct Permissions?
    • If so, is Limit responses to sources shared with All Members toggled on?
  • Is the user linked to a Guru user? Use help admin to check.
  • Was the message a question? Guru detects intent without needing a ?.
  • Was the question asked in a thread or DM?
    • Automatic suggestions do not appear in threads or DMs.
    • Use @guru in threads to trigger a suggestion.

Can I view past questions and answers?
Yes. Admins can review these in the AI Training Center.


👀

Want a closer look at some key Guru features and best practices?

Check out our events page for demos, workshops, new release roundups, Getting Started bootcamp, guest panelists and more! For upcoming live events and a library of past recordings: Click here to register