GitHub 이슈 통합
호환 대상 GitHub
ReplyRabbit을 GitHub Issues에 연결하여 FreeScout의 지원 대화가 올바른 리포지토리의 구조화된 이슈가 되도록 하세요. 에이전트는 대화에서 이슈를 생성하고, 연결된 이슈를 FreeScout에 표시하며, ReplyRabbit이 엔지니어링 핸드오프를 준비하도록 할 수 있습니다.
개요를 찾고 계신가요?
개요
GitHub Issues 통합은 FreeScout 대화의 ReplyRabbit에 GitHub 패널을 추가합니다. GitHub가 구성되면 ReplyRabbit은 개발자 친화적인 제목, 유용한 요약, 레이블, 담당자, 저장소 컨텍스트, 지원 대화로 돌아가는 링크가 포함된 이슈를 생성할 수 있습니다.
각 메일박스는 하나의 이슈 트래커를 선택합니다: 없음, Linear 또는 GitHub. GitHub와 Linear는 동일한 지원에서 엔지니어링으로의 워크플로에 대한 대안이며, 하나의 메일박스에서 함께 실행되는 두 개의 트래커가 아닙니다.
수동 GitHub 이슈 생성은 Pro 및 Team에서 사용할 수 있습니다. 새 고객 이메일에서 자동 GitHub 이슈 생성은 Team에서 사용할 수 있습니다.
사전 요구 사항
시작하기 전에 다음이 있는지 확인하세요:
- 작동하는 FreeScout 설치입니다.
- ReplyRabbit이 설치되고 활성화되었습니다.
- 사용하려는 GitHub 기능을 포함하는 ReplyRabbit 요금제입니다.
- 이슈를 생성할 GitHub 계정 또는 조직에 대한 접근 권한입니다.
- GitHub Issues가 활성화된 저장소입니다.
ReplyRabbit이 아직 설치되지 않았다면 다음으로 시작하세요 ReplyRabbit 모듈 설치 방법, 그런 다음 완료 ReplyRabbit 설정 방법.
권한 및 토큰 범위
ReplyRabbit는 사서함 설정에서 제공하는 개인 액세스 토큰으로 GitHub에 연결합니다. 세밀한 권한의 토큰을 권장하며, ReplyRabbit가 사용해야 하는 저장소로 제한하십시오. 다음에서 생성할 수 있습니다 GitHub의 세분화된 토큰 설정.
토큰에 리포지토리 메타데이터 읽기, 레이블 및 담당자 읽기, 이슈 생성 및 업데이트, 이슈 댓글 추가에 충분한 액세스 권한을 부여합니다. 세분화된 토큰의 경우 다음으로 시작하세요 메타데이터: 읽기, 콘텐츠: 읽기, 그리고 이슈: 읽기 및 쓰기 선택한 저장소에 대해.
더 엄격한 감사 추적을 위해 ReplyRabbit이 사용해야 하는 저장소에만 액세스할 수 있는 전용 GitHub 봇 계정에서 토큰을 생성하세요.
토큰을 비공개로 유지하세요. GitHub에서 토큰이 교체되거나 제거되면 더 많은 이슈를 생성하기 전에 메일박스 설정을 업데이트하세요.
GitHub Issues 연결
메일함 설정 열기
FreeScout에서 GitHub 이슈를 생성해야 하는 사서함을 열고 다음을 여세요 설정 그리고 선택 ReplyRabbit.이슈 트래커로 GitHub 선택
이슈 트래커 선택기에서 다음을 선택하세요 GitHub 이슈. ReplyRabbit은 해당 메일함에 대해 GitHub 설정을 표시하고 Linear 설정을 숨깁니다.토큰 붙여넣기
다음을 붙여넣으세요 GitHub 개인 액세스 토큰. 이미 토큰을 저장했다면 ReplyRabbit은 전체 비밀 대신 마스킹된 미리보기를 표시합니다.저장소 불러오기
버튼을 클릭하여 GitHub에서 저장소를 로드한 다음, 새 이슈가 생성되어야 할 기본 저장소를 선택하세요.설정 저장
메일박스 설정을 저장하세요. ReplyRabbit은 해당 메일박스의 GitHub 연결을 저장합니다.
기본값 구성
기본 저장소가 선택된 후 상담원이 시작해야 하는 이슈 기본값을 구성하세요:
- 기본 저장소: 라우팅 규칙이 일치하지 않을 때 이슈가 생성되는 위치를 선택하세요.
- 이슈 자동 제출: Team 티어에서, 트리아지 결과가 엔지니어링 작업이 필요하다고 하면 ReplyRabbit이 GitHub 이슈를 자동으로 생성하도록 합니다.
- 저장소 라우팅: ReplyRabbit이 대화를 사용 가능한 저장소에 매칭하도록 하려면 자동 저장소 선택을 활성화하세요.
- 도메인 매핑: 결정적 라우팅이 필요할 때 고객 이메일 도메인을 특정 저장소에 매핑합니다.
- 레이블: 이슈 유형, 우선순위 또는 기타 워크플로 태그에 대해 ReplyRabbit이 적용할 수 있는 레이블을 선택하세요.
- 우선순위 라벨: GitHub Issues에는 기본 우선순위 필드가 없으므로 ReplyRabbit 우선순위 수준을 GitHub 레이블에 매핑합니다.
- 기본 담당자: 기본적으로 새 이슈를 받을 GitHub 사용자를 선택하세요.
- 검토 안내: 자동 이슈 생성이 활성화된 경우, 이슈가 자동으로 생성되었으며 검토해야 함을 상담원에게 알리는 FreeScout 노트를 추가합니다.
저장소 라우팅은 선택 사항입니다. 확실하게 일치하는 저장소가 없으면 ReplyRabbit은 기본 저장소를 사용합니다.
FreeScout 대화에서 GitHub 이슈 생성
GitHub이 구성된 메일함에서 대화를 엽니다. ReplyRabbit 패널은 고객 스레드에서 GitHub 이슈를 생성한 다음 연결된 이슈를 FreeScout에 표시할 수 있습니다.
이슈 콘텐츠는 엔지니어링 핸드오프를 위해 생성되며 전체 이메일 스레드에서 무작정 복사되지 않습니다. 수동 생성 시 이슈를 만들기 전에 제목, 요약, 라벨, 담당자 및 리포지토리를 검토하세요.
ReplyRabbit는 이메일 스레드 컨텍스트를 GitHub 이슈 댓글로 추가할 수도 있어, 엔지니어링 팀이 지원팀에 같은 스레드를 다시 붙여 달라고 요청하지 않고도 고객 세부 정보를 확인할 수 있습니다.
대화와 이슈를 동기화 상태로 유지
이슈가 연결되면 FreeScout 대화에서 현재 GitHub 이슈 식별자, 제목, 상태, 레이블 및 담당자를 표시할 수 있습니다. 상담원은 전체 엔지니어링 뷰가 필요할 때 GitHub에서 이슈를 열 수 있습니다.
ReplyRabbit은 완료 루프도 지원합니다: 일반적으로 5분마다 연결된 GitHub 이슈를 확인합니다. GitHub가 이슈를 닫으면 ReplyRabbit이 고객 후속 조치 초안 작성을 도와 지원이 컨텍스트와 함께 대화를 종료할 수 있습니다. 팀이 GitHub 종료 이유를 사용하는 경우 완료로 종료된 이슈로 완료 초안을 제한할 수 있습니다.
문제 해결
| 증상 | 확인할 것 |
|---|---|
| 저장소가 로드되지 않습니다 | 토큰이 현재 유효하고 선택한 GitHub 리포지토리에 접근할 수 있는지 확인하세요. |
| 이슈가 생성되지 않음 | GitHub가 선택된 이슈 트래커인지, 기본 저장소가 선택되었는지, ReplyRabbit 요금제에 해당 기능이 포함되어 있는지 확인하세요. |
| 자동 이슈가 생성되지 않음 | Team 티어에 있는지 확인하고 이슈 자동 제출 이 활성화되어 있습니다. |
| 저장소가 잘못되었거나 누락되었습니다 | 저장소 라우팅 또는 도메인 매핑이 구성되었는지 확인하세요. 확신할 수 있는 일치 항목이 없으면 ReplyRabbit은 기본 저장소를 사용합니다. |
| 레이블 또는 담당자가 업데이트되지 않음 | 대화를 다시 로드한 다음 토큰이 여전히 연결된 저장소에 액세스할 수 있는지 확인하세요. |
| GitHub이 속도 제한 오류를 반환합니다 | 토큰의 GitHub API 한도가 재설정될 때까지 기다린 다음 리포지토리 액세스를 좁히거나 자동화된 이슈 활동을 줄이는 것을 고려하세요. |
| 닫힌 이슈는 초안을 생성하지 않습니다 | 확인 완료 시 자동 초안 이 활성화되어 있고, 완료 전용 모드가 켜져 있는 경우 GitHub 이슈가 완료로 닫혔습니다. |
더 광범위한 수정 사항은 다음을 참조하세요 ReplyRabbit 문제 해결.
개인정보 및 데이터 처리
ReplyRabbit는 엔지니어링 핸드오프에 필요한 이슈 콘텐츠를 GitHub에 보냅니다. 여기에는 관련 고객 컨텍스트, 생성된 이슈 제목, 생성된 요약, 레이블, 담당자 및 FreeScout 대화 링크 또는 식별자가 포함될 수 있습니다.
저장소가 수신하도록 허용되지 않는 한 GitHub 이슈에 민감한 정보를 넣지 마십시오. 고객 데이터가 전적으로 자체 서버에 있어야 하는 경우 해당 메일박스에 대해 GitHub를 비활성화하십시오.
다음 단계
- 계속하기 ReplyRabbit 설정 방법 메일박스에 여전히 제공자, 컨텍스트 또는 스타일 설정이 필요한 경우.
- 읽기 Slack 통합 팀이 Slack에서 이슈 생성 또는 완료 알림을 원하는 경우.
- 다음과 비교 Linear 통합 메일박스가 어떤 이슈 트래커를 사용해야 하는지 결정하는 경우.
FAQ
GitHub 개인 액세스 토큰이 필요한가요?
예. ReplyRabbit은 자체 GitHub 계정 또는 조직의 토큰으로 GitHub에 연결합니다.
하나의 메일박스에서 Linear와 GitHub를 동시에 사용할 수 있나요?
아니요. 각 메일박스는 하나의 이슈 트래커를 선택합니다: 없음, Linear 또는 GitHub.
ReplyRabbit이 GitHub 저장소를 선택할 수 있나요?
예, 저장소 라우팅이 구성된 경우입니다. ReplyRabbit은 토큰이 액세스할 수 있는 저장소에 대해 도메인 매핑과 AI 저장소 매칭을 지원합니다.
어떤 요금제에 GitHub Issues가 포함되나요?
수동 GitHub 이슈 생성은 Pro 기능입니다. 자동 GitHub 이슈 생성은 Team 기능입니다.
ReplyRabbit이 전체 고객 대화를 GitHub로 보내나요?
ReplyRabbit는 관련 고객 컨텍스트와 생성된 요약을 포함하여 엔지니어링 핸드오프에 필요한 이슈 콘텐츠를 보냅니다.