📋 Jira Cloud

What is the Allma // Jira Cloud integration?

The Jira Cloud integration empowers Allma users to create Jira issues in response to events, directly from Slack. For example, when you are hit by an incident and create an Allma incident workflow, the Jira Cloud integration will present fields which enable you to create a Jira issue.

How do I enable the Allma // Jira Cloud integration?

There are two parts to using this integration: An Atlassian app and the Allma Slack app. The Atlassian app installs onto your Atlassian server and enables Allma to create Jira issue on your behalf. The Allma Slack app allows you to create Jira issues directly from Slack.

1. Install the Allma Atlassian app

Installing the Allma app onto your Atlassian server is as simple as visiting the app’s page, and clicking “Get app”.

You will be prompted to select your Atlassian site and click “Install”. This will install the Allma app onto your selected Atlassian site.

2. Get your webhook URL

Allma uses webhooks to communicate with Jira. So, you’ll need to provide a webhook URL to Allma so that it can create Jira tickets for you. You can get this URL by visiting your apps page by clicking the “Apps” menu item in the top menu bar, then clicking “Manage your apps” in the dropdown. After arriving on the “Manage apps” page, click on “Allma webhook configuration” at the bottom of the left sidebar. This will take you to your Atlassian site’s configuration page for the Allma app.

After you allow access to the app, the page will update and show your webhook URL.

Please note that your webhook URL is confidential and should be treated like a password or secret key. It provides access to the data defined within the scopes of the Allma app. The webhook URL shown above is a fake URL, because sharing a real webhook URL is a bad idea. You will provide your webhook URL only to your Allma integration configuration in the next step.

3. Set your webhook URL

Copy the webhook URL from the Allma webhook configuration page in the previous step. You will need to paste this into your Allma integration configuration.

Navigate to our Integrations Page and find the Jira Could card.

Enable the integration by clicking on the toggle in the top-right of the card. You should automatically be redirected to your Jira Cloud Settings page.

Paste your webhook URL into the empty text input. Your Jira Cloud integration is now fully enabled and working.

You can confirm the Integration is enabled by navigating back to the Integrations Page, where you should see that the Jira Cloud card is now displaying a green “Enabled” status.

How does the Allma // Jira Cloud integration work?

The general flow of using the Jira Cloud integration is to create a Jira ticket in response to an event. In the current state of the integration, there are two primary events:

1. Declaring an incident
2. Using reacjis in project channels
3. Manually triggering “Add to Jira” in response to another event
4. Clicking the "Add to Jira" Allma Action

Declaring an incident

Start by declaring an incident with /allma new.

Select a non-private workflow — such as a 🛠️ Technical incident — and you should see a checkbox labeled "Create a Jira ticket for this incident". Check that box to display the inputs for configuring your ticket.

Select a project and ticket type. Note that the available ticket types will update based on your selected project.

Submit the form to create the incident. Go to the incident channel and, after a few seconds, Allma should post a link to the Jira ticket:

Using reacjis in a project channel

When you see a Slack message that needs to be a Jira ticket, you can react to it with the 🐛 emoji and Allma will create a ticket on your team's default Jira project board.

Configure a default Jira project board

1. Make sure Allma is in the channel, and when you added allma you indicated the channel was a channel where bugs and feature requests are discussed. More info here
2. Go to your Jira Cloud settings page, and add a new channel-based configuration. Select a channel, a default Jira project board, and a default ticket type
3. That's it! Now each time you react with the 🐛 emoji to a message, a ticket will be created for that Slack message on the board you configured.

Using Add to Jira

See the Add to Jira docs page for more info.

Using Allma Actions

See the Allma Actions docs page for more info

What can I customize with the Allma // Jira Cloud integration?

At the time you choose to create a Jira issue, you must also choose:

• The Project in which the issue is created
• The Type of issue which is created

Can I alter how I have Jira Cloud configured after the fact?

Yes! Navigate to your Jira Cloud Settings Page and update your webhook URL as necessary.

Can I use custom ticket types with Jira Cloud?

Yes!

Depending on what type of Project you use (scrum vs kanban) or possibly the age of your Jira server, there can be multiple ways to configure a custom ticket type. Please see the relevant Jira documentation for your project type and server.

A good litmus test is "When creating a new issue from the Jira UI, do I see the option to use this ticket type?"

• If yes, Allma should be able to create an issue of that type for you
• If no, you likely need to look into your Jira configuration and ensure that the type is properly available to that Project and potentially any relevant Screens and Schemas (again, depending on Project Type and Jira version)

Can I create Epics with Jira Cloud?

Yes! Just select the "Epic" issue type when creating an issue.

Remember that Jira organizes Epics differently from other issue types, and they may not appear directly alongside your other issues. However, the Epic will contain all the same information as other issue types.

What if I have required fields for my tickets?

Allma scans the Jira board and ticket type for any required fields and gives you an input box to fill them out.