Buddy communicates with the Slack API via a dedicated app. While cloud accounts use the official Buddy app by default, on-premises users need to configure the application by hand. This is performed when adding the Slack integration for the first time, or from the 3-rd Party Apps tab in the admin settings of your instance.

Due to changes in Slack's authorization mode, applications created after February 24, 2021, are no longer able to communicate with Slack's API. With the release of Buddy v2.3.107, however, it is now possible to migrate your existing Slack app so that it supports the new authorization.

Without the migration, it is not possible to add new Slack integrations regardless of your client version. All existing ones, however, will continue to work uninterrupted.

This applies to Buddy on-premises only – cloud users are not affected by this change.

What you need to do

To update Slack application, you need to do two things:

  1. Upgrade your instance to v2.3.107 or newer.
  2. Update your Buddy application on Slack so that it supports granular scopes.

Migrating Slack app to granular scopes

  1. Visit api.slack.com/apps.
  2. Find and edit the app you are using for Buddy standalone.
  3. Under the Tools section, click the Update to Granular Scopes option:

Slack app settingsSlack app settings

  1. Now you have to select the scopes for your Slack bot. Make sure to select the following:
channels:read
chat:write
groups:read
team:read
users:read
files:write

Updating app scopesUpdating app scopes

  1. Continue to the next step. You will be prompted to select user token scopes – do not select anything here and proceed:

User token scopesUser token scopes

  1. Step 3 is just a verification step. Review your scopes and if everything checks out click Yes, migrate my app:

VerificationVerification

And that's it – your Slack app has been migrated and you can add new integrations again.

If you're having any trouble with the process, feel free to contact our support and we'll' do our best to help you out.