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-user-email: votre email
• jira-api-token
  • Cliquez sur les paramètres
  • Cliquez sur Paramètres du compte Atlassian
  • Cliquez sur Sécurité > Créer et gérer des token API 
  • Générez un nouveau token et indiquez le dans les variables Vizir

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

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)

• 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

Vous avez maintenant 6 variables dans votre dashboard Vizir

Ajoutez le connecteur Atlassian

• Cliquez sur le bouton Se connecter

Copier le authId et ajoutez le en variable jira-basic-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

• 👉 Basic authorization Jira (opens new window)

• 👉 Pour générer l'api token (opens new window)

• 👉 Doc API v3 (opens new window)

• 👉 Configurer des webhook (opens new window)

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.