Creating a Slack application

Edit online

In Slack, users must create an application to connect to Slack from Maximo IT.

Before you begin

Make sure you have a registered Slack account.

About this task

This section describes the tasks performed by a System Administrator to create an application in Slack for the users in the team.

Procedure

  1. Go to https://api.slack.com/apps and create a Slack application as per the instructions.
    Note: Below instructions are given just for reference, you must follow updated instructions given in https://api.slack.com/apps.
  2. Click on Create New App.
  3. In the Create a Slack App dialog, enter a name for your application, for example: Maximo IT, and select the workspace that you signed in to.
  4. Click on Create App to create Slack application.
  5. On the Slack API page, click the Basic information tab and scroll down to the App Credentials section.
  6. Make a note of the Client ID, Client Secret, and the Signing Secret values. You will need them when configuring Slack in Maximo IT.
    Tip: Click the Show button in each field to see the values.
  7. Scroll to section Install your app to your workspace and click on OAuth & Permissions.
  8. In the Redirect URLs section, add the following redirect URL:
    https://SlackProxy Service URL/SlackProxy/oauth

    where SlackProxy Service URL is the URL of the Slack Proxy Service which is installed with Manage.

  9. Steps to get the Slack Proxy Service URL:
    1. Log in to the Open Shift Console where MAS-Manage is installed.
    2. Go to Networking > Routes.
    3. From Project Dropdown, choose Manage Project and search for Slack Proxy Service.
    4. Copy the URL from the Location field. You now have the Slack Proxy Service URL.
    Note: The Slack Proxy Service URL must be Public and Secure.
  10. Scroll to the Scopes section and click on Add an OAuth Scope for Bot Token Scopes and add the following permission scopes to install app to workspace.
    • channels:read
    • groups:read
    • mpim:read
    • im:read
    • users:read

      Similarly, add at least one permission scope for User Token Scopes and more as needed.

    Tip:
    • In Slack, Scopes define the API method that your Slack App can call.
    • You can add any number of OAuth Scope for example: chat:write for Bot Token Scopes and admin for User Token Scopes.
  11. Click on Install App to Workspace.
  12. Click Allow to give permission to access your workspace.
  13. You will get a OAuth Access Token and it will be used at the time of configuring Slack in Maximo IT.