Jira Atlassian Integration

With these Public Integrations, you can interact with Jira projects and manage tickets:

• com.globant.geai.jira_create_ticket: Creates a new ticket (issue) in a specified Jira project with the necessary summary, description, and priority level.
• com.globant.geai.jira_get_ticket: Retrieves all relevant details and status information for a specific ticket (issue) from a designated Jira project.
• com.globant.geai.jira_update_ticket: Updates the status, priority, or descriptive content of an existing ticket (issue) within a Jira project.

Before using these Tools, obtain the required information from Atlassian and register the API token as a Credential in your Project.

Configuration steps

1. Go to Atlassian API Tokens and log in. Make sure you are using the Atlassian account that has Jira access and that your Jira Cloud site is active (for example, https://<organization>.atlassian.net/jira/).
2. On the Atlassian API Tokens page, select Create API token with scopes, and then configure the following:
   • In the Name field, enter a descriptive name (for example, Jira Tool) and set Expires on. Click on Next.
   • In Select the app, select Jira and click on Next.
   • In Select Jira scopes, search for and select write:jira-work (Scope type: Classic). Click on Next.
   • Click on Create token and copy the generated token. The token is displayed only once. Save it securely.
3. In the Integrations Dashboard, open the Credentials tab and click on + New Credential.
   • In the Name field, enter a descriptive name (for example, jira_token).
   • In Integration, select Jira Atlassian.
   • In Authentication Type, select API Key.
   • In Authentication Level, select Project.
   • In API Key Value, paste the API token value previously obtained.
   • Confirm to save the Credential.
4. Go to: https://<organization>.atlassian.net/jira/projects/
   • Replace <organization> with the name of your Jira workspace or company account.
5. Locate your project in the list.
6. In the Key column, find the project key you need and copy it (for example, OPS, GENX).
   • A project key in Jira is a short, unique identifier for a project. Every ticket (or issue) in that project starts with this key. For example, if your project key is OPS, a ticket might look like OPS-123.
   • The project name is not the same as the project key, so make sure you use the correct value.
7. Go to: https://<organization>.atlassian.net/_edge/tenant_info
   • Replace <organization> with the name of your Jira workspace or company account.
8. A JSON object will be displayed. Copy the value of cloudId (it looks like a UUID, for example, a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8).
9. In the Integrations Dashboard, open Jira Atlassian and go to the Integration Parameters tab. Configure the following required parameters:
   • cloud-id: The unique cloud identifier of your Jira site obtained in step 8 (for example, a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8).
   • project-key: The Jira project key you obtained in step 6 (for example, OPS).
   • url: Your Jira workspace URL (for example, https://globant-team.atlassian.net/).
   • username: The email address used to access your Jira account (for example, user@globant.com).

The API token is resolved automatically from the configured Credential associated with the Jira Atlassian Integration.

After completing these steps, you can add the Tool to your Agent from the AI & Tools Tab.