Docs

Get started / Install in Slack

Initial Slack App Setup

Connect Risotto's Marketplace app to your Slack workspace from the Slack integration page in the Risotto dashboard.

Connect Risotto's Slack app to your Slack workspace so employees can ask for help in Slack. This page installs the Marketplace app, the recommended option, with Risotto's default name and icon.

Before you start:

  • You need to be an Org Admin or Manager in Risotto. Only they see Integrations in the settings.
  • You need to be able to install apps in your Slack workspace. If your workspace requires app approval, a Workspace Owner may need to approve the app first. See Slack's Manage app approval for your workspace.
  1. Open Settings

    In the Risotto dashboard, click Settings at the bottom of the left sidebar.

  2. Open Integrations

    In the settings sidebar, click Integrations.

  3. Open Slack

    Click the Slack card. On the Overview tab, it is in the Request sources group. You can also type "Slack" in Search integrations.

  4. Connect the Marketplace app

    On the Chat app card ("Connect Risotto to your Slack workspace."), click Connect, then Marketplace app. Slack's permission page opens in the same tab.

  5. Choose the workspace

    Slack's page reads "Risotto is requesting permission to access the … Slack workspace". Check the workspace in the top-right corner, and pick another one there if you need to. The page lists what Risotto will be able to view and do in the workspace.

  6. Allow access

    Click Allow at the bottom of the page. Slack returns you to Slack's page in the Risotto dashboard, which now shows Connected.

The Chat app card now shows the install type, your workspace, and Risotto's bot user. For what each row means, and how to refresh or disconnect the app, see Slack on the Integrations page.

Enterprise Grid

If your Slack workspace joins an Enterprise Grid organization, its Marketplace app install keeps working in that workspace. The Chat app card shows Install type Workspace. To use Risotto in more workspaces of the organization, install the app for the whole organization. The person who does this must be a Slack org owner or org admin, and an Org Admin or Manager in Risotto.

  1. Disconnect Slack

    In Settings > Integrations, click the Slack card. Click Connected on the Chat app card, then Disconnect....

  2. Connect for the whole organization

    Click Connect, then Marketplace app. On the Slack authorization page, select your organization in the dropdown at the top right, not a workspace. Click Allow. The card now shows Install type Enterprise Grid (org-wide).

  3. Add the app to workspaces

    Slack does not add an organization app to any workspace by itself. Add the app to each workspace where employees ask for help, then invite it to your help channels. Follow the last three steps in Enterprise Grid of the custom app guide.

Next step

Create the Slack channels Risotto works in, and add Risotto to them. See Initial Slack Channel Setup.

Something wrong or missing? Report an issue · View as Markdown