GitHub Issues-integration
Virker med GitHub
Tilslut ReplyRabbit til GitHub Issues, så support-samtaler i FreeScout kan blive strukturerede issues i det rigtige repository. Agenter kan oprette et issue fra en samtale, holde det linkede issue synligt i FreeScout og lade ReplyRabbit forberede engineering-overdragelsen.
Leder du efter oversigten?
Oversigt
GitHub Issues-integrationen tilføjer et GitHub-panel til ReplyRabbit i en FreeScout-samtale. Når GitHub er konfigureret, kan ReplyRabbit oprette et issue med en udviklervenlig titel, et brugbart resumé, labels, assignees, repository-kontekst og et link tilbage til supportsamtalen.
Hver postkasse vælger én issue tracker: ingen, Linear eller GitHub. GitHub og Linear er alternativer til den samme support-til-ingeniørarbejde-arbejdsgang, ikke to trackere, der kører sammen i én postkasse.
Manuel oprettelse af GitHub-sager er tilgængelig på Pro og Team. Automatisk oprettelse af GitHub-sager fra nye kunde-e-mails er tilgængelig på Team.
Forudsætninger
Før du starter, skal du sikre dig, at du har:
- En fungerende FreeScout-installation.
- ReplyRabbit installeret og aktiveret.
- En ReplyRabbit-plan, der inkluderer den GitHub-funktion, du vil bruge.
- Adgang til en GitHub-konto eller organisation, hvor sager skal oprettes.
- Et repository med GitHub Issues aktiveret.
Hvis ReplyRabbit ikke er installeret endnu, skal du starte med Sådan installerer du ReplyRabbit-modulet, derefter afslut Sådan opsætter du ReplyRabbit.
Tilladelser og token-scope
ReplyRabbit forbinder til GitHub med et personal access token, som du angiver i postkasseindstillingerne. Et fine-grained token anbefales, begrænset til de repositories, ReplyRabbit skal bruge. Du kan oprette et fra GitHubs indstillinger for fine-grained tokens.
Giv tokenet nok adgang til at læse repository-metadata, læse labels og assignees, oprette og opdatere issues og tilføje issuekommentarer. For et fine-grained token skal du starte med Metadata: læs, Indhold: læs, og Sager: læs og skriv for de valgte repositories.
For strengere revisionsspor skal du oprette tokenet fra en dedikeret GitHub-botkonto, der kun har adgang til de repositories, ReplyRabbit skal bruge.
Hold tokenet privat. Hvis tokenet roteres eller fjernes i GitHub, skal du opdatere mailboksindstillingerne, før du opretter flere sager.
Tilslut GitHub Issues
Åbn postkasseindstillingerne
I FreeScout skal du åbne den postkasse, der skal oprette GitHub-issues, og derefter åbne Indstillinger og vælg ReplyRabbit.Vælg GitHub som issue tracker
I vælgeren for issue-tracker skal du vælge GitHub Issues. ReplyRabbit viser GitHub-indstillingerne og skjuler Linear-indstillingerne for den postkasse.Indsæt tokenet
Indsæt din GitHub Personal Access Token. Hvis du allerede har gemt et token, viser ReplyRabbit en maskeret forhåndsvisning i stedet for den fulde hemmelighed.Indlæs repositories
Klik på knappen for at indlæse repositories fra GitHub, og vælg derefter det standard-repository, hvor nye sager skal oprettes.Gem indstillinger
Gem postkasseindstillingerne. ReplyRabbit gemmer GitHub-forbindelsen for den postkasse.
Konfigurer standarder
Når standard-repositoryet er valgt, skal du konfigurere sagens standarder, dine agenter skal starte fra:
- Standardrepository: vælg, hvor sager oprettes, når ingen routingregel matcher.
- Auto-indsend issues: på Team-niveauet, lad ReplyRabbit automatisk oprette GitHub-issues, når triageresultatet siger, at der er brug for udviklingsarbejde.
- Repository-routing: aktivér automatisk repository-valg, når du vil have ReplyRabbit til at matche samtaler med tilgængelige repositories.
- Domænemappinger: map kunde-e-maildomæner til bestemte repositories, når du har brug for deterministisk routing.
- Mærkater: vælg labels, som ReplyRabbit kan anvende til sagstype, prioritet eller andre workflow-tags.
- Prioritetsetiketter: map ReplyRabbit-prioritetsniveauer til GitHub-labels, da GitHub Issues ikke har et indbygget prioritetsfelt.
- Standardtildelt: vælg den GitHub-bruger, der som standard skal modtage nye sager.
- Gennemgangsbemærkning: når automatisk oprettelse af sager er aktiveret, tilføj en FreeScout-note, der fortæller agenter, at sagen blev oprettet automatisk og bør gennemgås.
Repository-routing er valgfri. Hvis intet repository matches med sikkerhed, bruger ReplyRabbit standard-repositoryet.
Opret et GitHub-issue fra en FreeScout-samtale
Åbn en samtale i en postkasse, hvor GitHub er konfigureret. ReplyRabbit-panelet kan oprette et GitHub-issue fra kundetråden og derefter vise det linkede issue i FreeScout.
Sagens indhold genereres til en ingeniøroverdragelse, ikke blindt kopieret fra hele e-mailtråden. Gennemgå titel, resumé, labels, tildelte og repository, før sagen oprettes, når manuel oprettelse bruges.
ReplyRabbit kan også tilføje e-mailtrådens kontekst som en GitHub-issue-kommentar, så engineering har kundedetaljerne uden at bede support om at indsætte den samme tråd igen.
Hold samtaler og sager synkroniseret
Når et issue er linket, kan FreeScout-samtalen vise den aktuelle GitHub-issue-identifikator, titel, tilstand, labels og assignees. Agenter kan åbne issuet i GitHub, når de har brug for den fulde engineering-visning.
ReplyRabbit understøtter også en afslutningsloop: den tjekker linkede GitHub-issues efter en tidsplan, typisk hvert 5. minut. Når GitHub lukker et issue, kan ReplyRabbit hjælpe med at udarbejde kundeopfølgningen, så support kan lukke samtalen med kontekst. Hvis dit team bruger GitHub-lukkegrunde, kan du begrænse afslutningsudkast til issues lukket som completed.
Fejlfinding
| Symptom | Hvad du skal kontrollere |
|---|---|
| Repositories indlæses ikke | Bekræft, at tokenet er gyldigt og har adgang til de valgte GitHub-repositorier. |
| Sager oprettes ikke | Bekræft, at GitHub er den valgte issue tracker, at et standard-repository er valgt, og at din ReplyRabbit-plan inkluderer funktionen. |
| Automatiske issues oprettes ikke | Bekræft, at du er på Team-niveauet, og Auto-indsend issues er aktiveret. |
| Repository er forkert eller mangler | Bekræft, at repository-routing eller domæne-mappings er konfigureret. ReplyRabbit bruger standard-repositoryet, når der ikke er et sikkert match. |
| Mærkater eller tildelte opdateres ikke | Genindlæs samtalen, og bekræft derefter, at tokenet stadig har adgang til det linkede repository. |
| GitHub returnerer rate limit-fejl | Vent på, at tokenets GitHub API-grænse nulstilles, og overvej derefter at indsnævre repository-adgangen eller reducere automatiseret sagsaktivitet. |
| Lukkede sager genererer ikke udkast | Bekræft Auto-udkast ved Fuldført er aktiveret, og hvis tilstanden kun-fuldførte er slået til, blev GitHub-issuet lukket som fuldført. |
For bredere rettelser, se Fejlfinding af ReplyRabbit.
Privatliv og datahåndtering
ReplyRabbit sender GitHub det issue-indhold, der er nødvendigt for engineering-overleveringen. Det kan omfatte relevant kundekontekst, den genererede issue-titel, det genererede resumé, labels, assignees og FreeScout-samtalelinket eller -identifikatoren.
Læg ikke følsomme oplysninger i et GitHub-emne, medmindre repositoryet har tilladelse til at modtage dem. Hvis kundedata skal forblive helt på din egen server, skal GitHub være deaktiveret for den postkasse.
Næste trin
- Fortsæt med Sådan opsætter du ReplyRabbit hvis postkassen stadig mangler udbyder-, kontekst- eller stilindstillinger.
- Læs Slack-integration hvis dit team ønsker oprettelse af issues eller fuldførelsesnotifikationer i Slack.
- Sammenlign med Linear-integration hvis du beslutter, hvilket issue-tracker-system en postkasse skal bruge.
FAQ
Har jeg brug for et GitHub personal access token?
Ja. ReplyRabbit forbinder til GitHub med et token fra din egen GitHub-konto eller organisation.
Kan én postkasse bruge Linear og GitHub samtidig?
Nej. Hver postkasse vælger ét issue tracker: ingen, Linear eller GitHub.
Kan ReplyRabbit vælge GitHub-repositoriet?
Ja, når repository-routing er konfigureret. ReplyRabbit understøtter domænemappinger og AI-repositorymatchning for repositories, som dit token kan få adgang til.
Hvilken plan inkluderer GitHub Issues?
Manuel oprettelse af GitHub-sager er en Pro-funktion. Automatisk oprettelse af GitHub-sager er en Team-funktion.
Sender ReplyRabbit hele kundesamtalen til GitHub?
ReplyRabbit sender det issue-indhold, der er nødvendigt for engineering-overleveringen, herunder relevant kundekontekst og det genererede resumé.