# Initial Slack Channel Setup

Create a request channel and an agent channel in Slack, add Risotto to both, turn off Silent mode in the request channel, and connect the agent channel to a department.

Risotto works from two Slack channels:

- A public **request channel**, where employees ask for help. Risotto replies there and opens a ticket for each request.
- A private **agent channel**, where your team sees each ticket and follows its conversation.

You create both channels in Slack, add Risotto to them, then set them up in the Risotto dashboard. Before you start, connect Risotto's Slack app (see [Initial Slack App Setup](https://www.tryrisotto.com/docs/guides/initial/slack-app)). The dashboard steps need the Org Admin role.

## Create the two channels in Slack

1. **Create the agent channel**

   In Slack, click the plus sign in the sidebar and select **Channel**. If
   Slack offers templates, choose **Blank channel**. Name the channel, for
   example `#risotto-agents-test`, make it **Private**, and click
   **Create**. You can skip adding people for now.

   *Product example: Slack's Create a channel dialog, in outline, with a private agent channel named and Create.*

2. **Create the request channel**

   Create a second channel the same way, for example
   `#risotto-requests-test`, and leave it **Public** so employees can find
   it and post in it.

For Slack's own steps, see [Create a channel](https://slack.com/help/articles/201402297-Create-a-channel) in Slack's help.

## Add Risotto to both channels

1. **Mention Risotto in each channel**

   In each channel, send a message that mentions `@Risotto` (or your bot's
   name, if you use a custom app). Slackbot replies, visible only to you,
   that Risotto is not in the channel, and offers to add it. Click **Add
   Them**. Risotto joins and posts a message saying that it monitors the
   channel.

   *Product example: Slackbot offering to add Risotto to the request channel, in outline, with Add Them.*

You can also add Risotto from the channel's details in Slack: click the channel name in the channel header, then open the **Agents & apps** tab.

> **Note:** If your workspace has more than one Risotto app (for example a staging
> install), pick the one connected to your dashboard from Slack's autocomplete
> list.

## Set up the channels in Risotto

A channel Risotto joins starts with **Silent mode** on: Risotto does not reply to questions there. Turn it off in the request channel only.

1. **Open the Slack request settings**

   In the Risotto dashboard, go to **Settings > Request Sources**. The
   **Slack** card lists **App Home**, **Direct Messages**, and each channel
   Risotto has joined, with "Silent mode" under each new channel. Check that
   both of your channels are there, then click **Manage in Slack**. Slack's
   page opens on its **Requests** tab.

   *Product example: Settings, Request Sources in the Risotto dashboard, with the Slack card and Manage in Slack.*

2. **Turn off Silent mode in the request channel**

   On the **Slack channels** card, click the request channel's row to open
   it, and turn **Silent mode** off. The message "Channel setting updated"
   confirms the change. With Silent mode off, the row also shows **Continue
   over DM**, **Prompt for escalation**, and **Ticket everything**.

   *Product example: Slack's Requests tab in the Risotto dashboard, with the request channel's Silent mode switch.*

3. **Leave Silent mode on in the agent channel**

   Open the agent channel's row and check that **Silent mode** is still on.
   The agent channel is where your team works on tickets, not where
   employees ask for help.

For every setting on a channel's row, see [Channel settings](https://www.tryrisotto.com/docs/dashboard/settings/request-sources#channel-settings).

## Connect the agent channel to a department

1. **Open the department's General settings**

   Under **Departments** in the settings sidebar, click **IT** (or the
   department this channel serves), then click **General**.

2. **Choose the agent channel**

   Next to **Agent Channel**, click **Select channel...**, search for your
   agent channel by name, and select it. Then click **Save** on the
   **General Settings** card.

   *Product example: A department's General settings in the Risotto dashboard, with the Agent Channel picker searching for the agent channel.*

   A channel created in the last few minutes may not be listed yet. Wait a
   few minutes, or paste its channel ID and choose **Use channel ID**. In
   Slack, the ID is at the bottom of the **About** tab of the channel's
   details.

3. **Open the department's Escalations settings**

   Go back to the department's page, for example by clicking **IT** in the
   breadcrumbs, and click **Escalations**.

4. **Add an escalation contact**

   Next to **Escalation contact**, click **Add escalation contact** and pick
   a person. To use a Slack user group, paste its ID (it starts with `S`)
   and choose it. Risotto tags this contact when it needs help. Click
   **Save**.

   *Product example: A department's Escalations settings in the Risotto dashboard, with Add escalation contact.*

A sub-department uses its parent's agent channel, so you set the channel on the top-level department only. For more on these settings, see [Agent channel](https://www.tryrisotto.com/docs/dashboard/settings/departments#agent-channel) and [Escalations](https://www.tryrisotto.com/docs/dashboard/settings/departments#escalations). Slack's **Departments** tab, next to **Requests**, lists each department's agent channel and escalation contact.

## Test it

1. **Ask a question in the request channel**

   In the request channel, post a question such as "Hi, can I get help with
   my laptop?". Risotto opens a ticket and replies in a thread. While it
   works, its steps show in the thread, starting with "Creating ticket
   IT-142: …". When it answers, the steps stay above the reply, collapsed
   under "Responded and created ticket IT-142", unless **Keep thinking
   steps** is off for the channel. See [Thinking
   steps](https://www.tryrisotto.com/docs/concepts/ticket-lifecycle#thinking-steps).

   *Product example: Risotto's reply in the test message's Slack thread, in outline, under Responded and created ticket IT-142.*

2. **Check the agent channel**

   In the agent channel, Risotto posts the ticket: its ID, which links to the
   ticket in the dashboard, and its title, which links to your message,
   followed by the request channel's name. Slack shows the requester, the
   department, and your message with it. Open the post's thread to follow
   the conversation. See [What your team
   sees](https://www.tryrisotto.com/docs/operating/creating-tickets#what-your-team-sees).

   *Product example: Risotto's post for ticket IT-142 in #risotto-agents-test, in outline: the ticket ID and title, a card with the requester, department and request, and the thread's replies.*

3. **Find the ticket in the dashboard**

   In the dashboard, go to **Tickets > All** and open your test ticket.
   Under **Properties**, check that **Department** is the department you set up.

   *Product example: Tickets, All in the Risotto dashboard, with test ticket IT-142.*

   *Product example: Test ticket IT-142's details in the Risotto dashboard, with its Department.*

## Next steps

Once your Slack channels are set up:

1. Complete your [organization setup](https://www.tryrisotto.com/docs/guides/initial/org-setup).
2. Test Risotto with your team. See [Testing methods](https://www.tryrisotto.com/docs/guides/risotto-poc/testing-methods).
3. Learn how requests in Slack become tickets. See [Creating tickets from Slack](https://www.tryrisotto.com/docs/operating/creating-tickets).

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