> 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

## Vue d’ensemble

Connectez vos agents IA ElevenLabs à Jira Cloud pour gérer les problèmes, suivre les projets et automatiser les flux de support. Cette intégration permet à vos agents de créer et mettre à jour des problèmes, de les faire progresser dans les flux de travail, de lier les tickets associés pour les escalades et d’effectuer des recherches dans les projets.

## Fonctionnalités

| Fonctionnalité                 | Prise en charge                                               |
| ------------------------------ | ------------------------------------------------------------- |
| Mode zéro rétention (ZRM)      | Non pris en charge                                            |
| Pièces jointes dans les outils | Non prises en charge, les outils traitent uniquement du texte |

## Configuration

Cette intégration utilise un **jeton API Jira** avec une authentification Basic. Vous avez besoin de l’email de votre compte Atlassian, d’un jeton API et de votre sous-domaine Jira Cloud.

#### Générer un jeton API

Accédez à la [gestion des jetons API Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) et cliquez sur **Create API token**. Copiez le jeton, vous ne pourrez plus l’afficher.

#### Trouver votre sous-domaine Jira

Votre sous-domaine correspond à la première partie de votre URL Jira Cloud. Par exemple, si votre Jira se trouve à l’adresse `mycompany.atlassian.net`, votre sous-domaine est `mycompany`.

#### Se connecter dans ElevenLabs

Dans la configuration de l’intégration ElevenLabs, saisissez :

* **Email** : l’email de votre compte Atlassian
* **API Token** : le jeton généré à l’étape 1
* **Jira Subdomain** : votre sous-domaine de l’étape 2

> **Note**
>
> Les jetons API expirent par défaut après un an. Si votre agent ne peut plus accéder à Jira,
> générez un nouveau jeton et mettez à jour la connexion.

## Identifier les appelants

L’outil `jira_search_issues` exige un paramètre `labels` pour limiter les recherches aux tickets d’un utilisateur spécifique. Cela suppose que votre flux Jira applique à chaque problème une étiquette identifiant l’appelant, par exemple en convertissant un email comme `jane.smith@example.com` en une étiquette comme `jane-smith-at-example-com`.

Pour automatiser cela, configurez le champ `labels` comme une [variable dynamique](/docs/fr/eleven-agents/customization/personalization/dynamic-variables) qui reçoit l’identifiant de l’appelant depuis votre application. Ainsi, l’agent n’a pas besoin de demander l’email de l’appelant à chaque appel.

> **Note**
>
> Les étiquettes Jira ne peuvent pas contenir d’espaces. Une convention courante consiste à remplacer `@` par `-at-` et `.` par
> `-` (par exemple, `jane-smith-at-example-com`). L’outil `jira_search_issues` recherche une correspondance exacte avec l’étiquette,
> la valeur fournie doit donc correspondre à l’étiquette du problème.

## Fonctionnement

#### Création d’un ticket de support

#### Identification de l’appelant

L’agent identifie l’appelant à partir de son adresse email ou d’un autre identifiant configuré dans le
champ labels.

#### Collecte des informations

L’agent recueille les informations sur le problème auprès de l’appelant : ce qui s’est passé, la gravité
et tout contexte pertinent.

#### Création du problème

L’agent crée un problème Jira dans le projet approprié, avec le bon type de problème,
la priorité et la description adéquats.

#### Confirmation auprès de l’appelant

L’agent communique le numéro du ticket créé afin que l’appelant dispose d’une référence pour le suivi.

#### Résolution par le service d’assistance

#### Rechercher le ticket

L’agent récupère un problème Jira à l’aide de sa clé, par exemple PROJ-123, et communique son
statut actuel, sa priorité et son résumé.

#### Ajouter des notes de résolution

L’agent ajoute un commentaire au problème avec les détails de la conversation, tels que les étapes
réalisées ou les informations recueillies.

#### Fermer le ticket

L’agent fait passer le problème à un statut résolu ou fermé à l’aide des transitions
de flux de travail disponibles.

## Exemple de prompt système

#### Afficher un exemple de prompt système

```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.
```

## Outils disponibles

| Outil                   | Description                                                                                                                       |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `jira_create_issue`     | Crée un problème avec le projet, le résumé, le type de problème et des champs facultatifs comme la priorité.                      |
| `jira_get_issue`        | Récupère les détails d’un problème spécifique à partir de sa clé.                                                                 |
| `jira_search_issues`    | Recherche des problèmes par étiquette, projet, statut, priorité, type, responsable, texte ou plage de dates.                      |
| `jira_update_issue`     | Met à jour les champs d’un problème existant : priorité, responsable, étiquettes ou description.                                  |
| `jira_add_comment`      | Ajoute un commentaire en texte brut à un problème.                                                                                |
| `jira_get_transitions`  | Liste les transitions de flux de travail disponibles pour un problème.                                                            |
| `jira_transition_issue` | Déplace un problème vers un nouveau statut de flux de travail à l’aide d’un ID de transition provenant de `jira_get_transitions`. |
| `jira_link_issues`      | Lie deux problèmes, par exemple « Blocks », « Duplicate », « Relates ».                                                           |
| `jira_list_projects`    | Liste les projets disponibles et leurs clés.                                                                                      |
| `jira_get_issue_types`  | Liste les types de problèmes disponibles, par exemple Bug, Task, Story.                                                           |
| `jira_get_priorities`   | Liste les niveaux de priorité disponibles.                                                                                        |

> **Note**
>
> Les descriptions de problèmes et les commentaires sont uniquement en texte brut. L’intégration les convertit automatiquement au format
> Atlassian Document Format (ADF) de Jira. Markdown et HTML ne sont pas pris en charge.

## Liens utiles

* [Documentation de l’API REST Jira Cloud](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
* [Gérer les jetons API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)