GitHub Issues-integration
Fungerar med GitHub
Anslut ReplyRabbit till GitHub Issues så att supportkonversationer i FreeScout kan bli strukturerade ärenden i rätt repository. Agenter kan skapa ett ärende från en konversation, hålla det länkade ärendet synligt i FreeScout och låta ReplyRabbit förbereda överlämningen till utvecklingsteamet.
Letar du efter översikten?
Översikt
GitHub Issues-integrationen lägger till en GitHub-panel i ReplyRabbit i en FreeScout-konversation. När GitHub är konfigurerat kan ReplyRabbit skapa ett ärende med en utvecklarvänlig titel, en användbar sammanfattning, etiketter, tilldelade personer, arkivkontext och en länk tillbaka till supportkonversationen.
Varje brevlåda väljer en ärendehanterare: ingen, Linear eller GitHub. GitHub och Linear är alternativ för samma arbetsflöde från support till ingenjörsarbete, inte två hanterare som körs tillsammans i en brevlåda.
Manuell skapande av GitHub-ärenden är tillgängligt på Pro och Team. Automatiskt skapande av GitHub-ärenden från nya kundmeddelanden är tillgängligt på Team.
Förutsättningar
Innan du börjar, se till att du har:
- En fungerande FreeScout-installation.
- ReplyRabbit installerat och aktiverat.
- En ReplyRabbit-plan som inkluderar den GitHub-funktion du vill använda.
- Åtkomst till ett GitHub-konto eller en organisation där ärenden ska skapas.
- Ett arkiv med GitHub Issues aktiverat.
Om ReplyRabbit inte är installerat än, börja med Hur du installerar ReplyRabbit-modulen, sedan slutför Hur du konfigurerar ReplyRabbit.
Behörigheter och tokenomfattning
ReplyRabbit ansluter till GitHub med en personlig åtkomsttoken som du anger i brevlådans inställningar. En finkornig token rekommenderas, begränsad till de arkiv som ReplyRabbit ska använda. Du kan skapa en från GitHubs inställningar för finkorniga token.
Ge token tillräcklig åtkomst för att läsa repositoriemetadata, läsa etiketter och tilldelade, skapa och uppdatera ärenden och lägga till ärendekommentarer. För en finkornig token, börja med Metadata: läs, Innehåll: läs, och Ärenden: läs och skriv för de valda arkiven.
För striktare granskningsspår, skapa token från ett dedikerat GitHub-botkonto som bara har åtkomst till de repositorier ReplyRabbit ska använda.
Håll token privat. Om token roteras eller tas bort i GitHub, uppdatera brevlådeinställningarna innan du skapar fler ärenden.
Anslut GitHub Issues
Öppna brevlådans inställningar
I FreeScout, öppna brevlådan som ska skapa GitHub-ärenden och öppna sedan Inställningar och välj ReplyRabbit.Välj GitHub som ärendehanterare
I väljaren för ärendehanteringssystem, välj GitHub Issues. ReplyRabbit visar GitHub-inställningarna och döljer Linear-inställningarna för den brevlådan.Klistra in token
Klistra in din GitHub Personal Access Token. Om du redan har sparat en token visar ReplyRabbit en maskerad förhandsvisning istället för hela hemligheten.Läs in databaser
Klicka på knappen för att läsa in datalager från GitHub och välj sedan standarddatalagret där nya ärenden ska skapas.Spara inställningar
Spara mailboxinställningarna. ReplyRabbit lagrar GitHub-anslutningen för den mailboxen.
Konfigurera standardvärden
När standardarkivet är valt konfigurerar du ärendets standardvärden som dina agenter ska utgå från:
- Standardförråd: välj var ärenden skapas när ingen dirigeringsregel matchar.
- Skicka ärenden automatiskt: på Team-nivån, låt ReplyRabbit automatiskt skapa GitHub-ärenden när triageringsresultatet säger att teknikarbete behövs.
- Repository-routing: aktivera automatiskt arkivval när du vill att ReplyRabbit ska matcha konversationer mot tillgängliga arkiv.
- Domänmappningar: mappa kunders e-postdomäner till specifika arkiv när du behöver deterministisk routning.
- Etiketter: välj etiketter som ReplyRabbit kan tillämpa för ärendetyp, prioritet eller andra arbetsflödestaggar.
- Prioritetsetiketter: mappa ReplyRabbits prioritetsnivåer till GitHub-etiketter, eftersom GitHub Issues inte har något inbyggt prioritetsfält.
- Standardtilldelad: välj den GitHub-användare som som standard ska ta emot nya ärenden.
- Granskningsmeddelande: när automatiskt ärende skapande är aktiverat, lägg till en FreeScout anteckning som talar om för agenter att ärendet skapades automatiskt och bör granskas.
Repository-routing är valfritt. Om inget repository matchas med säkerhet använder ReplyRabbit standard-repositoryt.
Skapa ett GitHub-ärende från en FreeScout-konversation
Öppna en konversation i en brevlåda där GitHub är konfigurerat. ReplyRabbit-panelen kan skapa ett GitHub-ärende från kundtråden och sedan visa det länkade ärendet i FreeScout.
Ärendeinnehållet genereras för en överlämning till ingenjörer, inte kopierat blint från hela e-posttråden. Granska titel, sammanfattning, etiketter, tilldelade och arkiv innan du skapar ärendet när manuell skapning används.
ReplyRabbit kan även lägga till e-posttrådens kontext som en kommentar i GitHub-ärendet, så att ingenjörsteamet har kunduppgifterna utan att behöva be supporten klistra in samma tråd igen.
Håll konversationer och ärenden i synk
När ett ärende är länkat kan FreeScout-konversationen visa aktuell GitHub-ärendeidentifierare, titel, status, etiketter och tilldelade. Agenter kan öppna ärendet i GitHub när de behöver den fullständiga tekniska vyn.
ReplyRabbit stöder också en slutförandeloop: den kontrollerar länkade GitHub-ärenden enligt ett schema, vanligtvis var 5:e minut. När GitHub stänger ett ärende kan ReplyRabbit hjälpa till att skriva kunduppföljningen så att supporten kan stänga konversationen med kontext. Om ditt team använder stängningsorsaker i GitHub kan du begränsa slutförandeutkast till ärenden som stängts som completed.
Felsökning
| Symptom | Vad man ska kontrollera |
|---|---|
| Repositories läses inte in | Bekräfta att token är aktuell och kan komma åt de valda GitHub-repositorierna. |
| Ärenden skapas inte | Bekräfta att GitHub är den valda ärendehanteraren, att ett standarddatalager är valt och att din ReplyRabbit-plan inkluderar funktionen. |
| Automatiska ärenden skapas inte | Bekräfta att du är på Team-nivån och Skicka ärenden automatiskt är aktiverad. |
| Repository är fel eller saknas | Bekräfta att datalager-routing eller domänmappningar är konfigurerade. ReplyRabbit använder standarddatalagret när det inte finns någon säker matchning. |
| Etiketter eller tilldelade uppdateras inte | Läs in konversationen igen och bekräfta sedan att token fortfarande har åtkomst till det länkade arkivet. |
| GitHub returnerar fel för hastighetsbegränsning | Vänta tills tokens GitHub API-gräns återställs och överväg sedan att begränsa repositorieåtkomsten eller minska den automatiska ärendeaktiviteten. |
| Stängda ärenden genererar inga utkast | Bekräfta Automatiskt utkast vid Klar är aktiverad och, om läget endast slutförda är på, GitHub-ärendet stängdes som slutfört. |
För bredare åtgärder, se Felsökning av ReplyRabbit.
Integritet och datahantering
ReplyRabbit skickar det ärende-innehåll till GitHub som behövs för överlämningen till ingenjörsteamet. Det kan inkludera relevant kundkontext, den genererade ärendetiteln, den genererade sammanfattningen, etiketter, tilldelade och FreeScout-konversationens länk eller identifierare.
Lägg inte känslig information i ett GitHub-ärende om inte förrådet är tillåtet att ta emot den. Om kunddata måste stanna helt på din egen server, håll GitHub inaktiverat för den brevlådan.
Nästa steg
- Fortsätt med Hur du konfigurerar ReplyRabbit om mailboxen fortfarande behöver leverantörs-, kontext- eller stilinställningar.
- Läs Slack-integration om ditt team vill ha ärendeskapande eller slutförandeaviseringar i Slack.
- Jämför med Linear-integration om du bestämmer vilket ärendehanteringssystem en mailbox ska använda.
Vanliga frågor
Behöver jag en personlig åtkomsttoken för GitHub?
Ja. ReplyRabbit ansluter till GitHub med en token från ditt eget GitHub-konto eller din organisation.
Kan en brevlåda använda Linear och GitHub samtidigt?
Nej. Varje brevlåda väljer en ärendehanterare: ingen, Linear eller GitHub.
Kan ReplyRabbit välja GitHub-förrådet?
Ja, när arkivstyrning är konfigurerad. ReplyRabbit stöder domänmappningar och AI-arkivmatchning för arkiv som din token kan komma åt.
Vilken plan inkluderar GitHub Issues?
Manuell skapande av GitHub-ärenden är en Pro-funktion. Automatiskt skapande av GitHub-ärenden är en Team-funktion.
Skickar ReplyRabbit hela kundkonversationen till GitHub?
ReplyRabbit skickar det ärende-innehåll som behövs för överlämningen till ingenjörsteamet, inklusive relevant kundkontext och den genererade sammanfattningen.