diff --git a/documentation/frontends/slack.md b/documentation/frontends/slack.md index 36f3ae8ed0df9b45aadc9d36ae8d734fb398dbdc..62267eab32215fa80add4451a89c1bde283a3bf8 100644 --- a/documentation/frontends/slack.md +++ b/documentation/frontends/slack.md @@ -5,7 +5,7 @@ title: Spectrum 2 ## Slack frontend Description -Slack frontend allows users to use Slack as a frontend network for Spectrum 2. +Slack frontend allows users to use Slack as a frontend network for Spectrum 2. This page describes how to setup your own Spectrum 2 instance with Slack frontend. ### Configuration @@ -13,16 +13,11 @@ You have to choose this frontend in Spectrum 2 configuration file to use it: [service] frontend=slack + client_id=42132532467.11232153249 + client_secret=cfdw9erw9ew0gew9gds0sa9wqd9f8d6a +To obtain the `client_id` and `client_secret` values, you have to create new Slack application on [Slack website](https://slack.com/apps/build). You also have to setup Spectrum 2 Web Interface to allow Slack users to register the transport and configure it. While creating new Slack application, you also have to setup the `Redirect URI`. Spectrum 2 Web Interface expects the `Redirect URI` to be configured as `http://domain.tld/oauth2`. You can choose whatever domain you are running at, but you have to preserve the `/oauth2` location. ## Usage -To use Slack 2 frontend with Spectrum2, you have to add new bot to your Slack team and get the API token. After that, you can use `spectrum2_manager` to set the API token: - - $ spectrum2_manager localhost set_oauth2_code API_TOKEN use_bot_token - -Use the real JID of your Spectrum 2 instance instead of `localhost`. Use the API token provided by the Slack instead of `API_TOKEN`. - -Once you do that, Spectrum 2 will contact the Slack team's primary owner with instructions how to configure it. - - +Once you setup Spectrum 2 with proper `client_id` and `client_secret`, you can register as new user in the Spectrum 2 Web Interface.