Custom Slack App Setup
Create & publish a custom Risotto Slack App with customizable icon and name
Risotto supports full customization of its Slack integration. This is achieved by you self-publishing a custom Slack app & connecting it back to Risotto. This allows you to customize the app icon, name, and other display settings.
The Risotto team has no privileges to modify or set this app up for you. This is an application owned by your organization.
To watch the whole setup first, see the three-minute video.
When you first sign in to a new Risotto org, connect Slack from Settings > Integrations > Slack.
Creating the Custom Slack App
Install the custom Slack app from Settings > Integrations. Click the Slack card.
On the Chat app card, click Connect. A menu opens with two choices. Click Custom app... ("Create your own Slack app from a Risotto manifest, with your own bot name."). The other choice, Marketplace app, installs the Risotto app from the Slack Marketplace instead.
A Customize Your Slack App dialog opens with a single required field, Bot Name, described as "the name of the bot that users will see in Slack." The default name will be set to "Risotto". This is easy to update later. Click Continue.
Slack Configuration Steps
After the manifest downloads, Risotto shows a Slack App Settings panel ("Create your Slack app. Then enter the credentials below to complete the setup."). The left side lists the same instructions as the steps below. The right side has four required fields you will fill in at the end: App ID, Client ID, Client Secret, and Signing Secret, followed by Connect and Back buttons. Leave this panel open while you work through the Slack steps.
Download Json File
Open the downloaded manifest file and copy its contents. It will be called "slack-manifest.json" & is unique for each Risotto org
Log into Slack as an admin
Navigate to https://api.slack.com/apps/
Create App
Click the green Create New App button on the Your Apps page.
Select "From a Manifest"
In the Create an app dialog, Slack asks how you'd like to configure your app's scopes and settings. Choose From a manifest ("Use a manifest file to add your app's basic info, scopes, settings & features to your app"), not From scratch.
Select Workspace
In the Pick a workspace to develop your app dialog (step 1 of 3), choose your Slack workspace from the dropdown and click Next. Slack notes that you can't change the app's workspace later, and the workspace controls the app even if you leave it. Use Sign into a different workspace if the right one isn't listed.
Add JSON Manifest
The Create app from manifest dialog shows a code editor with JSON and YAML tabs. Stay on the JSON tab, delete the placeholder content, and paste the contents of the downloaded slack-manifest.json file. The pasted manifest begins with a
display_informationblock containing the bot name, a short description ("I'm an AI-powered help desk assistant! How can I help?"), a background color, and a long description. Click Next.Review & Create
The Review summary & create your app dialog (step 3 of 3) has OAuth, Features, and Settings tabs. The OAuth tab lists 31 bot scopes (for example
app_mentions:read,channels:history,chat:write,im:history,reactions:write,users:read.email) and one redirect URL pointing athttps://api.tryrisotto.com/org/<your org ID>/slack/.... Review & select Create.Allow DMs to Risotto
In the left sidebar of your app's settings, under the Features heading, navigate to App Home. Scroll to the Messages Tab section ("Direct messages your app sends will show in this tab"). Make sure the Messages Tab toggle is on, then check the box
Allow users to send Slash commands and messages from the messages tab.Verify Risotto URL
Navigate to App Manifest (near the bottom of the Features list in the sidebar). A yellow warning banner at the top of the page says the
settings.event_subscriptions.request_urlURL isn't verified and shows the Risotto events URL (https://api.tryrisotto.com/org/<your org ID>/slack/events). Click the Click here to verify link in that banner. The banner disappears once verification succeeds.Customize Risotto Look
Navigate to Basic Information (the first item under Settings in the sidebar) & scroll down to the Display Information section. Here you can edit the App name, Short description, App icon & Preview, Background color, and Long description. The manifest sets the short description to "I'm an AI-powered help desk assistant! How can I help?" and the background color to
#774C60; the preview shows how the icon, name, and description appear together. Upload a square icon under App icon & Preview.Sample Slack Bot Icons


