Skip to main content

Jira Software

Learn how to get started with Actioner's Jira app.

Install Jira Software from app directory and start using it by connecting your Jira and Slack.

Get started as a user

If you are invited to this app as a user, proceed to Get started as an app user section to learn how to connect your Jira account.

Features​

Track, create, or update issues quickly at every step of your daily routine. Connect Jira and Slack with Actioner and let them work in harmony.

Use cases​

Get started as an app admin​

Step 1. Install Jira Software​

Visit Jira Software in app directory and click Install button at top right corner.

Install Jira Software

Step 2. Connect to Jira and Slack​

After installing the app, you'll be prompted to connect your Slack workspace and Jira account.

Connections for Jira Software

Complete Jira connection

  1. Click Connect near Jira connection and proceed to authentication in Jira via OAuth2.
  2. You will be asked to sign in to your Jira instance if you haven't already.
  3. Click Connect app. You’ll be redirected to Actioner upon successful authorization.

Complete Slack connection

  1. Click Connect near Slack connection.
  2. Continue with selecting your Slack workspace.
Info

If your workspace is not available, add it by navigating to Slack connections page from left menu and click + Add new Slack workspace.

Step 3. Complete setup​

Setup Jira Software

Run Set up your Jira project and create webhooks in Jira by selecting your project. This workflow

  • Creates webhook and issue-related triggers in your Jira account
  • Creates a new channel in your Slack account (with #actioner- prefix) and starts to send notifications for issues in the selected project.
  • Creates another channel in your Slack (#actioner-report-issue). When a ticket 🎫 emoji is added to a message in this channel, users are prompted to create a new issue in Jira. You can also check an issue's status by mentioning its key, such as "What is the status of DEMO-1?".

Get started as an app user​

If you are invited to this app as a user, you need to complete Jira connection. This connection is required for you to take actions on Jira notifications and to run workflows from Actioner shortcut in Slack.

  1. Navigate to Jira connection, click Connect and proceed to authentication in Jira via OAuth2.
  2. You will be asked to sign in to your Jira instance if you haven't already.
  3. Click Connect app. You’ll be redirected to Actioner upon successful authorization.

How to customize this app​

Enable/disable notifications​

During the setup of your solution for Jira Software, you’ll be prompted to complete some steps. These steps are necessary for your app to get up and running in Slack. After the setup, you can also update your notification settings.

For this, go to App config tab of your app and navigate to appConfiguration.

  • siteUrl: Specifies the URL of the Jira site where your Slack app is connected.
  • createDedicatedChannelForCriticalIssues: Determines whether a dedicated channel should be created for issues with Highest priority or critical label. Set this property to true if you want to automatically create a new channel for critical issues.
  • channelNotifications: Defines which types of notifications are sent to selected project channels. You can enable or disable notifications for the following events:
    • issueCreated: is triggered when an issue is created.
    • issueUpdated: is triggered when an issue is updated.
    • issueDeleted: is triggered when an issue is deleted.
    • commentAdded: is triggered when a new comment is added to an issue.
    • worklogAdded: is triggered when a worklog is created.
  • dmNotifications: Controls the direct message (DM) notifications sent to your users in Slack. Similar to channelNotifications, you can configure notifications for the following events:
    • issueCreated: is triggered when an issue is created.
    • issueUpdated: is triggered when an issue is updated.
    • commentAdded: is triggered when a new comment is added to an issue.

Set up your project and issue reporting channels​

Project channels​

Project channels are the dedicated Slack channels for your selected Jira project. New issues and their updates can be tracked through notifications sent by Actioner. Moreover, your team can manage the issues through these notifications.

You can run Configure channels for Jira notifications in Slack or in Actioner to select your channel that you want to get notified for issues in the selected Jira project.

Issue reporting channels​

Issue reporting channels are the dedicated Slack channels for your Slack users to report issues by adding ticket 🎫 emoji to their Slack messages. These channel streamline the issue creation process and lets your team create issues without leaving Slack.

You can run Configure channels to report a Jira issue in Slack or in Actioner to select your channel for reporting new Jira issues.

Tip

Do not forget to invite Actioner to your project and issue reporting channels!

Alternative way to set your project and issue reporting channels is through App config.

  1. Go to App config tab of your app and navigate to channelConfiguration.

  2. Add your new channels in the below format:

{
  "projectChannels": [
    {
      "projectId": "10004",
      "channelId": "C01234ABCDE",
      "emojiToAssignIssue": "eyes",
      "emojiToResolveIssue": "white_check_mark",
      "emojiToAddComment": "pushpin"
    }
  ],
  "reportIssueChannels": [
    {
      "channelId": "C09876ABCDE",
      "emojiToCreateIssue": "ticket",
      "emojiToAssignIssue": "eyes",
      "emojiToResolveIssue": "white_check_mark",
      "emojiToAddComment": "pushpin"
    }
  ]
}

Properties for projectChannels

  • projectId: The ID of your Jira project.
  • channelId: The ID of your Slack channel where you'll get notifications for issues in the selected Slack project.
  • channelName: The name of the Slack channel.
  • emojiToAssignIssue: The emoji used to assign the issue to the user who adds this emoji. By default, it is set as "eyes".
  • emojiToResolveIssue: The emoji used to mark an issue as resolved. By default, it is set as "white_check_mark".
  • emojiToAddComment: The emoji used to add your Slack message as a new comment to your Jira issue. By default, it is set as "pushpin".

Properties for reportIssueChannels

  • channelId: The ID of your Slack channel dedicated for reporting issues.
  • emojiToCreateIssue: The emoji used to report a new issue. By default, it is set as "ticket".
  • emojiToAssignIssue: The emoji used to assign the issue to the user who adds this emoji. By default, it is set as "eyes".
  • emojiToResolveIssue: The emoji used to mark an issue as resolved. By default, it is set as "white_check_mark".
  • emojiToAddComment: The emoji used to add your Slack message as a new comment to your Jira issue. By default, it is set as "pushpin".

Troubleshooting​

"Only a single URL per app is allowed to be registered via REST API" error during the setup​

While running Configure channels for Jira notifications during the setup, you might get "Only a single URL per app is allowed to be registered via REST API" error.

This error occurs because Jira API does not allow registering webhooks to different endpoints in the scope of a single Jira instance. You'd come across this one if you installed Jira Software app from Actioner app directory before and completed its setup.

To solve it, you can run Delete webhooks workflow in your Jira app. This will remove the previously created webhook for Actioner to capture events in your Jira instance.

For this, first close the setup and go to Workflows tab and find the Delete webhooks workflow. Run it from play button at top right corner. After deleting the previous webhooks, you can proceed to setup where you left off.

Please note that if you've another Jira Software app working on your Slack (that is installed from Actioner's app directory), Delete webhooks workflow will disconnect it. If you want to get the Jira Software app working in 2 different Slack workspaces, you can ask another Jira admin in your instance to complete the setup for the newly installed app.