Allma

Sign in

📋 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.

The Jira Cloud integration's user interface

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”.

The Allma Atlassian app page with the

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

The prompt to install the Allma Atlassian app.

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.

Allma webhook configuration page with request to allow access

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

Allma webhook configuraiton page showing a 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.

Disabled Jira Cloud integration 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.

The 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.

Enabled Jira Cloud integration card

How does the Allma // Jira Cloud integration work?

The overall use of the Jira Cloud integration is to create a Jira ticket in response to an event. In the current state of the integration, this event will always be declaring an incident. So, start by declaring an incident with /allma new.

Select a non-private workflow — such as a 🛠️ Technical incident — and you should see this “Jira project” dropdown in the modal:

The input for selecting a Jira project for the ticket.

Select a project, then wait a moment. Another dropdown will appear that will allow you to select a ticket type:

Jira Cloud UI with

The updated UI with the ticket type input added.

The displayed ticket types are specific to the selected project. If you select a new project, the ticket type dropdown will update with the ticket types from the selected project.

Select a ticket type, then 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:

Jira ticket Slack message with link to ticket

The message from Allma with a link to the Jira ticket.

That’s it! You’ve used the full functionality of the Jira Cloud integration in its current state.

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.

our newsletter is cool

allma, inc © 2022