> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Jira

## Overzicht

Koppel je ElevenLabs AI-agents aan Jira Cloud om issues te beheren, projecten bij te houden en supportworkflows te automatiseren. Met deze integratie kunnen je agents issues maken en bijwerken, issues door workflows verplaatsen, gerelateerde tickets voor escalatie koppelen en projecten doorzoeken.

## Mogelijkheden

| Mogelijkheid              | Ondersteuning                                    |
| ------------------------- | ------------------------------------------------ |
| Zero retention mode (ZRM) | Niet ondersteund                                 |
| Bijlagen in tools         | Niet ondersteund — tools werken alleen met tekst |

## Instellen

Deze integratie gebruikt een **Jira API token** met Basic authentication. Je hebt het e-mailadres van je Atlassian-account, een API-token en je Jira Cloud-subdomein nodig.

#### Genereer een API-token

Ga naar [Atlassian API token management](https://id.atlassian.com/manage-profile/security/api-tokens) en klik op **Create API token**. Kopieer het token; je kunt het niet opnieuw bekijken.

#### Zoek je Jira-subdomein

Je subdomein is het eerste deel van je Jira Cloud-URL. Als je Jira bijvoorbeeld bereikbaar is via `mycompany.atlassian.net`, is je subdomein `mycompany`.

#### Koppel in ElevenLabs

Voer in de configuratie van de ElevenLabs-integratie het volgende in:

* **Email** - het e-mailadres van je Atlassian-account
* **API Token** - het token dat je in stap 1 hebt gegenereerd
* **Jira Subdomain** - je subdomein uit stap 2

> **Note**
>
> API-tokens verlopen standaard na één jaar. Als je agent geen toegang meer heeft tot Jira,
> genereer dan een nieuw token en werk de koppeling bij.

## Bellers identificeren

De tool `jira_search_issues` vereist een parameter `labels` om zoekopdrachten te beperken tot de tickets van een specifieke gebruiker. Dit gaat ervan uit dat je Jira-workflow op elk issue een label toepast dat de beller identificeert — bijvoorbeeld door een e-mailadres als `jane.smith@example.com` om te zetten in een label als `jane-smith-at-example-com`.

Om dit te automatiseren, configureer je het veld `labels` als een [dynamische variabele](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) die de identificatie van de beller vanuit je applicatie ontvangt. Zo hoeft de agent de beller niet bij elk gesprek om diens e-mailadres te vragen.

> **Note**
>
> Jira-labels mogen geen spaties bevatten. Een gebruikelijke conventie is om `@` te vervangen door `-at-` en `.` door
> `-` (bijvoorbeeld `jane-smith-at-example-com`). De tool `jira_search_issues` zoekt een exacte overeenkomst met het label,
> dus de opgegeven waarde moet overeenkomen met het label op het issue.

## Zo werkt het

#### Supportticket maken

#### Beller identificeren

De agent identificeert de beller aan de hand van een e-mailadres of een andere identificatie die in het
veld labels is geconfigureerd.

#### Details verzamelen

De agent verzamelt informatie over het issue bij de beller - wat er is gebeurd, de ernst
en relevante context.

#### Het issue maken

De agent maakt een Jira-issue in het juiste project met het juiste issuetype,
de juiste prioriteit en beschrijving.

#### Bevestigen met de beller

De agent leest het nummer van het gemaakte ticket voor, zodat de beller een referentie heeft voor vervolgvragen.

#### Afhandeling via service desk

#### Het ticket opzoeken

De agent haalt een Jira-issue op aan de hand van de sleutel (bijvoorbeeld PROJ-123) en leest de huidige
status, prioriteit en samenvatting voor.

#### Notities over de oplossing toevoegen

De agent voegt een opmerking toe aan het issue met details uit het gesprek, zoals ondernomen stappen
of verzamelde informatie.

#### Het ticket sluiten

De agent verplaatst het issue naar een opgeloste of gesloten status met behulp van de beschikbare workflow-
overgangen.

## Voorbeeld van systeemprompt

#### Voorbeeld van systeemprompt bekijken

```text
# Personality

You are a helpful IT support agent responsible for managing support tickets in Jira. Be friendly, professional, and efficient.

# Environment

You operate in a support setting via voice or chat, where you help users report issues, check ticket status, and manage existing requests.

# Tone

Begin by asking how you can help. If the caller has an existing issue, ask whether they have the ticket number. If they are reporting a new issue, collect details about the problem.

Ask one question at a time and wait for the response before proceeding.

# Goal

For new issues:
- Collect a clear description of the problem
- Determine severity and urgency
- Create the ticket in the appropriate project with the right issue type and priority
- Read back the ticket number

For existing issues:
- If the caller provides a ticket number, look it up by key
- If the caller wants to check on their issues, search using the labels field
- Provide status updates
- Add comments or update priority when requested
- Always confirm before making changes

# Guardrails

- Do not discuss topics outside of IT support.
- Never expose raw Jira API responses, internal IDs, or technical field names to the caller.
- Always confirm with the caller before creating, updating, or transitioning issues.
```

## Beschikbare tools

| Tool                    | Beschrijving                                                                                        |
| ----------------------- | --------------------------------------------------------------------------------------------------- |
| `jira_create_issue`     | Maak een issue met project, samenvatting, issuetype en optionele velden zoals prioriteit.           |
| `jira_get_issue`        | Haal details op voor een specifiek issue aan de hand van de sleutel.                                |
| `jira_search_issues`    | Zoek issues op label, project, status, prioriteit, type, toegewezene, tekst of datumbereik.         |
| `jira_update_issue`     | Werk velden van een bestaand issue bij - prioriteit, toegewezene, labels of beschrijving.           |
| `jira_add_comment`      | Voeg een opmerking in platte tekst toe aan een issue.                                               |
| `jira_get_transitions`  | Geef beschikbare workflowovergangen voor een issue weer.                                            |
| `jira_transition_issue` | Verplaats een issue naar een nieuwe workflowstatus met een overgangs-ID uit `jira_get_transitions`. |
| `jira_link_issues`      | Koppel twee issues aan elkaar (bijvoorbeeld "Blocks", "Duplicate", "Relates").                      |
| `jira_list_projects`    | Geef beschikbare projecten en hun sleutels weer.                                                    |
| `jira_get_issue_types`  | Geef beschikbare issuetypen weer (bijvoorbeeld Bug, Task, Story).                                   |
| `jira_get_priorities`   | Geef beschikbare prioriteitsniveaus weer.                                                           |

> **Note**
>
> Issuebeschrijvingen en opmerkingen ondersteunen alleen platte tekst. De integratie zet deze automatisch om naar Jira's
> Atlassian Document Format (ADF). Markdown en HTML worden niet ondersteund.

## Handige links

* [Documentatie voor Jira Cloud REST API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
* [API-tokens beheren](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)