The Jira Integration are used to interact with the Jira Data Center applications from Sleekplan, for example, when changing status.
To get started, with Jira Cloud, read the documentation: Jira Cloud Integration!
Install the Jira Software Data Center integration
Navigate to Settings > Integrations
Search for Jira (Data Center) and press "Install"
On the setup screen, you need to provide the following information:
A Personal Access Token (PAT)
The Jira instance base URL
Setup a Jira WebHook with the provided URL
Personal Access Token:
In Jira, select your profile picture at the top right of the screen, then choose Profile. Once you access your profile, select Personal Access Tokens in the left-hand menu.
Select Create token.
Token Name: "Sleekplan Integration"
Disable "Automatic expiry"
Press "Create" and copy your PAT
ℹ️ Create a dedicated account and generate a Personal Access Token to facilitate the Jira integration with Sleekplan.
If you wish to install Jira integration on a separate account, you have the option to create a generic account specifically for this purpose. Let's call this account "Sleekplan" as an example. By creating a generic account, you can keep the integration separate from individual user accounts and maintain better control over access and permissions.
Base URL
Open your web browser and navigate to the Jira Software Data Center login page.
Log in to your Jira Software account using your credentials.
After logging in, you should be on the Jira Software dashboard or the project view.
Look at the URL in your browser's address bar. The base URL is the portion of the URL before any additional paths or parameters. It typically starts with "http://" or "https://" and ends before the project-specific or issue-specific information.
For example, if your URL looks like this: "https://yourcompany.atlassian.net/browse/PROJ-123," then the base URL would be "https://yourcompany.atlassian.net"
Setup the WebHook
Log in as a user with the Jira Administrators global permission.
In the upper-right corner of the screen, select Administration > System.
Under Advanced (the left-side panel), select WebHooks to open the Webhooks page, which shows a list of all existing webhooks.
Press "Create a WebHook"
Provide the following details:
Name: Sleekplan WebHook
Status: Enabled
URL: Paste the URL from the initial setup screen on Sleekplan
Events: For the JQL box, add "status != none" and select Issue → updated from the list
Press "Save"
Now go back to the setup screen at Sleekplan and fill in your PAT and Base URL and press "Connect"
To learn how to use the Jira integration, read more on: Jira Cloud Integration