---
title: Jira
description: Interagir avec Jira
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="jira"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Jira](https://www.atlassian.com/jira) est une plateforme leader de gestion de projet et de suivi des problèmes qui aide les équipes à planifier, suivre et gérer efficacement les projets de développement logiciel agile. En tant que partie de la suite Atlassian, Jira est devenu la référence dans l'industrie pour les équipes de développement logiciel et les professionnels de la gestion de projet dans le monde entier.

Jira fournit un ensemble complet d'outils pour gérer des projets complexes grâce à son système de flux de travail flexible et personnalisable. Avec son API robuste et ses capacités d'intégration, Jira permet aux équipes de rationaliser leurs processus de développement et de maintenir une visibilité claire sur l'avancement des projets.

Les fonctionnalités clés de Jira comprennent :

- Gestion de projet agile : prise en charge des méthodologies Scrum et Kanban avec des tableaux et des flux de travail personnalisables
- Suivi des problèmes : système sophistiqué de suivi des bugs, des récits utilisateurs, des épopées et des tâches avec des rapports détaillés
- Automatisation des flux de travail : règles d'automatisation puissantes pour rationaliser les tâches et processus répétitifs
- Recherche avancée : JQL (Jira Query Language) pour le filtrage et la création de rapports complexes

Dans Sim, l'intégration de Jira permet à vos agents d'interagir de manière transparente avec votre flux de travail de gestion de projet. Cela crée des opportunités pour la création, la mise à jour et le suivi automatisés des problèmes dans le cadre de vos flux de travail IA. L'intégration permet aux agents de créer, récupérer et mettre à jour des tickets Jira par programmation, facilitant les tâches de gestion de projet automatisées et garantissant que les informations importantes sont correctement suivies et documentées. En connectant Sim avec Jira, vous pouvez créer des agents intelligents qui maintiennent la visibilité du projet tout en automatisant les tâches routinières de gestion de projet, améliorant la productivité de l'équipe et assurant un suivi cohérent des projets.
{/* MANUAL-CONTENT-END */}

## Instructions d'utilisation

Intégrez Jira dans le flux de travail. Peut lire, écrire et mettre à jour des tickets. Peut également déclencher des flux de travail basés sur des événements webhook Jira.

## Outils

### `jira_retrieve`

Récupérer des informations détaillées sur un ticket Jira spécifique

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `projectId` | chaîne | Non | ID du projet Jira \(facultatif ; non requis pour récupérer un seul ticket\). |
| `issueKey` | chaîne | Oui | Clé du ticket Jira à récupérer \(ex. : PROJ-123\) |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Statut de réussite de l'opération |
| `output` | objet | Détails du ticket Jira avec la clé du ticket, le résumé, la description, les horodatages de création et de mise à jour |

### `jira_update`

Mettre à jour un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `projectId` | chaîne | Non | ID du projet Jira pour mettre à jour les tickets. S'il n'est pas fourni, tous les tickets seront récupérés. |
| `issueKey` | chaîne | Oui | Clé du ticket Jira à mettre à jour |
| `summary` | chaîne | Non | Nouveau résumé pour le ticket |
| `description` | chaîne | Non | Nouvelle description pour le ticket |
| `status` | chaîne | Non | Nouveau statut pour le ticket |
| `priority` | chaîne | Non | Nouvelle priorité pour le ticket |
| `assignee` | chaîne | Non | Nouvel assigné pour le ticket |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la demande Jira mise à jour avec horodatage, clé de la demande, résumé et statut de réussite |

### `jira_write`

Rédiger une demande Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira (ex. : votreentreprise.atlassian.net) |
| `projectId` | string | Oui | ID du projet pour la demande |
| `summary` | string | Oui | Résumé de la demande |
| `description` | string | Non | Description de la demande |
| `priority` | string | Non | Priorité de la demande |
| `assignee` | string | Non | Assigné de la demande |
| `cloudId` | string | Non | ID Jira Cloud pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |
| `issueType` | string | Oui | Type de demande à créer (ex. : Tâche, Story) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la demande Jira créée avec horodatage, clé de la demande, résumé, statut de réussite et URL |

### `jira_bulk_read`

Récupérer plusieurs demandes Jira en masse

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira (ex. : votreentreprise.atlassian.net) |
| `projectId` | string | Oui | ID du projet Jira |
| `cloudId` | string | Non | ID Jira Cloud |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | array | Tableau des tickets Jira avec résumé, description, horodatages de création et de mise à jour |

### `jira_delete_issue`

Supprimer un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira à supprimer \(ex. : PROJ-123\) |
| `deleteSubtasks` | booléen | Non | Indique s'il faut supprimer les sous-tâches. Si faux, les tickets parents avec sous-tâches ne peuvent pas être supprimés. |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Statut de réussite de l'opération |
| `output` | objet | Détails du ticket supprimé avec horodatage, clé du ticket et statut de réussite |

### `jira_assign_issue`

Assigner un ticket Jira à un utilisateur

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira à assigner \(ex. : PROJ-123\) |
| `accountId` | chaîne | Oui | ID de compte de l'utilisateur à qui assigner le ticket. Utilisez "-1" pour l'attribution automatique ou null pour retirer l'assignation. |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Statut de réussite de l'opération |
| `output` | objet | Détails de l'assignation avec horodatage, clé du ticket, ID de l'assigné et statut de réussite |

### `jira_transition_issue`

Déplacer un ticket Jira entre les statuts de workflow (par ex., À faire -> En cours)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira à faire transiter \(ex. : PROJ-123\) |
| `transitionId` | chaîne | Oui | ID de la transition à exécuter \(ex. : "11" pour "À faire", "21" pour "En cours"\) |
| `comment` | chaîne | Non | Commentaire optionnel à ajouter lors de la transition du ticket |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Statut de réussite de l'opération |
| `output` | objet | Détails de la transition avec horodatage, clé du ticket, ID de transition et statut de réussite |

### `jira_search_issues`

Rechercher des tickets Jira à l'aide de JQL (Jira Query Language)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `jql` | chaîne | Oui | Chaîne de requête JQL pour rechercher des tickets \(ex. : "project = PROJ AND status = Open"\) |
| `startAt` | nombre | Non | L'index du premier résultat à renvoyer \(pour la pagination\) |
| `maxResults` | nombre | Non | Nombre maximum de résultats à renvoyer \(par défaut : 50\) |
| `fields` | tableau | Non | Tableau des noms de champs à renvoyer \(par défaut : \['summary', 'status', 'assignee', 'created', 'updated'\]\) |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Statut de réussite de l'opération |
| `output` | objet | Résultats de recherche avec horodatage, nombre total, détails de pagination et tableau des tickets correspondants |

### `jira_add_comment`

Ajouter un commentaire à un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira auquel ajouter un commentaire \(ex. : PROJ-123\) |
| `body` | chaîne | Oui | Texte du corps du commentaire |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Statut de réussite de l'opération |
| `output` | objet | Détails du commentaire avec horodatage, clé du ticket, ID du commentaire, corps et statut de réussite |

### `jira_get_comments`

Obtenir tous les commentaires d'un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira dont il faut récupérer les commentaires \(ex. : PROJ-123\) |
| `startAt` | nombre | Non | Index du premier commentaire à renvoyer \(par défaut : 0\) |
| `maxResults` | nombre | Non | Nombre maximum de commentaires à renvoyer \(par défaut : 50\) |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Données des commentaires avec horodatage, clé du ticket, nombre total et tableau de commentaires |

### `jira_update_comment`

Mettre à jour un commentaire existant sur un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira contenant le commentaire \(ex. : PROJ-123\) |
| `commentId` | chaîne | Oui | ID du commentaire à mettre à jour |
| `body` | chaîne | Oui | Texte du commentaire mis à jour |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails du commentaire mis à jour avec horodatage, clé du ticket, ID du commentaire, texte du corps et statut de réussite |

### `jira_delete_comment`

Supprimer un commentaire d'un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira contenant le commentaire \(ex. : PROJ-123\) |
| `commentId` | chaîne | Oui | ID du commentaire à supprimer |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la suppression avec horodatage, clé du ticket, ID du commentaire et statut de réussite |

### `jira_get_attachments`

Obtenir toutes les pièces jointes d'un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | string | Oui | Clé du ticket Jira pour obtenir les pièces jointes \(ex. : PROJ-123\) |
| `cloudId` | string | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Données des pièces jointes avec horodatage, clé du ticket et tableau des pièces jointes |

### `jira_delete_attachment`

Supprimer une pièce jointe d'un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `attachmentId` | string | Oui | ID de la pièce jointe à supprimer |
| `cloudId` | string | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la suppression avec horodatage, ID de la pièce jointe et statut de réussite |

### `jira_add_worklog`

Ajouter une entrée de journal de travail pour le suivi du temps à un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira auquel ajouter le journal de travail \(ex. : PROJ-123\) |
| `timeSpentSeconds` | nombre | Oui | Temps passé en secondes |
| `comment` | chaîne | Non | Commentaire optionnel pour l'entrée du journal de travail |
| `started` | chaîne | Non | Heure de début optionnelle au format ISO \(par défaut : heure actuelle\) |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Statut de réussite de l'opération |
| `output` | objet | Détails du journal de travail avec horodatage, clé du ticket, ID du journal de travail, temps passé en secondes et statut de réussite |

### `jira_get_worklogs`

Obtenir toutes les entrées du journal de travail d'un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira dont il faut obtenir les journaux de travail \(ex. : PROJ-123\) |
| `startAt` | nombre | Non | Index du premier journal de travail à retourner \(par défaut : 0\) |
| `maxResults` | nombre | Non | Nombre maximum de journaux de travail à retourner \(par défaut : 50\) |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Données des journaux de travail avec horodatage, clé du ticket, nombre total et tableau des journaux de travail |

### `jira_update_worklog`

Mettre à jour une entrée de journal de travail existante sur un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira contenant le journal de travail \(ex. : PROJ-123\) |
| `worklogId` | chaîne | Oui | ID de l'entrée du journal de travail à mettre à jour |
| `timeSpentSeconds` | nombre | Non | Temps passé en secondes |
| `comment` | chaîne | Non | Commentaire optionnel pour l'entrée du journal de travail |
| `started` | chaîne | Non | Heure de début optionnelle au format ISO |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la mise à jour du journal de travail avec horodatage, clé du ticket, ID du journal de travail et statut de réussite |

### `jira_delete_worklog`

Supprimer une entrée de journal de travail d'un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | chaîne | Oui | Clé du ticket Jira contenant le journal de travail \(ex. : PROJ-123\) |
| `worklogId` | chaîne | Oui | ID de l'entrée du journal de travail à supprimer |
| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la suppression avec horodatage, clé de la demande, ID du journal de travail et statut de réussite |

### `jira_create_issue_link`

Créer une relation de lien entre deux tickets Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `inwardIssueKey` | string | Oui | Clé du ticket Jira pour la demande entrante \(ex. : PROJ-123\) |
| `outwardIssueKey` | string | Oui | Clé du ticket Jira pour la demande sortante \(ex. : PROJ-456\) |
| `linkType` | string | Oui | Le type de relation de lien \(ex. : "Bloque", "Est lié à", "Duplique"\) |
| `comment` | string | Non | Commentaire optionnel à ajouter au lien de la demande |
| `cloudId` | string | Non | ID Jira Cloud pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails du lien entre tickets avec horodatage, clé du ticket entrant, clé du ticket sortant, type de lien et statut de réussite |

### `jira_delete_issue_link`

Supprimer un lien entre deux tickets Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `linkId` | string | Oui | ID du lien de ticket à supprimer |
| `cloudId` | string | Non | ID Jira Cloud pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la suppression avec horodatage, ID du lien et statut de réussite |

### `jira_add_watcher`

Ajouter un observateur à un ticket Jira pour recevoir des notifications sur les mises à jour

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | string | Oui | Clé du ticket Jira auquel ajouter un observateur \(ex. : PROJ-123\) |
| `accountId` | string | Oui | ID de compte de l'utilisateur à ajouter comme observateur |
| `cloudId` | string | Non | ID Jira Cloud pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de l'observateur avec horodatage, clé du ticket, ID de compte de l'observateur et statut de réussite |

### `jira_remove_watcher`

Supprimer un observateur d'un ticket Jira

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) |
| `issueKey` | string | Oui | Clé du ticket Jira duquel supprimer l'observateur \(ex. : PROJ-123\) |
| `accountId` | string | Oui | ID de compte de l'utilisateur à supprimer comme observateur |
| `cloudId` | string | Non | ID Jira Cloud pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Statut de réussite de l'opération |
| `output` | object | Détails de la suppression avec horodatage, clé de la demande, ID du compte observateur et statut de réussite |

## Notes

- Catégorie : `tools`
- Type : `jira`
