Docs

Get started / Install in Slack

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

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

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.

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.

  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.

  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.

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.

    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.

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

  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.

  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.

Next steps

Once your Slack channels are set up:

  1. Complete your organization setup.
  2. Test Risotto with your team. See Testing methods.
  3. Learn how requests in Slack become tickets. See Creating tickets from Slack.

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