Jira

The Jira family of products includes Jira Software for release tracking, Jira Service Desk for customer support, and Jira Core for project management. This document describes how to connect IBM watsonx Orchestrate to Jira and use its skills on watsonx Orchestrate.

Before you begin

To connect watsonx Orchestrate to Jira, make sure that you have a Jira account. If you don't have a Jira account, you can create one at try Jira for free.

Connecting to Jira

Important:
- A credential type must be set for apps that are a part of team skill sets and AI assistants. Skill-based actions in AI assistants support only shared credentials.
- If a credential type of an app is not specified, an error message is displayed when users attempt to run the skills of the app. To resolve the error, an admin must set the credential type for the app. For more information, see Managing connections.

An app can be connected either through the skill catalog or through the watsonx Orchestrate chat. Use the method that suits you to connect to an app.

Connect to the app through the skill catalog when you add that skill to your skill set:

  1. On the watsonx Orchestrate chat page, click Add skills from the catalog.
  2. Search and click the app tile.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Otherwise, connect to that app through the watsonx Orchestrate chat when you use the skill:

  1. Open the watsonx Orchestrate chat.
  2. On the chat, start the skill.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Configuring the connection

To connect watsonx Orchestrate to Jira, complete the following steps:

  1. Click Connect app.
  2. In the Jira host and port field, specify the URL of the domain-specific Jira service that you use to log in to the portal.
    • For Jira Cloud, if your domain is xxx, the service URL is https://xxx.atlassian.net.

    • For Jira Server, the service URL is in the format https://myjirahost:port.

  3. Specify the User name.
    • For Jira Cloud, enter the email address that you use to log in to your Atlassian account.

    • For Jira Server, enter the username that you use to log in to Jira.

  4. Enter the Password or API token.
    • For Jira Cloud, enter the API token that you generate from your Atlassian account. For more information on creating an API token, see API tokens on the Atlassian website.

    • For Jira Server, enter the password that you use to log in to Jira.

  5. Click Connect app.
Note: The icon A green check icon appears to show that the app is connected. indicates that the connection was successfully established.

Technical parameters

The following table contains the technical parameters required by some skills of this app and instructions to retrieve them.

Parameters Details
accountName The ID that identifies your account, which is your email address.

What to do next

After you connect to the app, you can use the Jira skills. For more information see, Using the chat.

To learn about the available skills, see List of prebuilt apps, skills and skill flows.


Parent topic:

Connecting to apps