# 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.

> **Info:** To choose your own bot name and icon, create a custom Slack app instead. See
> [Custom Slack App Setup](https://www.tryrisotto.com/docs/guides/initial/slack-app-custom).

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](https://slack.com/help/articles/222386767-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**.

   *Product example: Settings, Integrations in the Risotto dashboard, with the Slack card under Request sources.*

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.

   *Product example: Slack's page in the Risotto dashboard, with the Connect menu open on Marketplace app.*

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.

   *Product example: Slack's permission page for Risotto, in outline, with the workspace picker and Allow.*

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**.

   *Product example: Slack's page in the Risotto dashboard after the Marketplace app is installed: Connected, on the Connections tab.*

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](https://www.tryrisotto.com/docs/dashboard/settings/integrations#slack) on the Integrations page.

> **Note:** Only one chat integration can be connected at a time. If Microsoft Teams is
> already connected, the **Connect** button on the **Chat app** card is turned
> off.

## 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.

> **Warning:** Plan a short gap in service. Risotto stops answering requests from the time
> you disconnect until you connect again.

1. **Disconnect Slack**

   In [Settings > Integrations](https://dashboard.tryrisotto.com/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](https://www.tryrisotto.com/docs/guides/initial/slack-app-custom#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](https://www.tryrisotto.com/docs/guides/initial/slack-helpdesk).

Source: https://www.tryrisotto.com/docs/guides/initial/slack-app
