Integrazione GitHub Issues
Funziona con GitHub
Collega ReplyRabbit a GitHub Issues così le conversazioni di supporto in FreeScout possono diventare issue strutturate nel repository giusto. Gli agenti possono creare un'issue da una conversazione, mantenere l'issue collegata visibile in FreeScout e lasciare che ReplyRabbit prepari il passaggio all'ingegneria.
Cerchi la panoramica?
Panoramica
L'integrazione GitHub Issues aggiunge un pannello GitHub a ReplyRabbit in una conversazione FreeScout. Quando GitHub è configurato, ReplyRabbit può creare un ticket con un titolo adatto agli sviluppatori, un riepilogo utile, etichette, assegnatari, contesto del repository e un link alla conversazione di supporto.
Ogni casella di posta sceglie un sistema di tracciamento dei problemi: nessuno, Linear o GitHub. GitHub e Linear sono alternative per lo stesso flusso di lavoro dall'assistenza all'ingegneria, non due sistemi di tracciamento che funzionano insieme in una casella di posta.
La creazione manuale di problemi GitHub è disponibile su Pro e Team. La creazione automatica di problemi GitHub dalle nuove email dei clienti è disponibile su Team.
Prerequisiti
Prima di iniziare, assicurati di avere:
- Un'installazione FreeScout funzionante.
- ReplyRabbit installato e attivato.
- Un piano ReplyRabbit che include la funzionalità GitHub che vuoi usare.
- Accesso a un account o organizzazione GitHub in cui creare i ticket.
- Un repository con GitHub Issues abilitato.
Se ReplyRabbit non è ancora installato, inizia con Come installare il modulo ReplyRabbit, poi completa Come configurare ReplyRabbit.
Autorizzazioni e scope dei token
ReplyRabbit si collega a GitHub con un personal access token che fornisci nelle impostazioni della casella. Si consiglia un token a granularità fine, limitato ai repository che ReplyRabbit deve usare. Puoi crearne uno da Impostazioni del token a grana fine di GitHub.
Concedi al token accesso sufficiente per leggere i metadati del repository, leggere etichette e assegnatari, creare e aggiornare problemi e aggiungere commenti ai problemi. Per un token a grana fine, inizia con Metadati: lettura, Contenuti: lettura, e Issue: lettura e scrittura per i repository selezionati.
Per tracce di audit più rigorose, crea il token da un account bot GitHub dedicato che abbia accesso solo ai repository che ReplyRabbit deve usare.
Mantieni privato il token. Se il token viene ruotato o rimosso in GitHub, aggiorna le impostazioni della casella di posta prima di creare altre issue.
Collega GitHub Issues
Apri le impostazioni della casella di posta
In FreeScout, apri la casella che deve creare issue GitHub, poi apri Impostazioni e scegli ReplyRabbit.Scegli GitHub come issue tracker
Nel selettore dell'issue tracker, scegli GitHub Issues. ReplyRabbit mostra le impostazioni GitHub e nasconde le impostazioni Linear per quella casella di posta.Incolla il token
Incolla il tuo Token di accesso personale GitHub. Se hai già salvato un token, ReplyRabbit mostra un'anteprima mascherata invece del segreto completo.Carica i repository
Clicca il pulsante per caricare i repository da GitHub, poi scegli il repository predefinito in cui creare i nuovi ticket.Salva impostazioni
Salva le impostazioni della casella. ReplyRabbit memorizza la connessione GitHub per quella casella.
Configura i valori predefiniti
Dopo che il repository predefinito è selezionato, configura i valori predefiniti dei ticket da cui i tuoi agenti devono partire:
- Repository predefinito: scegli dove vengono create le issue quando nessuna regola di routing corrisponde.
- Invio automatico delle issue: nel livello Team, lascia che ReplyRabbit crei automaticamente issue GitHub quando il risultato del triage indica che serve lavoro di ingegneria.
- Instradamento dei repository: attiva la selezione automatica del repository quando vuoi che ReplyRabbit associ le conversazioni ai repository disponibili.
- Mappature dei domini: mappa i domini email dei clienti su repository specifici quando hai bisogno di un instradamento deterministico.
- Etichette: scegli le etichette che ReplyRabbit può applicare per tipo di issue, priorità o altri tag di workflow.
- Etichette di priorità: mappa i livelli di priorità di ReplyRabbit sulle etichette GitHub, poiché GitHub Issues non ha un campo priorità nativo.
- Assegnatario predefinito: scegli l'utente GitHub che deve ricevere le nuove issue per impostazione predefinita.
- Avviso di revisione: quando la creazione automatica delle segnalazioni è abilitata, aggiungi una nota di FreeScout che informa gli agenti che la segnalazione è stata creata automaticamente e deve essere revisionata.
L'instradamento dei repository è opzionale. Se nessun repository viene abbinato con certezza, ReplyRabbit usa il repository predefinito.
Crea un'issue GitHub da una conversazione FreeScout
Apri una conversazione in una casella di posta in cui GitHub è configurato. Il pannello ReplyRabbit può creare una issue GitHub dal thread del cliente, poi mostrare la issue collegata in FreeScout.
Il contenuto della segnalazione è generato per un passaggio di consegne all'engineering, non copiato ciecamente dall'intero thread email. Rivedi titolo, riepilogo, etichette, assegnatari e repository prima di creare la segnalazione quando si usa la creazione manuale.
ReplyRabbit può anche aggiungere il contesto del thread email come commento a una issue GitHub, così l'ingegneria ha i dettagli del cliente senza chiedere al supporto di incollare di nuovo lo stesso thread.
Mantieni conversazioni e issue sincronizzate
Una volta collegata una issue, la conversazione FreeScout può mostrare l'identificatore, il titolo, lo stato, le etichette e gli assegnatari attuali della issue GitHub. Gli agenti possono aprire la issue in GitHub quando hanno bisogno della vista completa di ingegneria.
ReplyRabbit supporta anche un ciclo di completamento: controlla le issue GitHub collegate secondo una pianificazione, in genere ogni 5 minuti. Quando GitHub chiude una issue, ReplyRabbit può aiutare a redigere il follow-up per il cliente così il supporto può chiudere la conversazione con contesto. Se il tuo team usa i motivi di chiusura di GitHub, puoi limitare le bozze di completamento alle issue chiuse come completate.
Risoluzione dei problemi
| Sintomo | Cosa controllare |
|---|---|
| I repository non si caricano | Conferma che il token sia valido e possa accedere ai repository GitHub selezionati. |
| Le issue non vengono create | Conferma che GitHub sia l'issue tracker selezionato, che sia selezionato un repository predefinito e che il tuo piano ReplyRabbit includa la funzionalità. |
| Le issue automatiche non vengono create | Conferma di essere sul piano Team e Invio automatico delle issue è abilitato. |
| Il repository è errato o mancante | Conferma che l'instradamento dei repository o le mappature dei domini siano configurati. ReplyRabbit usa il repository predefinito quando non c'è una corrispondenza affidabile. |
| Etichette o assegnatari non si aggiorneranno | Ricarica la conversazione, poi conferma che il token abbia ancora accesso al repository collegato. |
| GitHub restituisce errori di limite di frequenza | Attendi il ripristino del limite API GitHub del token, poi valuta di restringere l'accesso ai repository o di ridurre l'attività automatizzata sulle issue. |
| I ticket chiusi non generano bozze | Conferma Bozza automatica su Done è abilitato e, se la modalità solo completati è attiva, l'issue GitHub è stata chiusa come completata. |
Per correzioni più ampie, vedi Risoluzione dei problemi di ReplyRabbit.
Privacy e gestione dei dati
ReplyRabbit invia a GitHub il contenuto del problema necessario per il passaggio al reparto tecnico. Ciò può includere il contesto pertinente del cliente, il titolo del problema generato, il riepilogo generato, etichette, assegnatari e il link o l'identificatore della conversazione FreeScout.
Non inserire informazioni sensibili in un problema GitHub a meno che il repository non sia autorizzato a riceverle. Se i dati dei clienti devono rimanere interamente sul tuo server, mantieni GitHub disabilitato per quella casella di posta.
Prossimi passi
- Continua con Come configurare ReplyRabbit se la casella richiede ancora impostazioni di provider, contesto o stile.
- Leggi Integrazione Slack se il tuo team vuole la creazione di issue o le notifiche di completamento in Slack.
- Confronta con Integrazione Linear se stai decidendo quale issue tracker dovrebbe usare una casella.
FAQ
Serve un token di accesso personale GitHub?
Sì. ReplyRabbit si connette a GitHub con un token del tuo account o della tua organizzazione GitHub.
Una casella di posta può usare Linear e GitHub contemporaneamente?
No. Ogni casella di posta sceglie un solo issue tracker: nessuno, Linear o GitHub.
ReplyRabbit può scegliere il repository GitHub?
Sì, quando è configurato l'instradamento dei repository. ReplyRabbit supporta mappature dei domini e la corrispondenza AI dei repository per i repository a cui il tuo token può accedere.
Quale piano include GitHub Issues?
La creazione manuale di problemi GitHub è una funzionalità Pro. La creazione automatica di problemi GitHub è una funzionalità Team.
ReplyRabbit invia l'intera conversazione del cliente a GitHub?
ReplyRabbit invia il contenuto del problema necessario per il passaggio al reparto tecnico, incluso il contesto pertinente del cliente e il riepilogo generato.