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
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.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
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.
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.
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.
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
Open the department's General settings
Under Departments in the settings sidebar, click IT (or the department this channel serves), then click General.
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.
Open the department's Escalations settings
Go back to the department's page, for example by clicking IT in the breadcrumbs, and click Escalations.
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
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.
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.
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:
- Complete your organization setup.
- Test Risotto with your team. See Testing methods.
- Learn how requests in Slack become tickets. See Creating tickets from Slack.
Something wrong or missing? Report an issue · View as Markdown