Save Credentials
Navigate back to the top of Basic Information. The App Credentials card lists App ID, Date of App Creation, Client ID, Client Secret, Signing Secret, and Verification Token. Copy the App ID, Client ID, Client Secret, and Signing Secret into the matching fields of the Slack App Settings panel in the Risotto dashboard. You do not need the Verification Token.
The Client Secret and Signing Secret fields are masked by default, with Show and Regenerate buttons to their right. Click Show before copying each one. Once pasted into Risotto, the secret fields display as dots and Risotto reminds you under each field: "Be sure to click Show to display the secret before copying it."
Install Risotto
Select Connect in the Risotto dashboard. Slack opens an authorization page titled "Risotto is requesting permission to access the [your workspace] Slack workspace", with a banner noting the app was created by a member of your workspace. It lists what Risotto will be able to view (content and info about channels & conversations, and about your workspace) and do (perform actions in channels & conversations, and in your workspace). Click Allow.
If your Slack organization is on Enterprise Grid, select your organization on this page instead of a workspace. See Enterprise Grid.
Multiple Slack workspaces
One Risotto organization holds one Slack connection.
- Enterprise Grid. Install your custom app once for the whole Slack organization. One Risotto organization then takes requests from every workspace that you add the app to. See Enterprise Grid.
- Separate workspaces (not on Enterprise Grid). Each workspace needs its own Risotto organization. If you connect a second workspace to the same Risotto organization, it replaces the first connection.
If a workspace is already connected to a different Risotto organization, the install stops with "The Risotto app is already installed to your workspace under a different organization." Disconnect the app from that organization first.
To send each workspace's requests to its own department, give each workspace its own help channel and set Lock to department on it. See Request sources.
Enterprise Grid
On Enterprise Grid, you install your custom app at the organization level, not in one workspace. Then you add the app to each workspace where employees ask for help. Risotto identifies your Slack organization on each message, so requests from every added workspace arrive in the same Risotto organization.
The manifest that Risotto downloads allows an install at the organization level. A custom app that you created before August 20, 2026 does not allow it until you update its manifest. See Switch an existing app to the organization.
Before you start, make sure that the person who installs the app has both roles:
- Slack: org owner or org admin. Slack does not let a workspace admin install an app for the organization.
- Risotto: Org Admin or Manager, because they click Connect in the Risotto dashboard. See Invite users.
Create the app
Complete Creating the Custom Slack App and the Slack Configuration Steps up to Save Credentials.
Connect for the whole organization
Click Connect in the Risotto dashboard. On the Slack authorization page, open the dropdown at the top right and select your organization, not a workspace. Click Allow.
Open the installed apps
In Slack, click your organization name, then Tools & settings > Organization settings. In the left sidebar, click Integrations, then the Installed apps tab.
Add the app to workspaces
Find your Risotto app, click the three dots to its right, and select Add to more workspaces. Check each workspace where employees ask for help, click Next, check I'm ready to add this app, and click Add App. To see the new workspaces on the Slack card in Risotto at once, click Connected and choose Refresh.
Add your help channels
In each workspace, invite the app to your help channels. Then configure each channel in Request sources.
Slack does not add an org-level app to any workspace by itself. Risotto receives no messages from a workspace until you add the app to it.
When you install for the organization, Risotto does not import your Slack users at install time. Risotto adds each person when they first send a message that it receives.
Switch an existing app to the organization
Use these steps if your custom app is installed in one workspace today.
Update the manifest
Follow Update Slack App. The new manifest allows an install at the organization level.
Disconnect Slack
In Settings > Integrations, click the Slack card. Click Connected on the Chat app card, then Disconnect.... The card shows "Your custom Slack app has been disconnected from Risotto."
Reconnect for the whole organization
Click the three dots on the Chat app card, then Reconnect.... On the Slack authorization page, select your organization at the top right, not a workspace. Click Allow. The new connection replaces the workspace connection.
Add the app to workspaces
Complete the last three steps in Enterprise Grid.
Optional: Adding Collaborators
Navigate to https://api.slack.com/apps/ & find the Risotto app. In the left sidebar under Settings, open Collaborators. The page ("Add members collaborating on this app") lists the current collaborators, starting with you, and has an Add a member... field where you can search for and add workspace members. Collaborators can edit, submit, and delete the app, and collaborators who are full members can manage other collaborators.
Next Steps
After setting up your custom Slack app:
- Test the integration by sending a message to Risotto
- Configure your Slack helpdesk settings
- Complete your organization setup
Something wrong or missing? Report an issue