# Jira

One of the outcomes of a bot might be a human action that needs to be executed, like changing an appointment, processing a product return or update a database. In most cases these actions need to be performed by human employees that work out of tickets created in a ticketing system, like Jira.

This skill exposes the following new nodes to your Flow designer:

1. Jira: Create ticket
2. Jira: Get ticket

## Installing the Jira integrations skill

The Jira integrations skill isn't installed automatically with your Smart App. Therefore you need to install it manually in the DialoX studio.

Go to Packages -> Browse skills and search for the Jira integrations skill.

{% hint style="info" %}
If you don't see this skill here, it needs to be added to your account. Please consult your partner or Enreach DialoX support team.
{% endhint %}

## Prerequisites

To connect the bot to your Jira or Service Desk instance you will need to prepare the following information.

* URL to your Jira or Service Desk instance
* Personal API Token
* The email address of the user to whom the Personal API token belongs

The Personal Access Token is your own personal access token that needs to be created in your Jira profile. To create this token:

* Log in to your Jira environment
* Click on your profile button in the upper right corner and go to Profile
* Go to Manage account, and then to 'Security', and click on 'Create and manage API tokens'
* Provide a name of your token (any name is sufficient)
* Set the expiration date to next year and make a note in your calendar to create a new token in time
* Hit Create and store the API Token somewhere safe

<figure><img src="/files/9XLSoCvh6Qs6LsiFefhA" alt=""><figcaption></figcaption></figure>

## Configuring the Jira integrations skill

Before you can use the Jira integration in your flow you need to configure the credentials needed for the bot the make the connection. This can be done in the settings.

<figure><img src="/files/EuTmQANLzxFVRouwAMQr" alt=""><figcaption></figcaption></figure>

Fill in the fields as described. Read the previous chapter to read how to get an API Token.

The user email **must be** the same as the user which created the API token.

{% hint style="info" %}
Notice that the API Token needs to be saved separately from the form. So the Save button next to the access token needs to be clicked separately from the save button at the bottom of the page. The latter only stores the URL and the Project key in the database.
{% endhint %}

## Implement Jira integration to your Flow

The following flows shows how the skill can be used to create a ticket and then retrieve the ticket and display a certain piece of information from the ticket.

This flow introduces the following two nodes which are described in the Flows -> Nodes section:

* Jira: Create ticket
* Jira: Get ticket

<figure><img src="/files/pngAEKiWVvaahdKrJO2H" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuals.dialox.ai/store/skills/integrations/jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.