Service Desk 사용하기

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed

Issue 생성하거나 응답하기 위해 서비스 데스크를 사용할 수 있습니다. 이러한 문제에서 우리 친근한 Support Bot을 볼 수도 있습니다.

서비스 데스크 이메일 주소 보기

프로젝트의 서비스 데스크 이메일 주소를 확인하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Monitor > Service Desk를 선택합니다.

이메일 주소는 이슈 디렉터리 상단에 표시됩니다.

엔드 사용자(이슈 생성자)로써

서비스 데스크 문제를 생성하려면 엔드 사용자는 GitLab 인스턴스에 대해 아무것도 알 필요가 없습니다. 그들은 주어진 주소로 이메일을 보내고, 접수 확인 이메일을 받습니다:

Service Desk enabled

이는 엔드 사용자에게 구독 취소 옵션을 제공합니다.

구독을 취소하지 않은 경우, 이슈에 추가된 새 댓글은 이메일로 전송됩니다:

Service Desk reply email

이메일로 보낸 답변은 이슈 자체에 표시됩니다.

추가 정보는 외부 참여자이메일 처리를 위해 사용되는 헤더를 참조하십시오.

GitLab UI에서 서비스 데스크 티켓 만들기

  • GitLab 16.9에서 도입되었습니다. 기본적으로 비활성화된 convert_to_ticket_quick_action 플래그가 있습니다.
  • GitLab 16.10에서 일반적으로 사용 가능해졌습니다. 플래그 convert_to_ticket_quick_action가 제거되었습니다.

UI에서 서비스 데스크 티켓을 만들려면:

  1. 이슈를 생성합니다.
  2. /convert_to_ticket user@example.com이라는 퀵 액션만 포함하는 댓글을 추가합니다. GitLab Support Bot로부터 댓글이 표시됩니다.
  3. 페이지를 새로 고쳐서 UI가 유형 변경을 반영하도록 합니다.
  4. 선택 사항. 외부 참여자에게 초기 서비스 데스크 이메일을 보내려면 이슈에 댓글을 추가합니다.

시연을 보려면 UI 및 API를 통한 서비스 데스크 티켓 만들기 (GitLab 16.10)를 참조하십시오.

이슈에 대한 응답자로써

이 문제에 대한 응답자로서, 모든 것이 다른 GitLab 이슈처럼 작동합니다. GitLab은 응답자가 고객 지원 요청을 통해 생성된 문제를 볼 수 있는 익숙한 모습의 이슈 트래커를 표시하고, 이를 필터링하거나 상호 작용할 수 있습니다.

Service Desk Issue tracker

엔드 사용자의 메시지는 특별한 Support Bot 사용자에서 오는 것으로 표시됩니다. 당신은 GitLab에서 평소와 같이 댓글을 읽거나 작성할 수 있습니다.

Service Desk issue thread

  • 프로젝트의 가시성(비공개, 내부, 공개)은 서비스 데스크에 영향을 주지 않습니다.
  • 그룹 또는 네임스페이스를 포함한 프로젝트의 경로가 이메일에 표시됩니다.

서비스 데스크 이슈 보기

전제 조건:

  • 프로젝트에 대해 적어도 기록자 역할을 가져야 합니다.

서비스 데스크 이슈를 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Monitor > Service Desk를 선택합니다.

재설계된 이슈 디렉터리

  • GitLab 16.1에서 도입되었습니다. 기본적으로 비활성화된 service_desk_vue_list 플래그가 있습니다.
  • GitLab 16.10에서 일반적으로 사용 가능해졌습니다. 플래그 service_desk_vue_list가 제거되었습니다.

서비스 데스크 이슈 디렉터리은 일반적인 이슈 디렉터리과 더 유사해졌습니다. 사용 가능한 기능은 다음과 같습니다:

이제 더 이상 서비스 데스크 이슈 디렉터리에서 새 이슈를 생성하는 옵션이 없습니다. 이 결정은 새 이슈가 전용 이메일 주소로 이메일을 보내는 서비스 데스크의 성격을 더 잘 반영합니다.

이슈 디렉터리 필터링
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Monitor > Service Desk를 선택합니다.
  3. 이슈 디렉터리 상단에 검색 또는 결과 필터링을 선택합니다.
  4. 나타나는 드롭다운 디렉터리에서 필터링할 속성을 선택합니다.
  5. 사용할 필터링용 연산자를 선택하거나 입력합니다. 다음 연산자를 사용할 수 있습니다:
    • =: Is
    • !=: Is not one of
  6. 속성을 필터링할 텍스트를 입력합니다. 일부 속성은 None 또는 Any로 필터링할 수 있습니다.
  7. 여러 속성으로 필터링하려면이 프로세스를 반복합니다. 여러 속성은 논리적인 AND로 연결됩니다.
