Integracja GitHub Issues
Współpracuje z GitHub
Połącz ReplyRabbit z GitHub Issues, aby rozmowy wsparcia w FreeScout mogły stawać się uporządkowanymi zgłoszeniami w odpowiednim repozytorium. Agenci mogą utworzyć zgłoszenie z rozmowy, zachować widoczność powiązanego zgłoszenia w FreeScout i pozwolić ReplyRabbit przygotować przekazanie do inżynierii.
Szukasz przeglądu?
Przegląd
Integracja GitHub Issues dodaje panel GitHub do ReplyRabbit w rozmowie FreeScout. Gdy GitHub jest skonfigurowany, ReplyRabbit może utworzyć zgłoszenie z przyjaznym dla programisty tytułem, użytecznym podsumowaniem, etykietami, przypisanymi osobami, kontekstem repozytorium i linkiem z powrotem do rozmowy wsparcia.
Każda skrzynka wybiera jeden system zgłoszeń: brak, Linear lub GitHub. GitHub i Linear to alternatywy dla tego samego przepływu od wsparcia do inżynierii, a nie dwa systemy działające razem w jednej skrzynce.
Ręczne tworzenie zgłoszeń GitHub jest dostępne w planach Pro i Team. Automatyczne tworzenie zgłoszeń GitHub z nowych e-maili klientów jest dostępne w planie Team.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Działająca instalacja FreeScout.
- ReplyRabbit zainstalowany i aktywowany.
- Plan ReplyRabbit, który obejmuje funkcję GitHub, której chcesz użyć.
- Dostęp do konta lub organizacji GitHub, w której mają być tworzone zgłoszenia.
- Repozytorium z włączonymi GitHub Issues.
Jeśli ReplyRabbit nie jest jeszcze zainstalowany, zacznij od Jak zainstalować moduł ReplyRabbit, a następnie dokończ Jak skonfigurować ReplyRabbit.
Uprawnienia i zakres tokenów
ReplyRabbit łączy się z GitHub za pomocą osobistego tokena dostępu, który podajesz w ustawieniach skrzynki. Zalecany jest token szczegółowy, ograniczony do repozytoriów, których powinien używać ReplyRabbit. Możesz go utworzyć na Ustawienia szczegółowego tokenu GitHub.
Przyznaj tokenowi wystarczający dostęp do odczytu metadanych repozytorium, odczytu etykiet i przypisanych osób, tworzenia i aktualizacji zgłoszeń oraz dodawania komentarzy do zgłoszeń. W przypadku szczegółowego tokenu zacznij od Metadane: odczyt, Zawartość: odczyt, oraz Zgłoszenia: odczyt i zapis dla wybranych repozytoriów.
W celu ściślejszego śledzenia audytu utwórz token z dedykowanego konta bota GitHub, które ma dostęp tylko do repozytoriów, których powinien używać ReplyRabbit.
Zachowaj token w tajemnicy. Jeśli token zostanie zmieniony lub usunięty w GitHub, zaktualizuj ustawienia skrzynki przed utworzeniem kolejnych zgłoszeń.
Połącz GitHub Issues
Otwórz ustawienia skrzynki
W FreeScout otwórz skrzynkę, która powinna tworzyć zgłoszenia GitHub, a następnie otwórz Ustawienia i wybierz ReplyRabbit.Wybierz GitHub jako tracker zgłoszeń
W selektorze systemu śledzenia zgłoszeń wybierz GitHub Issues. ReplyRabbit pokazuje ustawienia GitHub i ukrywa ustawienia Linear dla tej skrzynki.Wklej token
Wklej swój Osobisty token dostępu GitHub. Jeśli token został już zapisany, ReplyRabbit pokazuje zamaskowany podgląd zamiast pełnego sekretu.Załaduj repozytoria
Kliknij przycisk, aby załadować repozytoria z GitHub, a następnie wybierz domyślne repozytorium, w którym mają być tworzone nowe zgłoszenia.Zapisz ustawienia
Zapisz ustawienia skrzynki. ReplyRabbit przechowuje połączenie GitHub dla tej skrzynki.
Skonfiguruj wartości domyślne
Po wybraniu domyślnego repozytorium skonfiguruj domyślne ustawienia zgłoszeń, od których powinni zaczynać Twoi agenci:
- Domyślne repozytorium: wybierz, gdzie tworzone są zgłoszenia, gdy żadna reguła routingu nie pasuje.
- Automatyczne przesyłanie zgłoszeń: w planie Team, pozwól ReplyRabbit automatycznie tworzyć problemy GitHub, gdy wynik triage wskazuje, że potrzebna jest praca inżynierska.
- Routing repozytoriów: włącz automatyczny wybór repozytorium, gdy chcesz, aby ReplyRabbit dopasowywał rozmowy do dostępnych repozytoriów.
- Mapowania domen: mapuj domeny e-mail klientów na konkretne repozytoria, gdy potrzebujesz deterministycznego routingu.
- Etykiety: wybierz etykiety, które ReplyRabbit może stosować dla typu zgłoszenia, priorytetu lub innych tagów workflow.
- Etykiety priorytetów: mapuj poziomy priorytetów ReplyRabbit na etykiety GitHub, ponieważ GitHub Issues nie ma natywnego pola priorytetu.
- Domyślny przypisany: wybierz użytkownika GitHub, który domyślnie ma otrzymywać nowe zgłoszenia.
- Uwaga dotycząca przeglądu: gdy automatyczne tworzenie zgłoszeń jest włączone, dodaj notatkę FreeScout informującą agentów, że zgłoszenie zostało utworzone automatycznie i powinno zostać sprawdzone.
Routing repozytoriów jest opcjonalny. Jeśli żadne repozytorium nie zostanie pewnie dopasowane, ReplyRabbit używa domyślnego repozytorium.
Utwórz zgłoszenie GitHub z rozmowy FreeScout
Otwórz rozmowę w skrzynce, w której skonfigurowano GitHub. Panel ReplyRabbit może utworzyć zgłoszenie GitHub z wątku klienta, a następnie pokazać powiązane zgłoszenie w FreeScout.
Treść zgłoszenia jest generowana do przekazania inżynierii, a nie kopiowana bezmyślnie z całego wątku e-mail. Przy ręcznym tworzeniu sprawdź tytuł, podsumowanie, etykiety, przypisanych i repozytorium przed utworzeniem zgłoszenia.
ReplyRabbit może również dodać kontekst wątku e-mail jako komentarz do zgłoszenia GitHub, dzięki czemu zespół inżynieryjny ma dane klienta bez proszenia wsparcia o ponowne wklejenie tego samego wątku.
Utrzymuj rozmowy i zgłoszenia w synchronizacji
Po powiązaniu zgłoszenia rozmowa FreeScout może pokazywać bieżący identyfikator zgłoszenia GitHub, tytuł, stan, etykiety i przypisanych. Agenci mogą otworzyć zgłoszenie w GitHub, gdy potrzebują pełnego widoku inżynierskiego.
ReplyRabbit obsługuje także pętlę ukończenia: sprawdza powiązane zgłoszenia GitHub według harmonogramu, zwykle co 5 minut. Gdy GitHub zamyka zgłoszenie, ReplyRabbit może pomóc w przygotowaniu szkicu kontynuacji kontaktu z klientem, aby wsparcie mogło zamknąć rozmowę z kontekstem. Jeśli Twój zespół używa powodów zamknięcia GitHub, możesz ograniczyć szkice ukończenia do zgłoszeń zamkniętych jako ukończone.
Rozwiązywanie problemów
| Objaw | Co sprawdzić |
|---|---|
| Repozytoria nie zostaną załadowane | Potwierdź, że token jest aktualny i ma dostęp do wybranych repozytoriów GitHub. |
| Zgłoszenia nie są tworzone | Potwierdź, że GitHub jest wybranym trackerem zgłoszeń, wybrano domyślne repozytorium, a Twój plan ReplyRabbit obejmuje tę funkcję. |
| Automatyczne zgłoszenia nie są tworzone | Potwierdź, że korzystasz z planu Team oraz Automatyczne przesyłanie zgłoszeń jest włączona. |
| Repozytorium jest nieprawidłowe lub go brakuje | Potwierdź, że routing repozytorium lub mapowania domen są skonfigurowane. ReplyRabbit używa domyślnego repozytorium, gdy nie ma pewnego dopasowania. |
| Etykiety lub przypisani nie będą aktualizowane | Przeładuj rozmowę, a następnie potwierdź, że token nadal ma dostęp do powiązanego repozytorium. |
| GitHub zwraca błędy limitu szybkości | Poczekaj na reset limitu API GitHub dla tokena, a następnie rozważ zawężenie dostępu do repozytoriów lub ograniczenie automatycznej aktywności zgłoszeń. |
| Zamknięte zgłoszenia nie generują szkiców | Potwierdź Auto Draft on Done jest włączona, a jeśli tryb tylko ukończonych jest włączony, problem GitHub został zamknięty jako ukończony. |
Szersze poprawki znajdziesz w Rozwiązywanie problemów z ReplyRabbit.
Prywatność i przetwarzanie danych
ReplyRabbit wysyła do GitHub treść zgłoszenia potrzebną do przekazania zespołowi inżynieryjnemu. Może to obejmować istotny kontekst klienta, wygenerowany tytuł zgłoszenia, wygenerowane podsumowanie, etykiety, przypisane osoby oraz link lub identyfikator konwersacji FreeScout.
Nie umieszczaj poufnych informacji w zgłoszeniu GitHub, chyba że repozytorium może je otrzymywać. Jeśli dane klientów muszą pozostać całkowicie na Twoim serwerze, wyłącz GitHub dla tej skrzynki.
Następne kroki
- Kontynuuj z Jak skonfigurować ReplyRabbit jeśli skrzynka nadal wymaga ustawień dostawcy, kontekstu lub stylu.
- Odczyt Integracja Slack jeśli Twój zespół chce powiadomień o tworzeniu problemów lub ukończeniu w Slacku.
- Porównaj z Integracja z Linear jeśli decydujesz, którego narzędzia do śledzenia problemów powinna używać skrzynka.
FAQ
Czy potrzebuję osobistego tokenu dostępu GitHub?
Tak. ReplyRabbit łączy się z GitHub przy użyciu tokenu z własnego konta lub organizacji GitHub.
Czy jedna skrzynka może używać Linear i GitHub jednocześnie?
Nie. Każda skrzynka wybiera jeden system śledzenia zgłoszeń: brak, Linear lub GitHub.
Czy ReplyRabbit może wybrać repozytorium GitHub?
Tak, gdy skonfigurowano routing repozytoriów. ReplyRabbit obsługuje mapowania domen i dopasowywanie repozytoriów AI dla repozytoriów, do których Twój token ma dostęp.
Który plan obejmuje GitHub Issues?
Ręczne tworzenie zgłoszeń GitHub jest funkcją Pro. Automatyczne tworzenie zgłoszeń GitHub jest funkcją Team.
Czy ReplyRabbit wysyła całą rozmowę z klientem do GitHub?
ReplyRabbit wysyła treść zgłoszenia potrzebną do przekazania zespołowi inżynieryjnemu, w tym istotny kontekst klienta i wygenerowane podsumowanie.