# Jira

Nous allons dans un premeir temps utiliser la connexion Basic pour se connecter à votre instance JIRA.

Pour cela, nous devons avoir accès à 3 informations à renseigner dans les variables sur le dashboard Vizir:

# Variables Vizir

  • atlassian-domain: à récupérer dans l'url de votre instance Jira jira-instance-name
  • jira-user-email: votre email
  • jira-api-token
    • Cliquez sur les paramètres Token application jira
    • Cliquez sur Paramètres du compte Atlassian Token application jira
    • Cliquez sur Sécurité > Créer et gérer des token API ![Token application jira](./images/jira/token-settings-3 .png)
    • Générez un nouveau token et indiquez le dans les variables Vizir

Vous avez maintenant 3 variables dans Vizir comme ci-dessous: Variables Vizir

Pour simplifier la configuration des workflows, nous allons rajouter 3 autres variables

  • jira-serviceDeskId
  • jira-projectId
  • jira-issuetype

Pour récupérer ces valeurs c'est un peu technique, il faut utiliser un outil comme Insomnia ou Postman pour réaliser des appels API

  • Créer une nouvelle requête

    • Url: https://yourProjectName.atlassian.net/rest/api/3/myself
    • Auth: Basic
      • username: votre email
      • password: votre token api généré à l'étape 1
    • Méthode: GET
    • Exécuter la requête
    • Récupérer le accountId (jira-serviceDeskId) Jira AccountId
  • Créer une nouvelle requête

    • Url: https://yourProjectName.atlassian.net/rest/api/3/issuetype
    • Auth: Basic
      • username: votre email
      • password: votre token api généré à l'étape 1
    • Méthode: GET
    • Exécuter la requête
    • Récupérer le projectId et l'id du type de ticket que vous souhaitez créer via le chatbot Jira AccountId

Vous avez maintenant 6 variables dans votre dashboard Vizir Variables Vizir

# Ajoutez le connecteur Atlassian

  • Cliquez sur le bouton Se connecter Jira Connector

Copier le authId et ajoutez le en variable jira-basic-auth-id Jira Copy auth Id

Vous pouvez maintenant utiliser l'api Jira librement dans votre chatbot

Voici la liste des actions disponible avec ce connecteur Jira

  • CreateRequest
  • Get Request
  • FindUserByEmail

Lors de la création d'une requête nous vous conseillons d'enchainer findUserByEmail > createRequest pour que la requête soit ouverte en nom de la personne qui parle au chatbot.

# Recevoir des informations depuis Jira

You will need to get the request with another action in order to get the respondentID and send a notification to this user.

  • issue-commented
  • issue-opened
  • issue-updated
  • issue-deleted

Il existe plusieurs façon de récupérer le respondentID:

  • passer par des labels
  • passer par des custom_fields

# Pour aller plus loin

Les webhooks vous permettent de rendre le chatbot encore plus dynamique en notificant les utilisateurs dès que leur ticket est mis à jours dans Jira par les équipes support.