Skip to content

Latest commit

 

History

History
69 lines (52 loc) · 2.62 KB

CONFIGURING-SLACK.md

File metadata and controls

69 lines (52 loc) · 2.62 KB

Configuring Slack

Create Slack App

  • Access https://api.slack.com/apps;
  • Click on the button: Create New App;
  • A model will be shown to you and you need to define your App Name and select your Slack Workspace;
  • Click on the button: Create App;

Signing Secret

  • In Settings/App Credentials, copy your Signing Secret;
  • Paste it into the HELLPER_SLACK_SIGNING_SECRET variable;

OAuth & Permissions - Bot Token Scopes

  • In Features click on the OAuth & Permissions;
  • In Scopes/Bot Token Scopes click on the Add an OAuth Scope;
  • Then select the follows scopes:
 - app_mentions:read
 - channels:join
 - channels:manage
 - channels:read
 - chat:write.public
 - chat:write
 - commands
 - pins:read
 - pins:write
 - usergroups:read
 - users:read
 - users:read.email

Slash Commands

  • Now, go in Features, click on the Slash Commands and click on the Create New Command to add the following commands:
Command Request URL Short Description
/hellper_incident https://yourhost.publicaddress.com/open Starts Incident
/hellper_status https://yourhost.publicaddress.com/status Show all pinned messages
/hellper_close https://yourhost.publicaddress.com/close Closes Incident
/hellper_resolve https://yourhost.publicaddress.com/resolve Resolves Incident
/hellper_cancel https://yourhost.publicaddress.com/cancel Cancels Incident
/hellper_pause_notify https://yourhost.publicaddress.com/pause-notify Pauses incident notification
/hellper_update_dates https://yourhost.publicaddress.com/dates Updates the dates for an incident

Interactivity & Shortcuts

  • Now, in Features/Interactivity & Shortcuts turn on the option Interactivity and configure your address URL http://yourhost.publicaddress.com/interactive;

Event Subscriptions

Before that you need to start the Hellper application http server with the variable: HELLPER_SLACK_SIGNING_SECRET.

  • Now, in Features, click on Event Subscriptions;
  • And in Enable Events turn on it;
  • In Request URL, set your application's public URL to the field. It will look something like this: https://yourhost.publicaddress.com/events;
  • In the same page open the Subscribe to bot events, click on the Add Bot User Event and add the app_mention option;
  • Click on Save Changes;

OAuth Access Token

  • In Features click on OAuth & Permissions;
  • Click on Install App to Workspace and then click to Allow;
  • Copy the Bot User OAuth Access Token;
  • Paste the code into the HELLPER_OAUTH_TOKEN variable.