GitHub Issues-integratie
Werkt met GitHub
Verbind ReplyRabbit met GitHub Issues zodat supportgesprekken in FreeScout gestructureerde issues in de juiste repository kunnen worden. Agenten kunnen een issue aanmaken vanuit een gesprek, het gekoppelde issue zichtbaar houden in FreeScout en ReplyRabbit de engineering-overdracht laten voorbereiden.
Op zoek naar het overzicht?
Overzicht
De GitHub Issues-integratie voegt een GitHub-paneel toe aan ReplyRabbit in een FreeScout-gesprek. Wanneer GitHub is geconfigureerd, kan ReplyRabbit een issue aanmaken met een ontwikkelaarsvriendelijke titel, een nuttige samenvatting, labels, toegewezen personen, repositorycontext en een link terug naar het supportgesprek.
Elke mailbox kiest één issuetracker: geen, Linear of GitHub. GitHub en Linear zijn alternatieven voor dezelfde support-naar-engineering-workflow, niet twee trackers die samen in één mailbox draaien.
Handmatig GitHub-issues aanmaken is beschikbaar op Pro en Team. Automatisch GitHub-issues aanmaken op basis van nieuwe klant-e-mails is beschikbaar op Team.
Vereisten
Voordat je begint, zorg dat je het volgende hebt:
- Een werkende FreeScout-installatie.
- ReplyRabbit geïnstalleerd en geactiveerd.
- Een ReplyRabbit-abonnement dat de GitHub-functie bevat die je wilt gebruiken.
- Toegang tot een GitHub-account of -organisatie waar issues moeten worden aangemaakt.
- Een repository met GitHub Issues ingeschakeld.
Als ReplyRabbit nog niet is geïnstalleerd, begin dan met Hoe je de ReplyRabbit-module installeert, en voltooi dan Hoe je ReplyRabbit instelt.
Machtigingen en tokenscope
ReplyRabbit verbindt met GitHub via een persoonlijk toegangstoken dat je opgeeft in de mailboxinstellingen. Een fijnmazig token wordt aanbevolen, beperkt tot de repositories die ReplyRabbit mag gebruiken. Je kunt er een aanmaken via Fijnmazige tokeninstellingen van GitHub.
Geef de token voldoende toegang om repositorymetadata te lezen, labels en assignees te lezen, issues aan te maken en bij te werken, en issueopmerkingen toe te voegen. Begin voor een fijnmazige token met Metadata: lezen, Inhoud: lezen, en Issues: lezen en schrijven voor de geselecteerde repositories.
Maak voor striktere audittrails het token aan vanuit een speciaal GitHub-botaccount dat alleen toegang heeft tot de repositories die ReplyRabbit mag gebruiken.
Houd het token privé. Als het token in GitHub wordt geroteerd of verwijderd, werk dan de mailboxinstellingen bij voordat je meer issues aanmaakt.
GitHub Issues verbinden
Open de mailboxinstellingen
Open in FreeScout de mailbox die GitHub-issues moet aanmaken en open dan Instellingen en kies ReplyRabbit.Kies GitHub als de issue-tracker
Kies in de issue tracker-selector GitHub Issues. ReplyRabbit toont de GitHub-instellingen en verbergt de Linear-instellingen voor die mailbox.Plak het token
Plak je GitHub Personal Access Token. Als je al een token hebt opgeslagen, toont ReplyRabbit een gemaskeerd voorbeeld in plaats van het volledige geheim.Repositories laden
Klik op de knop om repositories van GitHub te laden en kies vervolgens de standaardrepository waar nieuwe issues moeten worden aangemaakt.Instellingen opslaan
Sla de mailboxinstellingen op. ReplyRabbit slaat de GitHub-verbinding voor die mailbox op.
Standaardwaarden configureren
Nadat de standaardrepository is geselecteerd, configureer je de issue-standaardwaarden waar je agents mee moeten beginnen:
- Standaardrepository: kies waar issues worden aangemaakt wanneer geen routeringsregel overeenkomt.
- Issues automatisch indienen: op de Team-tier, laat ReplyRabbit automatisch GitHub-issues aanmaken wanneer het triageresultaat zegt dat engineeringwerk nodig is.
- Repository-routering: schakel automatische repositoryselectie in wanneer je wilt dat ReplyRabbit gesprekken aan beschikbare repositories koppelt.
- Domeintoewijzingen: koppel e-maildomeinen van klanten aan specifieke repositories wanneer je deterministische routering nodig hebt.
- Labels: kies labels die ReplyRabbit kan toepassen voor issue type, prioriteit of andere workflow-tags.
- Prioriteitslabels: koppel ReplyRabbit-prioriteitsniveaus aan GitHub-labels, omdat GitHub Issues geen native prioriteitsveld heeft.
- Standaard toegewezene: kies de GitHub-gebruiker die standaard nieuwe issues moet ontvangen.
- Beoordelingsmelding: wanneer automatisch aanmaken van issues is ingeschakeld, voeg een FreeScout-notitie toe die medewerkers vertelt dat het issue automatisch is aangemaakt en beoordeeld moet worden.
Repository-routering is optioneel. Als er geen repository met zekerheid wordt gematcht, gebruikt ReplyRabbit de standaardrepository.
Maak een GitHub-issue aan vanuit een FreeScout-gesprek
Open een gesprek in een mailbox waar GitHub is geconfigureerd. Het ReplyRabbit-paneel kan een GitHub-issue aanmaken vanuit de klantthread en vervolgens het gekoppelde issue in FreeScout tonen.
De issue-inhoud wordt gegenereerd voor een engineeringoverdracht, niet blind gekopieerd uit de hele e-mailthread. Controleer de titel, samenvatting, labels, toegewezen personen en repository voordat je de issue aanmaakt bij handmatige creatie.
ReplyRabbit kan ook de context van de e-mailthread toevoegen als opmerking bij een GitHub-issue, zodat engineering de klantgegevens heeft zonder support te vragen dezelfde thread opnieuw te plakken.
Houd gesprekken en issues synchroon
Zodra een issue is gekoppeld, kan het FreeScout-gesprek de huidige GitHub-issue-identificatie, titel, status, labels en toegewezen personen tonen. Agenten kunnen het issue in GitHub openen wanneer ze de volledige technische weergave nodig hebben.
ReplyRabbit ondersteunt ook een afrondingslus: het controleert gekoppelde GitHub-issues volgens een schema, doorgaans elke 5 minuten. Wanneer GitHub een issue sluit, kan ReplyRabbit helpen de klantopvolging op te stellen zodat support het gesprek met context kan sluiten. Als je team GitHub-sluitingsredenen gebruikt, kun je afrondingsconcepten beperken tot issues die als voltooid zijn gesloten.
Probleemoplossing
| Symptoom | Wat te controleren |
|---|---|
| Repositories worden niet geladen | Bevestig dat het token actueel is en toegang heeft tot de geselecteerde GitHub-repositories. |
| Issues worden niet aangemaakt | Bevestig dat GitHub de geselecteerde issue-tracker is, een standaardrepository is geselecteerd en je ReplyRabbit-plan de functie bevat. |
| Automatische issues worden niet aangemaakt | Bevestig dat je op het Team-niveau zit en Issues automatisch indienen is ingeschakeld. |
| Repository is onjuist of ontbreekt | Bevestig dat repositoryroutering of domeinmappings zijn geconfigureerd. ReplyRabbit gebruikt de standaardrepository wanneer er geen betrouwbare match is. |
| Labels of toegewezenen worden niet bijgewerkt | Herlaad het gesprek en bevestig dat het token nog toegang heeft tot de gekoppelde repository. |
| GitHub retourneert rate limit-fouten | Wacht tot de GitHub API-limiet van het token is gereset en overweeg dan de repositorytoegang te beperken of geautomatiseerde issue-activiteit te verminderen. |
| Gesloten issues genereren geen concepten | Bevestigen Auto-concept bij Done is ingeschakeld en, als de modus alleen-voltooid aan staat, het GitHub-issue is gesloten als voltooid. |
Voor bredere oplossingen, zie Probleemoplossing ReplyRabbit.
Privacy en gegevensverwerking
ReplyRabbit stuurt GitHub de issue-inhoud die nodig is voor de engineeringoverdracht. Dat kan relevante klantcontext, de gegenereerde issuetitel, de gegenereerde samenvatting, labels, assignees en de link of identifier van het FreeScout-gesprek omvatten.
Zet geen gevoelige informatie in een GitHub-issue tenzij de repository die mag ontvangen. Als klantgegevens volledig op uw eigen server moeten blijven, houd GitHub dan uitgeschakeld voor die mailbox.
Volgende stappen
- Ga verder met Hoe je ReplyRabbit instelt als de mailbox nog provider-, context- of stijlinstellingen nodig heeft.
- Lezen Slack-integratie als je team meldingen wil voor het aanmaken of voltooien van issues in Slack.
- Vergelijken met Linear-integratie als je beslist welke issuetracker een mailbox moet gebruiken.
FAQ
Heb ik een GitHub personal access token nodig?
Ja. ReplyRabbit maakt verbinding met GitHub met een token van je eigen GitHub-account of organisatie.
Kan één mailbox Linear en GitHub tegelijk gebruiken?
Nee. Elke mailbox kiest één issue tracker: geen, Linear of GitHub.
Kan ReplyRabbit de GitHub-repository kiezen?
Ja, wanneer repositoryroutering is geconfigureerd. ReplyRabbit ondersteunt domeintoewijzingen en AI-repositorymatching voor repositories waartoe je token toegang heeft.
Welk plan omvat GitHub Issues?
Handmatig GitHub-issues aanmaken is een Pro-functie. Automatisch GitHub-issues aanmaken is een Team-functie.
Stuurt ReplyRabbit het hele klantgesprek naar GitHub?
ReplyRabbit stuurt de issue-inhoud die nodig is voor de engineeringoverdracht, inclusief relevante klantcontext en de gegenereerde samenvatting.