Docs

Admin / Maintenance

Update Slack App

Copy Risotto's current manifest into your custom Slack app, so it gets the scopes and settings that new features need.

A custom Slack app keeps the manifest it had when you created it. When Risotto adds a feature that needs new Slack scopes or settings, such as Slack ticket lists, forms, or an install across a whole Enterprise Grid organization, copy Risotto's current manifest into your app.

The manifest replaces your app's whole configuration in Slack. It keeps your bot's current name, but other changes that you made to the app in Slack are overwritten.

  1. Open Slack's integration page

    In the Risotto dashboard, go to Settings > Integrations and click the Slack card.

    If you run more than one Risotto organization, each has its own Slack app. Open the dashboard of the organization whose app you want to update.

  2. Open Update manifest

    On the Chat app card, click Connected, then click Update manifest....

  3. Copy the manifest

    The Update Slack App Manifest dialog opens. Read the Before you update warning, then click the copy button on the manifest.

  4. Open your app's App Manifest page

    In the dialog, click Slack Apps. Slack's settings for your app open. Click App Manifest in the sidebar.

  5. Replace the manifest and save

    Replace the contents of the manifest editor with the JSON that you copied, then click Save Changes.

  6. Verify the request URL

    If Slack shows that settings.event_subscriptions.request_url is not verified, click Click here to verify. The URL is Risotto's events URL for your organization, https://api.tryrisotto.com/org/<your org ID>/slack/events.

  7. Reinstall the app if Slack asks

    If Slack says that a reinstall is needed, for example because the manifest adds scopes, click Install App in the sidebar, then click Reinstall to Workspace.

  8. Test

    Send a test request to Risotto in Slack and check that it replies.

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