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 configuration page with the webhook URL pasted into the appropriate input

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

The

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:

The message from Allma with 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.
Screen Shot 2022-10-12 at 11.28.26 AM.png

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.

jira-required-fields-1.gif

our newsletter is cool

allma, inc Ā© 2023