Update required: Slack API apps (On-premises)

Update required: Slack API apps (On-premises)

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.

Warning
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.
Hint
This applies to Buddy Self-Hosted 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:

Image loading...Slack 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

Image loading...Updating app scopes

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

Image loading...User token scopes

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

Image loading...Verification

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

Tip
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.
Jarek Dylewski

Jarek Dylewski

Customer Support

A journalist and an SEO specialist trying to find himself in the unforgiving world of coders. Gamer, a non-fiction literature fan and obsessive carnivore. Jarek uses his talents to convert the programming lingo into a cohesive and approachable narration.

Apr 15th 2021
Last update: Jun 25th 2021
Share