Intégration Jira
Fonctionne avec Jira
Connectez ReplyRabbit à Jira Cloud pour que les conversations de support dans FreeScout deviennent des tickets Jira structurés. Les agents peuvent créer un ticket Jira à partir d'une conversation, garder le ticket lié visible dans FreeScout et utiliser ReplyRabbit pour préparer la relance client lorsque le travail est terminé.
Vous cherchez la vue d'ensemble ?
Aperçu
L'intégration Jira ajoute un panneau Jira à ReplyRabbit dans une conversation FreeScout. Lorsque Jira est configuré pour une boîte aux lettres, ReplyRabbit peut créer un ticket avec un titre, une description, une priorité, des libellés, un assigné, un type de ticket, un projet et un lien vers la conversation de support.
Jira est sélectionné comme gestionnaire de tickets actif pour une boîte aux lettres. Si une boîte aux lettres utilise déjà Linear ou GitHub Issues, conservez ce gestionnaire sélectionné jusqu'à ce que vous soyez prêt à basculer cette boîte aux lettres vers Jira.
Prérequis
Avant de commencer, assurez-vous de disposer de :
- Une installation FreeScout fonctionnelle.
- ReplyRabbit installé et activé.
- Un forfait ReplyRabbit qui inclut la fonctionnalité Jira que vous souhaitez utiliser.
- Un site Jira Cloud tel que
https://example.atlassian.net. - Un e-mail de compte Jira et un jeton API avec accès au projet cible.
- Au moins un projet Jira et un type de ticket qui prennent en charge la création de tickets.
- Permissions de projet Jira pour le workflow que vous activez : Parcourir les projets et Créer des tickets sont requis ; Modifier les tickets, Assigner des tickets, Effectuer des transitions et Ajouter des commentaires sont nécessaires lorsque vous utilisez les modifications de priorité/label, l'assignation, les transitions de statut ou les commentaires de fil.
Si ReplyRabbit n'est pas encore installé, commencez par Comment installer le module ReplyRabbit, puis terminez Comment configurer ReplyRabbit.
Permissions et jetons API
ReplyRabbit se connecte à l'API REST Jira Cloud v3 avec une authentification Basic. La boîte aux lettres stocke trois valeurs de connexion :
- URL du site Jira : le
https://example.atlassian.netURL du site. - E-mail du compte : l'e-mail du compte Atlassian utilisé avec le jeton API.
- Jeton API : le jeton API Jira Cloud pour ce compte.
Le jeton API est stocké comme paramètre de boîte aux lettres chiffré et n'est plus affiché en entier après son enregistrement. Si le jeton est renouvelé ou supprimé dans Atlassian, mettez à jour les paramètres de la boîte aux lettres avant de créer d'autres tickets.
Connecter Jira
Ouvrez les paramètres de la boîte aux lettres
Dans FreeScout, ouvrez la boîte aux lettres qui doit créer des tickets Jira, puis ouvrez Paramètres et choisissez ReplyRabbit.Choisir Jira comme outil de suivi des tickets
Dans le Intégrations section, définissez le gestionnaire de tickets sur Jira. Une boîte aux lettres peut utiliser Linear, GitHub Issues, Jira ou aucun outil de suivi des tickets.Ajouter les identifiants Jira
Collez l'URL du site Jira Cloud, l'e-mail du compte et le jeton API.Charger les projets Jira
Charger les projets depuis Jira, puis choisir le projet par défaut pour les nouveaux tickets.Choisir le type de ticket
Charger les types de tickets du projet et choisir le type de ticket par défaut, comme Tâche ou Bug.Enregistrer les paramètres
Enregistrez les paramètres de la boîte aux lettres. ReplyRabbit stocke la connexion Jira pour cette boîte aux lettres.
Configurer les valeurs par défaut
Une fois Jira connecté, configurez les valeurs par défaut dont votre équipe a besoin :
- Projet par défaut : le projet Jira utilisé lorsqu'aucun mappage de domaine ni correspondance de projet IA ne choisit un autre projet.
- Type de problème par défaut : le type de ticket pour les nouveaux tickets, généralement Task ou Bug.
- Correspondance des priorités : associez les niveaux de priorité ReplyRabbit aux noms de priorité Jira natifs.
- Routage par projet : associez les domaines e-mail des clients aux projets Jira lorsque le routage doit être déterministe.
- Soumission automatique des tickets : sur le niveau Team, laissez ReplyRabbit créer automatiquement des tickets Jira lorsque le triage indique qu'un travail d'ingénierie est nécessaire.
- Brouillon automatique à la clôture : laissez ReplyRabbit préparer un suivi client lorsque le ticket Jira lié atteint la catégorie de statut Terminé.
Le routage par projet est facultatif. Si aucun projet ne correspond avec certitude, ReplyRabbit utilise le projet par défaut de la boîte aux lettres.
Créer un ticket Jira à partir d'une conversation FreeScout
Ouvrez une conversation dans une boîte aux lettres où Jira est configuré. Le panneau ReplyRabbit peut créer une issue Jira à partir du fil client, puis afficher l'issue liée dans FreeScout.
ReplyRabbit envoie à Jira une description structurée au format Atlassian Document Format. La description inclut le résumé de support, le contexte client et le lien de la conversation FreeScout. Le texte du client est traité comme du contenu, pas comme des instructions.
Après la création, révisez le ticket Jira lié et ajustez le statut, la priorité, l'assigné ou les étiquettes depuis le panneau ReplyRabbit si nécessaire.
Gardez les conversations et les tickets synchronisés
Une fois une issue liée, la conversation FreeScout peut afficher le statut, la priorité, l'assigné, les étiquettes et la clé d'issue Jira actuels. Les agents peuvent ouvrir l'issue dans Jira lorsqu'ils ont besoin de la vue d'ingénierie complète.
ReplyRabbit modifie le statut Jira via les transitions Jira. Il n'écrit pas directement dans le champ de statut.
ReplyRabbit prend également en charge une boucle d'achèvement. Une vérification planifiée du statut interroge les tickets Jira liés. Lorsque Jira signale la catégorie de statut Done, ReplyRabbit peut aider à rédiger le suivi client afin que le support puisse clôturer la conversation avec le contexte.
Dépannage
| Symptôme | Ce qu'il faut vérifier |
|---|---|
| Les projets ne se chargent pas | Confirmez que l'URL du site est un Jira Cloud atlassian.net URL, l'e-mail est correct et le jeton API a accès au projet. |
| Les types de tickets sont manquants | Confirmez que le projet sélectionné prend en charge le type de ticket que vous prévoyez d'utiliser. |
| Les tickets ne sont pas créés | Confirmez que Jira est sélectionné comme outil de suivi des tickets de la boîte aux lettres, qu'un projet est sélectionné et que votre offre ReplyRabbit inclut la fonctionnalité. |
| Les tickets automatiques ne sont pas créés | Confirmez que vous êtes sur l'offre Team et Soumission automatique des tickets est activé. |
| L'état ne sera pas mis à jour | Rechargez la conversation, puis confirmez que Jira expose une transition valide pour le statut cible. |
| Les brouillons de fin n'apparaissent pas | Confirmer Brouillon automatique à la clôture est activé et le ticket Jira lié a atteint la catégorie de statut Terminé. |
Pour des corrections plus larges, voir Dépannage de ReplyRabbit.
Confidentialité et traitement des données
ReplyRabbit envoie à Jira le contenu d'issue nécessaire au transfert vers l'ingénierie. Cela peut inclure le contexte client pertinent, le texte d'issue généré, la priorité, les labels, l'assigné et un lien ou identifiant de conversation FreeScout.
Ne mettez pas d'informations sensibles dans un problème Jira, sauf si votre espace de travail Jira Cloud est autorisé à les recevoir. Si les données clients doivent rester entièrement sur votre propre serveur, laissez Jira désactivé pour cette boîte aux lettres.
FAQ
ReplyRabbit prend-il en charge Jira Data Center ou Server ?
Non. ReplyRabbit prend en charge les sites Jira Cloud qui utilisent une URL atlassian.net.
Ai-je besoin d'OAuth pour Jira ?
Non. ReplyRabbit utilise une authentification Basic Jira Cloud par boîte aux lettres avec une URL de site, un e-mail de compte et un jeton API Jira.
Une boîte aux lettres peut-elle utiliser Jira avec Linear ou GitHub Issues en même temps ?
Non. Une boîte aux lettres choisit un seul outil de suivi de tickets actif. Les paramètres Linear et GitHub Issues restent disponibles lorsque l'un ou l'autre est sélectionné.
ReplyRabbit peut-il rédiger un suivi client lorsqu'un ticket Jira est terminé ?
Oui. ReplyRabbit interroge les tickets Jira liés et peut préparer un brouillon de suivi client lorsque Jira signale la catégorie de statut Done.