GitHub Issues-Integration
Funktioniert mit GitHub
Verbinden Sie ReplyRabbit mit GitHub Issues, damit Support-Gespräche in FreeScout zu strukturierten Issues im richtigen Repository werden können. Agenten können ein Issue aus einem Gespräch erstellen, das verknüpfte Issue in FreeScout sichtbar halten und ReplyRabbit die Engineering-Übergabe vorbereiten lassen.
Suchen Sie die Übersicht?
Übersicht
Die GitHub-Issues-Integration fügt ReplyRabbit in einem FreeScout-Gespräch ein GitHub-Panel hinzu. Wenn GitHub konfiguriert ist, kann ReplyRabbit ein Issue mit einem entwicklerfreundlichen Titel, einer nützlichen Zusammenfassung, Labels, Zugewiesenen, Repository-Kontext und einem Link zurück zum Support-Gespräch erstellen.
Jedes Postfach wählt einen Issue-Tracker: keiner, Linear oder GitHub. GitHub und Linear sind Alternativen für denselben Support-zu-Engineering-Workflow, nicht zwei Tracker, die in einem Postfach zusammen laufen.
Die manuelle Erstellung von GitHub-Issues ist in Pro und Team verfügbar. Die automatische Erstellung von GitHub-Issues aus neuen Kunden-E-Mails ist in Team verfügbar.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:
- Eine funktionierende FreeScout-Installation.
- ReplyRabbit installiert und aktiviert.
- Ein ReplyRabbit-Plan, der die gewünschte GitHub-Funktion enthält.
- Zugriff auf ein GitHub-Konto oder eine Organisation, in der Issues erstellt werden sollen.
- Ein Repository mit aktivierten GitHub Issues.
Wenn ReplyRabbit noch nicht installiert ist, beginnen Sie mit So installieren Sie das ReplyRabbit-Modul, dann schließen Sie ab So richten Sie ReplyRabbit ein.
Berechtigungen und Token-Scope
ReplyRabbit verbindet sich mit GitHub über ein persönliches Zugriffstoken, das Sie in den Postfacheinstellungen angeben. Ein fein abgestuftes Token wird empfohlen, beschränkt auf die Repositories, die ReplyRabbit verwenden soll. Sie können eines erstellen unter GitHubs Einstellungen für fein abgestufte Tokens.
Geben Sie dem Token genügend Zugriff, um Repository-Metadaten zu lesen, Labels und Assignees zu lesen, Issues zu erstellen und zu aktualisieren und Issue-Kommentare hinzuzufügen. Beginnen Sie bei einem fein abgestuften Token mit Metadaten: Lesen, Inhalte: Lesen, und Issues: Lesen und Schreiben für die ausgewählten Repositories.
Für strengere Audit-Trails erstellen Sie das Token von einem dedizierten GitHub-Bot-Konto, das nur Zugriff auf die Repositories hat, die ReplyRabbit verwenden soll.
Halte das Token privat. Wenn das Token in GitHub rotiert oder entfernt wird, aktualisiere die Postfach-Einstellungen, bevor du weitere Issues erstellst.
GitHub Issues verbinden
Öffnen Sie die Postfacheinstellungen
Öffnen Sie in FreeScout das Postfach, das GitHub-Issues erstellen soll, und öffnen Sie dann Einstellungen und wählen Sie ReplyRabbit.GitHub als Issue-Tracker auswählen
Wählen Sie in der Issue-Tracker-Auswahl GitHub Issues. ReplyRabbit zeigt die GitHub-Einstellungen und blendet die Linear-Einstellungen für dieses Postfach aus.Fügen Sie das Token ein
Fügen Sie Ihren ein GitHub Personal Access Token. Wenn Sie bereits ein Token gespeichert haben, zeigt ReplyRabbit eine maskierte Vorschau statt des vollständigen Geheimnisses.Repositories laden
Auf die Schaltfläche klicken, um Repositories von GitHub zu laden, dann das Standard-Repository auswählen, in dem neue Vorgänge erstellt werden sollen.Einstellungen speichern
Speichere die Postfacheinstellungen. ReplyRabbit speichert die GitHub-Verbindung für dieses Postfach.
Standardeinstellungen konfigurieren
Nachdem das Standard-Repository ausgewählt ist, konfigurieren Sie die Issue-Standardwerte, mit denen Ihre Agenten beginnen sollen:
- Standard-Repository: wählen Sie, wo Issues erstellt werden, wenn keine Routing-Regel passt.
- Issues automatisch einreichen: im Team-Tarif lassen Sie ReplyRabbit automatisch GitHub-Issues erstellen, wenn das Triage-Ergebnis besagt, dass Engineering-Arbeit nötig ist.
- Repository-Routing: aktivieren Sie die automatische Repository-Auswahl, wenn ReplyRabbit Konversationen verfügbaren Repositories zuordnen soll.
- Domain-Zuordnungen: ordnen Sie Kunden-E-Mail-Domains bestimmten Repositories zu, wenn Sie deterministisches Routing benötigen.
- Labels: wählen Sie Labels, die ReplyRabbit für Issue-Typ, Priorität oder andere Workflow-Tags anwenden kann.
- Prioritätsbezeichnungen: ordnen Sie ReplyRabbit-Prioritätsstufen GitHub-Labels zu, da GitHub Issues kein natives Prioritätsfeld hat.
- Standard-Zugewiesener: wählen Sie den GitHub-Benutzer, der standardmäßig neue Issues erhalten soll.
- Prüfhinweis: wenn die automatische Issue-Erstellung aktiviert ist, fügen Sie eine FreeScout-Notiz hinzu, die Agenten darüber informiert, dass das Issue automatisch erstellt wurde und überprüft werden sollte.
Repository-Routing ist optional. Wenn kein Repository sicher zugeordnet wird, verwendet ReplyRabbit das Standard-Repository.
Ein GitHub-Issue aus einem FreeScout-Gespräch erstellen
Öffnen Sie eine Konversation in einem Postfach, in dem GitHub konfiguriert ist. Das ReplyRabbit-Panel kann aus dem Kunden-Thread ein GitHub-Issue erstellen und dann das verknüpfte Issue in FreeScout anzeigen.
Der Issue-Inhalt wird für eine Engineering-Übergabe generiert, nicht blind aus dem gesamten E-Mail-Thread kopiert. Überprüfe Titel, Zusammenfassung, Labels, Zugewiesene und Repository, bevor du das Issue erstellst, wenn die manuelle Erstellung verwendet wird.
ReplyRabbit kann den E-Mail-Thread-Kontext auch als GitHub-Issue-Kommentar hinzufügen, damit die Entwicklung die Kundendetails hat, ohne dass der Support denselben Thread erneut einfügen muss.
Halte Konversationen und Issues synchron
Sobald ein Issue verknüpft ist, kann die FreeScout-Konversation die aktuelle GitHub-Issue-Kennung, den Titel, den Status, die Labels und die Zugewiesenen anzeigen. Agenten können das Issue in GitHub öffnen, wenn sie die vollständige Engineering-Ansicht benötigen.
ReplyRabbit unterstützt auch eine Abschlussschleife: Es prüft verknüpfte GitHub-Issues nach einem Zeitplan, typischerweise alle 5 Minuten. Wenn GitHub ein Issue schließt, kann ReplyRabbit beim Entwerfen der Kunden-Nachverfolgung helfen, damit der Support die Konversation mit Kontext schließen kann. Wenn Ihr Team GitHub-Schließungsgründe verwendet, können Sie Abschlussentwürfe auf Issues beschränken, die als abgeschlossen geschlossen wurden.
Fehlerbehebung
| Symptom | Was zu prüfen ist |
|---|---|
| Repositories werden nicht geladen | Bestätigen Sie, dass das Token aktuell ist und auf die ausgewählten GitHub-Repositories zugreifen kann. |
| Issues werden nicht erstellt | Bestätigen, dass GitHub als Issue-Tracker ausgewählt ist, ein Standard-Repository ausgewählt ist und Ihr ReplyRabbit-Tarif die Funktion enthält. |
| Automatische Issues werden nicht erstellt | Bestätigen Sie, dass Sie im Team-Tarif sind und Issues automatisch einreichen ist aktiviert. |
| Repository ist falsch oder fehlt | Bestätigen, dass Repository-Routing oder Domain-Zuordnungen konfiguriert sind. ReplyRabbit verwendet das Standard-Repository, wenn es keine sichere Übereinstimmung gibt. |
| Labels oder Bearbeiter werden nicht aktualisiert | Laden Sie die Konversation neu und bestätigen Sie dann, dass das Token noch Zugriff auf das verknüpfte Repository hat. |
| GitHub gibt Ratenlimit-Fehler zurück | Warten Sie, bis das GitHub-API-Limit des Tokens zurückgesetzt ist, und erwägen Sie dann, den Repository-Zugriff einzuschränken oder automatisierte Issue-Aktivitäten zu reduzieren. |
| Geschlossene Vorgänge erzeugen keine Entwürfe | Bestätigen Auto-Entwurf bei Erledigt ist aktiviert und, wenn der Nur-abgeschlossen-Modus an ist, wurde das GitHub-Issue als abgeschlossen geschlossen. |
Für umfassendere Behebungen siehe Fehlerbehebung bei ReplyRabbit.
Datenschutz und Datenverarbeitung
ReplyRabbit sendet GitHub die für die Übergabe an die Entwicklung benötigten Vorgangsinhalte. Dazu können relevanter Kundenkontext, der generierte Vorgangstitel, die generierte Zusammenfassung, Beschriftungen, Bearbeiter und der FreeScout-Konversationslink oder -Bezeichner gehören.
Geben Sie keine sensiblen Informationen in ein GitHub-Issue ein, es sei denn, das Repository darf sie erhalten. Wenn Kundendaten vollständig auf Ihrem eigenen Server bleiben müssen, lassen Sie GitHub für dieses Postfach deaktiviert.
Nächste Schritte
- Weiter mit So richten Sie ReplyRabbit ein wenn die Mailbox noch Anbieter-, Kontext- oder Stileinstellungen benötigt.
- Lesen Slack-Integration wenn Ihr Team Issue-Erstellung oder Abschlussbenachrichtigungen in Slack möchte.
- Vergleichen mit Linear-Integration wenn Sie entscheiden, welchen Issue-Tracker eine Mailbox verwenden soll.
FAQ
Brauche ich ein GitHub Personal Access Token?
Ja. ReplyRabbit verbindet sich mit GitHub über ein Token aus Ihrem eigenen GitHub-Konto oder Ihrer Organisation.
Kann ein Postfach Linear und GitHub gleichzeitig verwenden?
Nein. Jedes Postfach wählt einen Issue-Tracker: keinen, Linear oder GitHub.
Kann ReplyRabbit das GitHub-Repository wählen?
Ja, wenn Repository-Routing konfiguriert ist. ReplyRabbit unterstützt Domainzuordnungen und KI-Repository-Abgleich für Repositories, auf die Ihr Token zugreifen kann.
Welcher Plan enthält GitHub Issues?
Die manuelle Erstellung von GitHub-Issues ist eine Pro-Funktion. Die automatische Erstellung von GitHub-Issues ist eine Team-Funktion.
Sendet ReplyRabbit die gesamte Kundenkonversation an GitHub?
ReplyRabbit sendet die für die Übergabe an die Entwicklung benötigten Vorgangsinhalte, einschließlich relevantem Kundenkontext und der generierten Zusammenfassung.