Configuring Slack

Creating the App

Follow the instructions from Slack for setting up an app in the manner described here: https://api.slack.com/reference/manifests. Follow the steps from the Slack UI, providing this manifest when prompted:

{
 "display_information": {
  "name": "Horde",
  "description": "Allow for interaction with the Horde build system.",
  "background_color": "#000000"
 },
 "features": {
  "bot_user": {
   "display_name": "Horde",
   "always_online": false
  }
 },
 "oauth_config": {
  "scopes": {
   "bot": ["chat:write", "chat:write.public", "reactions:read", "reactions:write", "users.profile:read", "users:read", "users:read.email", "channels:manage"]
  }
 },
 "settings": {
  "interactivity": {
   "is_enabled": true
  },
  "org_deploy_enabled": true,
  "socket_mode_enabled": true,
  "token_rotation_enabled": false
 }
}

Configure App

Once you’ve created the app click “Basic Information” from the left-hand navigation:

Scroll down to the “Display Information” section in the app configuration panel in Slack and upload an icon and description. Epic provides an icon here: Engine\Source\Programs\Horde\HordeServer\Slack\app.png.

Also in the “Basic Information” section, scroll down to the “App-Level Tokens” section:

Click “Generate Token and Scopes” and fill socket-token for the Token Name.

Click “Add Scope” and select connections:write from the dialog.

When done, the dialog should look like this:

Click “Generate”

Supply Tokens to Universal Foundry

Socket Token

Click on the token name in Slack’s “App-Level Token” UI from the previous step. Copy the token to your clipboard from the Slack UI that appears.

Navigate to the Settings tab of Universal Foundry and scroll down to the Slack section. Paste the token into the “Slack Socket Token (xapp-*)” section.

Slack Token

Navigate to the “Install App” section of the App in slack.

Copy the token in the “Bot User OAuth Token” section to the clipboard.

Navigate to the Settings tab of Universal Foundry and paste this token into the Slack Token (xoxb-*) section.

Configure Channel

In the Universal Foundry settings tab, enter a name for a channel to which you’d like to post updates about jobs. Leave the “#” off the name of the channel. For example, if you wanted to post to #horde-jobs, you’d fill in the dialog with:

Open Slack and create the channel.

Invite the bot you created by mentioning it in the channel you have created. Odds are good the username is “horde” so just send a message with @horde in it. You can look up the name of the bot in slack by going to the “App Home” section in the Slack control panel

Scroll down to the “Your App’s Presence in Slack” section:

Finalizing Setup

Your Universal Foundry account manager will be in touch within 24 hours of the tokens being entered to confirm that connection to Slack is complete.