Set up your org and accounts for Slack (video)
A three-minute video of the twelve steps from signing up for Risotto to the first request in Slack, with your own custom Slack app.
Watch the whole setup in three minutes: create your Risotto organization, add your IT team, connect a custom Slack app with your own bot name, and send the first request. Each step below links to its written guide.
Before you start, make sure you can 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.
The twelve steps
Create your account
Sign up for Risotto, then create your organization with your company's name. Risotto sets up two departments for you, IT and HR, and IT is the default.
Invite your teammates
Open the organization menu at the top of the sidebar and choose Organization settings. Under Members, add their work emails, pick a role, and send the invitations. See Invite users.
Add them to IT
Once they've accepted, go to Settings > Departments > IT > Members, click Add a member and pick each person. New members join as Agents, so make your IT leads Supervisors.
Edit the department settings
On IT's General page, write a clear description of what IT handles: Risotto uses it to route requests to the right team. Check the ticket prefix, then click Save. See Departments.
Download the Slack manifest
In Settings > Integrations > Slack, click Connect on the Chat app card, then Custom app.... Name your bot and click Continue. Risotto downloads your manifest file. See Custom Slack App Setup.
Create the Slack app
In a new tab, open the Slack apps page. Click Create New App, choose From a manifest and pick your workspace. Paste the manifest into the JSON tab, click Next, then Create.
Turn on the Messages tab
In your new app, open App Home and turn on messages from the Messages tab. Without it, people can't DM the bot.
Copy the credentials, then install
Open Basic Information and copy the App ID, Client ID, Client Secret and Signing Secret into Risotto. Click Show before you copy each secret. Then click Connect and allow the install in Slack. You're back in Risotto, with Slack connected.
Create two test channels
In Slack, create a private channel for your IT team, like
#risotto-agents-test, and a public one where employees ask for help, like#ask-it-test. See Initial Slack Channel Setup.Add the bot to both channels
In each channel, type
/invite @Risotto, using your bot's name.Finish the wiring in Risotto
On IT's General page, set the Agent Channel to your private channel, so your team sees new requests there. Then, on the Slack Requests tab, find your help channel and turn Silent mode off. New channels start in Silent mode, so the bot won't answer until you do.
Send the first message
Post a question in your help channel. Risotto replies in the thread and creates ticket IT-1. Your team sees it in the agent channel, and it shows up under Tickets in the dashboard.
Next, connect your identity provider and your knowledge.
Something wrong or missing? Report an issue · View as Markdown