Jira
Connexion de Jira avec Siesta AI
- Dans Connexion, sélectionnez Ajouter une connexion et choisissez Jira.
- Remplissez URL, Nom d'utilisateur et Mot de passe (token API) et définissez Partagé ou Privé.
- Optionnellement, modifiez les opérations autorisées.
Aperçu
Cette connexion fournit une interface de programmation pour travailler avec Jira (Atlassian). Elle permet la création, la lecture, la recherche, la mise à jour et l'attribution d'issues Jira (tickets) à travers des projets.
Conçu pour :
- Automatisation des incidents et des opérations
- Orchestration des workflows d'ingénierie
- Synchronisation des systèmes externes (CRM, surveillance, agents IA)
- Processus basés sur des tickets audités
Authentification et sécurité
- La connexion utilise l'API REST officielle de Jira.
- L'authentification se fait via un compte Atlassian (OAuth / token API).
- L'utilisateur est identifié par l'ID de compte Atlassian, pas par l'e-mail.
- Les autorisations sont gérées directement au niveau de l'instance Jira.
Si l'utilisateur n'a pas le droit de voir une issue, la connexion ne la verra pas non plus.
Concepts de base
- IssueKey : ID du ticket (par exemple,
PROJ-123). - ProjectKey : clé du projet Jira (par exemple,
PROJ). - AccountId : identifiant unique de l'utilisateur dans l'écosystème Atlassian.
- JQL : Jira Query Language.
1. Création de ticket
1.1 CreateTicketAsync
Description
Crée une nouvelle issue Jira dans le projet spécifié.
Paramètres d'entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| projectKey | String | Oui | Clé du projet Jira. |
| issueType | String | Oui | Type d'issue (Tâche, Bug, Histoire, ...). |
| summary | String | Oui | Titre court de l'issue. |
| description | String | Non | Description détaillée. |
| assigneeId | String | Non | ID de compte Atlassian de l'utilisateur. |
Comportement
- Le type d'issue doit exister dans le projet.
- Aucun fallback ni mappage des types.
- Mauvaise combinaison = échec.
2. Attribution de ticket
2.1 AssignTicketAsync
Description
Assigne une issue existante à un utilisateur spécifique.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| issueKey | String | Oui |
| assigneeAccountId | String | Oui |
Remarque Jira ignore les e-mails. L'ID de compte est le seul identifiant fiable.
3. Récupération de ticket
3.1 GetTicketAsync
Description
Retourne les détails d'une issue selon issueKey.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| issueKey | String | Oui |
3.2 GetTicketsByProjectAsync
Description
Retourne les issues appartenant à un projet spécifique.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| projectKey | String | Oui |
| maxResults | Int | Non |
3.3 GetTicketsByUserAsync
Description
Retourne les issues assignées à un utilisateur spécifique.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| assigneeEmail | String | Oui |
| maxResults | Int | Non |
4. Mise à jour de ticket
4.1 UpdateTicketAsync
Description
Met à jour le résumé et/ou la description d'une issue existante.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| issueKey | String | Oui |
| summary | String | Non |
| description | String | Non |
Comportement
- Seuls les champs fournis sont mis à jour.
- Aucune validation des statuts des workflows n'est effectuée.
5. Recherche et requête
5.1 SearchTicketsAsync
Description
Recherche des issues à l'aide d'une requête JQL.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| jql | String | Oui |
| maxResults | Int | Non |
Exemple de JQL
project = PROJ AND status = "À faire"
Un JQL incorrect renvoie une erreur immédiate.
6. Opérations sur les projets et les utilisateurs
6.1 GetAllProjectsAsync
Description
Retourne la liste des projets disponibles pour l'utilisateur actuel.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| maxResults | Int | Non |
6.2 GetUserAsync
Description
Retourne les informations sur un utilisateur selon l'ID de compte.
Paramètres d'entrée
| Paramètre | Type | Obligatoire |
|---|---|---|
| accountId | String | Oui |
Principes de conception
- ID de compte > e-mail (RGPD et réalité d'Atlassian).
- Entrées explicites sans présomptions.
- Comportement fail-fast sur les requêtes erronées.
- Respect des règles des workflows Jira.
Résumé
La connexion Jira fournit un accès direct, sécurisé et auditable aux issues et projets Jira. Elle est adaptée pour l'automatisation des tickets, les agents d'incidents, les outils de productivité en ingénierie et l'intégration des workflows d'entreprise.