Qui peut le faire : Admins d'entreprise, admins système Jira
Quels forfaits : Entreprise
✏️ Disponible pour Jira Server et Jira Data Center sur site avec OAuth 2.0 et OAuth 1.0.
Pour mettre à jour les cartes Jira sur le tableau, Miro doit recevoir des messages de Jira contenant les événements de changement de données. Ces événements Jira sont transmis vers Miro via un webhook. Il est possible de créer un webhook dans Miro de deux manières différentes.
Option 1 (recommandée) : Créer un webhook automatiquement
Lorsque vous configurez votre plugin de cartes Jira, sélectionnez Jira Server ou Jira Data Center et ne désactivez pas l’option Créer un webhook automatiquement.
✏️ La création automatique de webhooks nécessite que vous soyez connecté à Jira en tant qu'administrateur.
Paramètres des cartes Jira, Étape 2 : Créer un webhook automatiquement" est activé
Après avoir créé le webhook, n'oubliez pas d'aller sur votre page Jira WebHooks et de le modifier pour lui donner un nom unique au cas où vous prévoyez de connecter plusieurs équipes Miro à votre instance Jira.
⚠️ Un autre webhook sera créé pour la connexion de chaque équipe, il est donc important de s'assurer que le nom soit unique. Lorsque vous déconnectez des équipes, les webhooks associés ne sont pas supprimés.
Option 2 : Créer un webhook manuellement
Comment obtenir le webhook
- Décochez l'option pour créer un webhook automatiquement
- Copiez et collez l'URL de Jira et cliquez sur Connecter et enregistrer les paramètres.
Paramètres des cartes Jira, Étape 2 : "Créer un webhook automatiquement" est désactivé - Autoriser l'intégration à se connecter dans Jira.
- Vous aurez maintenant l’URL du webhook dans Miro :
URL du Webhook
✏️ Si vous n’êtes pas un admin Jira System, veuillez envoyer l’URL du WebHook à votre admin Jira pour que ce dernier crée un webhook du côté de Jira.
Comment appliquer le webhook
Voici ci-dessous les étapes à suivre pour créer un webhook. Vous pouvez également vous référer à la documentation Atlassian : pour Jira Server et pour Jira Cloud.
- Pour accéder à la page WebHooks dans Jira, allez dans Administration > System > Advanced > WebHooks. Vous pouvez également utiliser le lien suivant en ajoutant le nom unique de votre instance Jira (le lien fonctionne pour Server et Cloud bien que nous ne puissions garantir le succès pour chaque version) : https://JiraInstanceName/plugins/servlet/webhooks
- Cliquez Créer un WebHook dans le coin supérieur droit :
- Saisissez le Nom du WebHook, réglez le statut du WebHook sur Activé, et collez l’URL du WebHook copiée depuis Miro :
Webhooks système dans Jira - Choisissez les événements mis à jour et supprimés dans la section Émission et cliquez Créer:
Paramètres du WebHook Jira - Retournez à l'étape 2 dans les paramètres de Miro, remplissez votre URL Jira, et cliquez sur Connecter.
Le webhook est désormais créé, les cartes Jira sont activées et peuvent être mises à jour automatiquement. Toute modification apportée dans Jira est répercutée dans les cartes Jira sur le tableau.