OR 연산자로 필터링

OR 연산자를 사용하여 필터링하는 경우, is one of: ||을 사용할 수 있습니다.

  • 수행자
  • 레이블

is one of는 포괄적인 OR을 나타냅니다. 예를 들어 Assignee is one of Sidney JonesAssignee is one of Zhang Wei로 필터링할 경우 GitLab은 Sidney, Zhang 또는 그들 둘 모두가 수행자인 이슈를 표시합니다.

ID로 이슈 필터링
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Monitor > Service Desk를 선택합니다.
  3. 검색 상자에 이슈 ID를 입력합니다. 예를 들어 #10을 입력하여 10번 이슈만 반환할 수 있습니다.

이메일 내용 및 형식

HTML 이메일의 특수 HTML 형식

  • GitLab 15.9에서 도입되었습니다. 기본적으로 비활성화된 service_desk_html_to_text_email_handler 플래그가 있습니다.
  • GitLab 15.11에서 일반적으로 사용 가능해졌습니다. 플래그 service_desk_html_to_text_email_handler가 제거되었습니다.

HTML 이메일은 다음과 같은 HTML 형식을 표시합니다:

  • 인용구
  • 이미지
  • 접는 섹션

댓글에 첨부된 파일

  • GitLab 15.8에서 도입되었습니다. 기본적으로 비활성화된 service_desk_new_note_email_native_attachments 플래그가 있습니다.
  • GitLab 15.10에서 GitLab.com 및 Self-Managed에서 활성화되었습니다.
  • GitLab 16.6에서 일반적으로 사용 가능해졌습니다. 플래그 service_desk_new_note_email_native_attachments이 제거되었습니다.

댓글에 첨부 파일이 포함되어 있고 총 크기가 10MB 이하인 경우, 이러한 첨부 파일은 이메일의 일부로 전송됩니다. 그 외의 경우, 이메일에는 첨부 파일에 대한 링크가 포함됩니다.

GitLab 15.9 및 이전 버전에서는 댓글에 업로드된 파일이 이메일에 링크로 전송됩니다.

보통 이슈를 서비스 데스크 티켓으로 변환하기

원하는 일반적인 이슈를 서비스 데스크 티켓으로 변환하려면 빠른 조치 /convert_to_ticket external-issue-author@example.com를 사용하면 됩니다. 이는 제공된 이메일 주소를 티켓의 외부 저자로 지정하고 외부 참여자 디렉터리에 추가합니다. 해당 사용자는 해당 티켓에 대한 서비스 데스크 이메일을 받게 되며, 해당 이메일에 회신할 수 있습니다. 회신하는 경우 새로운 댓글이 티켓에 추가됩니다.

GitLab은 기본 thank_you 이메일을 보내지 않습니다. 티켓에 공개 코멘트를 추가하여 티켓이 생성되었음을 최종 사용자에게 알릴 수 있습니다.

개인 정보 고려 사항

서비스 데스크 이슈는 기밀로 분류되므로 프로젝트 구성원만 볼 수 있습니다. 프로젝트 소유자는 이슈를 공개로 만들 수 있습니다. 서비스 데스크 이슈가 공개되면 이슈 생성자와 참가자의 이메일 주소는 해당 프로젝트에 대해 적어도 기자 역할을 가진 로그인한 사용자에게 공개됩니다.

GitLab 15.8 및 그 이전 버전에서 서비스 데스크 이슈가 공개되면 해당 이슈를 볼 수 있는 모든 사용자에게 이슈 생성자의 이메일 주소가 표시됩니다.

프로젝트 구성원은 해당 GitLab 인스턴스에서 적어도 기자 역할을 가진 사용자에게만 내부 이메일 주소를 통해 이슈를 생성할 수 있습니다. 외부 사용자(이슈 생성자)는 정보 노트에 표시된 내부 이메일 주소를 볼 수 없습니다.

서비스 데스크 이슈 이동

서비스 데스크 이슈를 GitLab에서 이슈를 이동하는 것과 같은 방법으로 이동할 수 있습니다.

서비스 데스크 이슈가 활성화된 다른 프로젝트로 이동되면 해당 이슈를 생성한 고객은 계속해서 이메일 알림을 받게됩니다. 이동된 이슈는 먼저 닫혀진 후 복사되므로 해당 고객은 이전 이슈와 새로운 이슈 둘 다 참가자로 간주됩니다. 이전 이슈와 새 이슈에서 모든 알림을 계속해서 받게됩니다.