Search code examples
pythonherokuslackslack-api

What is a 'redirect URL' to distribute Slack bot?

I created a Python Slack bot hosted on Heroku (which works well on my personal workspace) but now wish to distribute it to other workspaces.

On the Slack 'manage distributions' page it requests at least one redirect URL. I do not understand what this is. For example: if the Heroku domain of my bot is https://my-awesome-bot.herokuapp.com/ what would it's redirect URL be?

Solution

  • The redirect URL is part of your website to enable installation of your Slack app to other workspaces (e.g. via "Add To Slack" button) and therefore required to enable distribution.

    The installation of Slack apps is done via the OAuth 2.0 protocol. How it works is that after the user of a workspace authorized your app to be installed by providing his Slack credentials, Slack will redirect the user back to your web site (using the provided redirect URL) so your app can get the new token for that particular workspace.

    You can add your redirect URLs on the OAuth 2.0 & Permission section of your Slack app management page. The exact URL depends on how your website is structured.

    Please see the documentation here on how the OAuth 2.0 process works with Slack.