실행 가능한 오류 메시지 작성

이 페이지에서는 사용자가 목표를 완료할 수 있도록 문제 해결 방법을 알려주는 실행 가능한 오류 메시지를 작성하기 위한 권장사항을 설명합니다.

사용자가 Google Chat 앱과 상호작용할 때 오류 메시지가 표시되면 오류에 대한 조치를 취할 수 없으면 짜증이 날 수 있습니다. 예를 들어 오류 메시지 An error occurred는 문제, 사용자가 문제를 해결하는 방법 또는 사용자가 도움을 받을 수 있는 방법을 설명하지 않으므로 유용하지 않습니다. 이 페이지에서는 실행 및 실행할 수 없는 예를 표시하여 사용자에게 유용하도록 오류 메시지를 구성하는 방법을 설명합니다.

오류 메시지 구조

실행 가능한 오류 메시지의 구조는 다음과 같습니다.

  • 문제점 채팅 앱이 요청을 완료할 수 없는 이유를 설명하면 사용자가 문제를 해결하는 데 도움이 됩니다. 오류가 발생한 이유를 설명하면 신뢰를 쌓을 수 있습니다
  • 사용자가 목표를 향해 나아가는 방법 무엇이 잘못되었는지 말하는 것만으로는 충분하지 않습니다. 오류를 극복하고 목표를 달성하는 방법을 사용자에게 알려줍니다.
  • 지원을 받는 방법 사용자가 계속 문제를 해결할 수 없는 경우 추가 도움을 받을 수 있는 방법을 설명합니다. /help 명령어 또는 채팅 앱 문서 링크일 수 있습니다.

오류 메시지 예시: 잘못된 날짜 형식

이 예에서는 사용자가 채팅 앱에서 예상하지 못한 형식으로 날짜를 입력했습니다. November 19, 2021를 작성했지만 채팅 앱에는 2021-11-19이 필요합니다.

다음은 채팅 앱이 응답하는 오류 메시지의 실행 및 실행할 수 없는 버전입니다.

조치 가능한 오류

사용자가 채팅 앱에 다른 사용자와의 회의 일정을 예약해 달라고 요청합니다. 채팅 앱이 적절하고 실행 가능한 오류 메시지로 응답합니다.

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

사용자에게 발생한 문제, 진행 방법, 지원 요청 방법을 알려주는 오류 메시지의 예입니다.

이 오류 메시지는 다음과 같은 경우에 조치를 취할 수 있습니다.

  • 무엇이 문제였는지 설명합니다. 채팅 앱은 날짜 형식을 인식하지 못합니다.
  • 사용자에게 예상 날짜 형식을 알려 오류 해결 방법을 설명하고 사용자가 작성할 내용을 이해하는 데 도움이 되는 날짜 예를 제공합니다.
  • /help 슬래시 명령어에 대한 추가 도움말을 제공합니다. 사용자가 아직 문제를 풀지 못했다면 더 많이 배울 수 있는 방법을 알고 있는 것입니다.

실행할 수 없는 오류

사용자가 채팅 앱에 다른 사용자와의 회의 일정을 예약해 달라고 요청합니다. 채팅 앱은 유용하지 않고 조치를 취할 수 없는 오류 메시지로 응답합니다.

Enter the correct date format.

조치 가능한 정보를 제공하지 않는 오류 메시지의 예

다음과 같은 이유로 이 오류 메시지는 조치를 취할 수 없습니다.

  • 회의 예약 여부는 밝히지 않았습니다. 사용자는 회의 일정 변경을 망설이거나 회의가 예약되었다고 가정할 수 있습니다.
  • 사용자에게 날짜 형식을 지정하는 방법을 안내하지 않습니다. 사용자가 날짜 형식을 지정하는 방법을 알고 있다고 가정하는 대신 날짜 형식 yyyy-mm-dd를 예상한다고 말해야 합니다.
  • 더 많은 도움을 제공하지 않습니다. 사용자가 문제가 발생하고 진행 방법을 모를 경우 채팅 앱에 메시지 보내기를 중지할 수 있습니다.

사용해 보기

이제 조치 가능한 오류를 작성하는 방법을 알았으니 다음 시나리오에서 이러한 오류 중 어떤 것이 조치 가능한 것인지 파악할 수 있습니다.

채팅 앱은 사용자가 schedule 키워드로 채팅 앱에 메시지를 보낼 때 캘린더 이벤트를 만듭니다. 캘린더 이벤트를 만들려면 채팅 앱에 사용자 인증이 필요합니다. 사용자가 인증되지 않으면 Chat 앱이 오류 메시지로 응답합니다.

조치를 취할 수 있는 오류 메시지는 무엇인가요?
회의 일정을 예약하려면 /signin을(를) 입력하여 로그인하셔야 합니다. 자세히 알아보려면 /help를 입력합니다.
이 오류 메시지는 다음과 같이 표시되어 있으므로 조치를 취할 수 있습니다.
  • 무엇이 문제였나요? 채팅 앱에는 인증이 필요합니다.
  • 진행 방법 /signin를 입력하여 인증합니다.
  • 도움을 받는 방법 사용자가 자세한 정보를 원하면 /help를 입력하면 됩니다.
인증해야 합니다.
이 오류 메시지는 인증 방법을 알려주지 않으므로 조치를 취할 수 없습니다.
로그인합니다.
이 오류 메시지는 로그인 방법을 안내하지 않고 사용자가 로그아웃했다고 명확하게 말하는 대신 로그아웃되었음을 암시하므로 조치를 취할 수 없습니다. 혼란을 야기합니다.
회의를 예약할 수 없습니다.
이 오류 메시지는 회의를 예약할 수 없는 이유 또는 사용자가 진행할 수 있는 방법을 사용자에게 알려주지 않으므로 조치를 취할 수 없습니다. 도움말은 제공되지 않습니다.