Jira 통합
호환 대상 Jira
ReplyRabbit을 Jira Cloud에 연결하여 FreeScout의 지원 대화가 구조화된 Jira 이슈가 되도록 하세요. 에이전트는 대화에서 Jira 이슈를 생성하고, 연결된 이슈를 FreeScout에 표시하며, 작업이 완료되면 ReplyRabbit을 사용하여 고객 후속 조치를 준비할 수 있습니다.
개요를 찾고 계신가요?
개요
Jira 통합은 FreeScout 대화의 ReplyRabbit에 Jira 패널을 추가합니다. 사서함에 Jira가 구성되면 ReplyRabbit은 제목, 설명, 우선순위, 레이블, 담당자, 이슈 유형, 프로젝트, 지원 대화로 돌아가는 링크가 포함된 이슈를 생성할 수 있습니다.
Jira가 메일박스의 활성 이슈 트래커로 선택됩니다. 메일박스가 이미 Linear 또는 GitHub Issues를 사용 중이라면 해당 메일박스를 Jira로 옮길 준비가 될 때까지 그 트래커를 선택된 상태로 유지하세요.
사전 요구 사항
시작하기 전에 다음이 있는지 확인하세요:
- 작동하는 FreeScout 설치입니다.
- ReplyRabbit이 설치되고 활성화되었습니다.
- 사용하려는 Jira 기능을 포함하는 ReplyRabbit 요금제입니다.
- 다음과 같은 Jira Cloud 사이트
https://example.atlassian.net. - 대상 프로젝트에 접근할 수 있는 Jira 계정 이메일 및 API 토큰입니다.
- 이슈 생성을 지원하는 최소 하나의 Jira 프로젝트 및 이슈 유형.
- 활성화하는 워크플로에 대한 Jira 프로젝트 권한: Browse Projects와 Create Issues가 필요하며, 우선순위/레이블 편집, 할당, 상태 전환, 스레드 댓글을 사용할 때는 Edit Issues, Assign Issues, Transition Issues, Add Comments가 필요합니다.
ReplyRabbit이 아직 설치되지 않았다면 다음으로 시작하세요 ReplyRabbit 모듈 설치 방법, 그런 다음 완료 ReplyRabbit 설정 방법.
권한 및 API 토큰
ReplyRabbit는 Basic 인증으로 Jira Cloud REST API v3에 연결합니다. 사서함은 세 가지 연결 값을 저장합니다:
- Jira 사이트 URL: 다음
https://example.atlassian.net사이트 URL. - 계정 이메일: API 토큰과 함께 사용되는 Atlassian 계정 이메일.
- API 토큰: 해당 계정의 Jira Cloud API 토큰.
API 토큰은 암호화된 사서함 설정으로 저장되며 저장 후 전체가 다시 표시되지 않습니다. Atlassian에서 토큰이 교체되거나 제거된 경우 더 많은 이슈를 생성하기 전에 사서함 설정을 업데이트하세요.
Jira 연결
메일함 설정 열기
FreeScout에서 Jira 이슈를 생성해야 하는 사서함을 열고 다음을 여세요 설정 그리고 선택 ReplyRabbit.이슈 트래커로 Jira 선택
다음에서 통합 섹션에서 이슈 트래커를 다음으로 설정하세요 Jira. 메일함은 Linear, GitHub Issues, Jira 또는 이슈 트래커 없음을 사용할 수 있습니다.Jira 자격 증명 추가
Jira Cloud 사이트 URL, 계정 이메일 및 API 토큰을 붙여넣으세요.Jira 프로젝트 불러오기
Jira에서 프로젝트를 불러온 다음 새 이슈의 기본 프로젝트를 선택합니다.이슈 유형 선택
프로젝트의 이슈 유형을 불러오고 Task 또는 Bug 같은 기본 이슈 유형을 선택합니다.설정 저장
메일박스 설정을 저장하세요. ReplyRabbit은 해당 메일박스의 Jira 연결을 저장합니다.
기본값 구성
Jira가 연결된 후 팀에 필요한 기본값을 구성하세요:
- 기본 프로젝트: 도메인 매핑이나 AI 프로젝트 매칭이 다른 프로젝트를 선택하지 않을 때 사용되는 Jira 프로젝트.
- 기본 이슈 유형: 새 이슈의 이슈 유형, 보통 Task 또는 Bug.
- 우선순위 매핑: ReplyRabbit 우선순위 수준을 기본 Jira 우선순위 이름에 매핑합니다.
- 프로젝트 라우팅: 라우팅이 결정적이어야 할 때 고객 이메일 도메인을 Jira 프로젝트에 매핑합니다.
- 이슈 자동 제출: Team 티어에서, 트리아지가 엔지니어링 작업이 필요하다고 하면 ReplyRabbit이 Jira 이슈를 자동으로 생성하도록 합니다.
- 완료 시 자동 초안: 연결된 Jira 이슈가 Done 상태 카테고리에 도달하면 ReplyRabbit이 고객 후속 조치를 준비하도록 합니다.
프로젝트 라우팅은 선택 사항입니다. 확실히 일치하는 프로젝트가 없으면 ReplyRabbit은 메일박스 기본 프로젝트를 사용합니다.
FreeScout 대화에서 Jira 이슈 생성
Jira가 구성된 메일함에서 대화를 엽니다. ReplyRabbit 패널은 고객 스레드에서 Jira 이슈를 생성한 다음 연결된 이슈를 FreeScout에 표시할 수 있습니다.
ReplyRabbit는 구조화된 Atlassian Document Format 설명을 Jira에 보냅니다. 설명에는 지원 요약, 고객 컨텍스트 및 FreeScout 대화 링크가 포함됩니다. 고객 텍스트는 지시가 아닌 콘텐츠로 처리됩니다.
생성 후 연결된 Jira 이슈를 검토하고 필요할 때 ReplyRabbit 패널에서 상태, 우선순위, 담당자 또는 레이블을 조정하세요.
대화와 이슈를 동기화 상태로 유지
이슈가 연결되면 FreeScout 대화에서 현재 Jira 상태, 우선순위, 담당자, 레이블 및 이슈 키를 표시할 수 있습니다. 상담원은 전체 엔지니어링 뷰가 필요할 때 Jira에서 이슈를 열 수 있습니다.
ReplyRabbit는 Jira 전환을 통해 Jira 상태를 변경합니다. 상태 필드에 직접 쓰지 않습니다.
ReplyRabbit은 완료 루프도 지원합니다. 예약된 상태 확인이 연결된 Jira 이슈를 폴링합니다. Jira가 Done 상태 카테고리를 보고하면 ReplyRabbit이 고객 후속 조치 초안 작성을 도와 지원이 컨텍스트와 함께 대화를 종료할 수 있습니다.
문제 해결
| 증상 | 확인할 것 |
|---|---|
| 프로젝트가 로드되지 않습니다 | 사이트 URL이 Jira Cloud인지 확인하세요 atlassian.net URL, 이메일이 올바른지, API 토큰에 프로젝트 액세스 권한이 있는지 확인하세요. |
| 이슈 유형이 누락됨 | 선택한 프로젝트가 사용하려는 이슈 유형을 지원하는지 확인하세요. |
| 이슈가 생성되지 않음 | Jira가 메일박스 이슈 트래커로 선택되었는지, 프로젝트가 선택되었는지, ReplyRabbit 요금제에 해당 기능이 포함되어 있는지 확인하세요. |
| 자동 이슈가 생성되지 않음 | Team 티어에 있는지 확인하고 이슈 자동 제출 이 활성화되어 있습니다. |
| 상태가 업데이트되지 않음 | 대화를 다시 로드한 다음 Jira가 대상 상태에 대한 유효한 전환을 제공하는지 확인하세요. |
| 완료 초안이 표시되지 않음 | 확인 완료 시 자동 초안 이 활성화되어 있고 연결된 Jira 이슈가 Done 상태 카테고리에 도달했습니다. |
더 광범위한 수정 사항은 다음을 참조하세요 ReplyRabbit 문제 해결.
개인정보 및 데이터 처리
ReplyRabbit는 엔지니어링 핸드오프에 필요한 이슈 콘텐츠를 Jira에 보냅니다. 여기에는 관련 고객 컨텍스트, 생성된 이슈 텍스트, 우선순위, 레이블, 담당자 및 FreeScout 대화 링크 또는 식별자가 포함될 수 있습니다.
Jira Cloud 워크스페이스가 수신하도록 허용되지 않는 한 Jira 이슈에 민감한 정보를 넣지 마십시오. 고객 데이터가 전적으로 자체 서버에 있어야 하는 경우 해당 메일박스에 대해 Jira를 비활성화하십시오.
FAQ
ReplyRabbit이 Jira Data Center 또는 Server를 지원하나요?
아니요. ReplyRabbit은 atlassian.net URL을 사용하는 Jira Cloud 사이트를 지원합니다.
Jira에 OAuth가 필요한가요?
아니요. ReplyRabbit은 사이트 URL, 계정 이메일 및 Jira API 토큰을 사용하는 메일박스별 Jira Cloud 기본 인증을 사용합니다.
하나의 메일박스에서 Jira와 Linear 또는 GitHub Issues를 동시에 사용할 수 있나요?
아니요. 메일박스는 하나의 활성 이슈 트래커를 선택합니다. Linear 및 GitHub Issues 설정은 둘 중 하나가 선택된 경우에도 계속 사용할 수 있습니다.
Jira 이슈가 완료되면 ReplyRabbit이 고객 후속 조치 초안을 작성할 수 있나요?
예. ReplyRabbit은 연결된 Jira 이슈를 폴링하며 Jira가 Done 상태 범주를 보고하면 고객 후속 초안을 준비할 수 있습니다.