Intégration GitHub Issues
Fonctionne avec GitHub
Connectez ReplyRabbit à GitHub Issues pour que les conversations de support dans FreeScout deviennent des tickets structurés dans le bon dépôt. Les agents peuvent créer un ticket à partir d'une conversation, garder le ticket lié visible dans FreeScout et laisser ReplyRabbit préparer le transfert vers l'ingénierie.
Vous cherchez la vue d'ensemble ?
Aperçu
L'intégration GitHub Issues ajoute un panneau GitHub à ReplyRabbit dans une conversation FreeScout. Lorsque GitHub est configuré, ReplyRabbit peut créer un ticket avec un titre adapté aux développeurs, un résumé utile, des libellés, des assignés, le contexte du dépôt et un lien vers la conversation de support.
Chaque boîte aux lettres choisit un outil de suivi des problèmes : aucun, Linear ou GitHub. GitHub et Linear sont des alternatives pour le même flux de travail support-vers-ingénierie, et non deux outils de suivi qui fonctionnent ensemble dans une même boîte aux lettres.
La création manuelle de tickets GitHub est disponible sur Pro et Team. La création automatique de tickets GitHub à partir de nouveaux emails clients est disponible sur Team.
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é GitHub que vous souhaitez utiliser.
- Accès à un compte ou une organisation GitHub où les tickets doivent être créés.
- Un dépôt avec GitHub Issues activé.
Si ReplyRabbit n'est pas encore installé, commencez par Comment installer le module ReplyRabbit, puis terminez Comment configurer ReplyRabbit.
Permissions et portée des jetons
ReplyRabbit se connecte à GitHub avec un token d'accès personnel que vous fournissez dans les paramètres de la boîte aux lettres. Un token à granularité fine est recommandé, limité aux dépôts que ReplyRabbit doit utiliser. Vous pouvez en créer un depuis Paramètres de jeton à granularité fine de GitHub.
Accordez au jeton suffisamment d'accès pour lire les métadonnées du dépôt, lire les libellés et les assignés, créer et mettre à jour des tickets, et ajouter des commentaires aux tickets. Pour un jeton à granularité fine, commencez par Métadonnées : lecture, Contenu : lecture, et Tickets : lecture et écriture pour les dépôts sélectionnés.
Pour des pistes d'audit plus strictes, créez le jeton depuis un compte bot GitHub dédié qui n'a accès qu'aux dépôts que ReplyRabbit doit utiliser.
Gardez le jeton privé. Si le jeton est renouvelé ou supprimé dans GitHub, mettez à jour les paramètres de la boîte aux lettres avant de créer d'autres tickets.
Connecter GitHub Issues
Ouvrez les paramètres de la boîte aux lettres
Dans FreeScout, ouvrez la boîte aux lettres qui doit créer des tickets GitHub, puis ouvrez Paramètres et choisissez ReplyRabbit.Choisir GitHub comme outil de suivi des tickets
Dans le sélecteur de suivi de tickets, choisissez GitHub Issues. ReplyRabbit affiche les paramètres GitHub et masque les paramètres Linear pour cette boîte aux lettres.Collez le jeton
Collez votre Jeton d'accès personnel GitHub. Si vous avez déjà enregistré un token, ReplyRabbit affiche un aperçu masqué au lieu du secret complet.Charger les dépôts
Cliquez sur le bouton pour charger les dépôts depuis GitHub, puis choisissez le dépôt par défaut où les nouveaux tickets doivent être créés.Enregistrer les paramètres
Enregistrez les paramètres de la boîte aux lettres. ReplyRabbit stocke la connexion GitHub pour cette boîte aux lettres.
Configurer les valeurs par défaut
Une fois le dépôt par défaut sélectionné, configurez les valeurs par défaut des tickets à partir desquelles vos agents doivent commencer :
- Dépôt par défaut : choisissez où les tickets sont créés lorsqu'aucune règle de routage ne correspond.
- Soumission automatique des tickets : sur le niveau Team, laissez ReplyRabbit créer automatiquement des tickets GitHub lorsque le résultat du triage indique qu'un travail d'ingénierie est nécessaire.
- Routage des dépôts : activez la sélection automatique de dépôt lorsque vous voulez que ReplyRabbit associe les conversations aux dépôts disponibles.
- Mappages de domaines : associez les domaines e-mail des clients à des dépôts spécifiques lorsque vous avez besoin d'un routage déterministe.
- Étiquettes : choisissez les libellés que ReplyRabbit peut appliquer pour le type de ticket, la priorité ou d'autres tags de workflow.
- Libellés de priorité : associez les niveaux de priorité ReplyRabbit aux étiquettes GitHub, car GitHub Issues n'a pas de champ de priorité natif.
- Assigné par défaut : choisissez l'utilisateur GitHub qui doit recevoir les nouveaux tickets par défaut.
- Avis de révision : lorsque la création automatique de tickets est activée, ajoutez une note FreeScout qui indique aux agents que le ticket a été créé automatiquement et doit être examiné.
Le routage des dépôts est facultatif. Si aucun dépôt ne correspond avec certitude, ReplyRabbit utilise le dépôt par défaut.
Créer un ticket GitHub à partir d'une conversation FreeScout
Ouvrez une conversation dans une boîte aux lettres où GitHub est configuré. Le panneau ReplyRabbit peut créer une issue GitHub à partir du fil client, puis afficher l'issue liée dans FreeScout.
Le contenu du ticket est généré pour un transfert vers l'ingénierie, pas copié aveuglément depuis tout le fil d'e-mails. Vérifiez le titre, le résumé, les libellés, les assignés et le dépôt avant de créer le ticket lorsque la création manuelle est utilisée.
ReplyRabbit peut aussi ajouter le contexte du fil d'e-mails en tant que commentaire d'issue GitHub, afin que l'équipe d'ingénierie dispose des détails du client sans demander au support de recoller le même fil.
Gardez les conversations et les tickets synchronisés
Une fois une issue liée, la conversation FreeScout peut afficher l'identifiant, le titre, l'état, les étiquettes et les assignés actuels de l'issue GitHub. Les agents peuvent ouvrir l'issue dans GitHub lorsqu'ils ont besoin de la vue d'ingénierie complète.
ReplyRabbit prend également en charge une boucle d'achèvement : il vérifie les tickets GitHub liés selon un calendrier, généralement toutes les 5 minutes. Lorsque GitHub ferme un ticket, ReplyRabbit peut aider à rédiger le suivi client afin que le support puisse clôturer la conversation avec le contexte. Si votre équipe utilise les raisons de fermeture GitHub, vous pouvez limiter les brouillons d'achèvement aux tickets fermés comme terminés.
Dépannage
| Symptôme | Ce qu'il faut vérifier |
|---|---|
| Les dépôts ne se chargent pas | Confirmez que le jeton est à jour et qu'il peut accéder aux dépôts GitHub sélectionnés. |
| Les tickets ne sont pas créés | Confirmez que GitHub est l'outil de suivi des tickets sélectionné, qu'un dépôt par défaut 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é. |
| Le dépôt est incorrect ou manquant | Confirmez que le routage de dépôt ou les mappages de domaine sont configurés. ReplyRabbit utilise le dépôt par défaut lorsqu'il n'y a pas de correspondance fiable. |
| Les étiquettes ou les assignés ne seront pas mis à jour | Rechargez la conversation, puis confirmez que le jeton a toujours accès au dépôt lié. |
| GitHub renvoie des erreurs de limite de débit | Attendez la réinitialisation de la limite de l'API GitHub du token, puis envisagez de restreindre l'accès aux dépôts ou de réduire l'activité automatisée sur les tickets. |
| Les tickets fermés ne génèrent pas de brouillons | Confirmer Brouillon automatique à la clôture est activé et, si le mode terminé uniquement est activé, le ticket GitHub a été fermé comme terminé. |
Pour des corrections plus larges, voir Dépannage de ReplyRabbit.
Confidentialité et traitement des données
ReplyRabbit envoie à GitHub le contenu d'issue nécessaire au transfert vers l'ingénierie. Cela peut inclure le contexte client pertinent, le titre d'issue généré, le résumé généré, les labels, les assignés et le lien ou l'identifiant de la conversation FreeScout.
Ne mettez pas d'informations sensibles dans un problème GitHub, sauf si le dépôt est autorisé à les recevoir. Si les données clients doivent rester entièrement sur votre propre serveur, laissez GitHub désactivé pour cette boîte aux lettres.
Étapes suivantes
- Continuer avec Comment configurer ReplyRabbit si la boîte aux lettres a encore besoin des paramètres de fournisseur, de contexte ou de style.
- Lire Intégration Slack si votre équipe souhaite des notifications de création ou d'achèvement de tickets dans Slack.
- Comparer avec Intégration Linear si vous décidez quel outil de suivi des tickets une boîte aux lettres doit utiliser.
FAQ
Ai-je besoin d'un jeton d'accès personnel GitHub ?
Oui. ReplyRabbit se connecte à GitHub avec un token de votre propre compte ou organisation GitHub.
Une boîte aux lettres peut-elle utiliser Linear et GitHub en même temps ?
Non. Chaque boîte aux lettres choisit un seul outil de suivi de tickets : aucun, Linear ou GitHub.
ReplyRabbit peut-il choisir le dépôt GitHub ?
Oui, lorsque le routage de dépôt est configuré. ReplyRabbit prend en charge les mappages par domaine et la correspondance de dépôts par IA pour les dépôts auxquels votre jeton peut accéder.
Quel forfait inclut GitHub Issues ?
La création manuelle de tickets GitHub est une fonctionnalité Pro. La création automatique de tickets GitHub est une fonctionnalité Team.
ReplyRabbit envoie-t-il toute la conversation client à GitHub ?
ReplyRabbit envoie le contenu d'issue nécessaire au transfert vers l'ingénierie, y compris le contexte client pertinent et le résumé généré.