Slack Notification Configuration

Owned by Xing Guo
Last updated: Jun 20, 2023 by 李毅(Bruce)
4 min read

Before configuring Slack notifications, you need to connect JIRA to a Slack workspace through a custom Slack application, and you must be a Slack workspace administrator.

 

How do I get a custom Slack application to connect JIRA to a Slack workspace?

Step 1: Create a custom Slack application

Navigate to https://api.slack.com/apps. Be sure to log in as the Slack administrator for the workspace you are connecting to. Click "Create an App" (if you already have another App, the "Create New App" button will appear) :

Select "From Scratch" and enter details:

  • Application name: This will later show up as the sender name of the Slack reminder. We recommend “WorkflowWise”.

  • Develop a Slack workspace: Select the one you want to use.

After entering details, click "Create App" :

 

Step 2: Configure the Slack application

Scroll down to the ”Show Information“ section and upload an icon for your application. We recommend using the official WorkflowWise - Parallel Approval and Workflow Extension icon:

 

Scroll up to the "Add features and functionality" section, and then click on the Bots tiles to add "Bots " functionality to the app:

 

Click "Review Scopes to Add" to add the desired range:

 

Click“Bot Token Scopes > Add OAuth Scopes”：

 

Add the following ranges:

  • chat:write

  • users:read

  • users:read.email

 

 

Step 3: Install the Slack app

Click “Install to Workspace” at the top of the page:

 

click“Allow”：

 

 

 

Step 4: Enter the token in Jira

Copy the displayed OAuth token by clicking “Copy”:

 

Slack notification will be sent under the following two situation: 

One is Auto Send: When the Auto Send switch is on and the workflow goes to a status that requires approval, the system will automatically send slack notification to all approvers.

Another one is Manually Send: When the Manually Send switch is on, there will be a prompt icon (as shown in the picture below) in the Issue approval panel. When the mouse hover over the prompt icon, the Slack icon will be displayed. Click the "Slack" icon, you can send Slack notifications for specified unapproved approvers.     

What can we offer ?

  • Slack templates can be customized

          We provide a default Slack template, and you can modify the Slack template as your need.

  • A number of dynamic variables are provided for administrators to configure the template

          On the left side of the page, we provide a number of dynamic variables that you can apply to your Slack template to dynamically send Slack content for each approval.

  • Slack templates support resets

          Click the Reset button below the template to reset the template to its original appearance

  • Support for sending test messages

          Click the Test button below the template to send a test message to the currently logged in user.

Note: If you need to use customfield variables in a Slack template, the variables can be in ${customfield name} and ${customfield_*****}

 

Example of sending Slack