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

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

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

오류 메시지 구조

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

• 문제가 발생한 원인 Chat 앱에서 요청을 완료할 수 없는 이유를 알려주면 사용자가 문제를 해결하는 데 도움이 됩니다. 오류가 발생한 이유를 설명하면 신뢰가 쌓입니다.
• 사용자가 목표를 향해 나아갈 수 있는 방법 문제가 무엇인지만 말하는 것만으로는 충분하지 않습니다. 사용자에게 오류를 해결하고 목표를 달성하는 방법을 안내합니다.
• 도움을 받는 방법 여전히 문제가 해결되지 않으면 사용자에게 추가 지원을 받을 수 있는 방법을 안내합니다. /help 명령어 또는 Chat 앱 문서 링크일 수 있습니다.

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

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

다음은 Chat 앱에서 응답하는 조치 가능한 버전과 조치 불가능한 버전의 오류 메시지입니다.

조치 가능한 오류

사용자가 Chat 앱에 다른 사용자와의 회의 일정을 예약해 달라고 요청합니다. Chat 앱이 조치 가능한 유용한 오류 메시지로 응답합니다.

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

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

• 어떤 문제가 발생했는지 표시됩니다. Chat 앱에서 날짜 형식을 인식하지 못합니다.
• 사용자에게 예상 날짜 형식을 알려 오류를 수정하는 방법을 설명하고 사용자가 무엇을 입력해야 하는지 이해하는 데 도움이 되는 날짜 예시를 제공합니다.
• /help 슬래시 명령어에 관한 추가 도움말을 제공합니다. 그래도 문제가 해결되지 않으면 사용자가 자세히 알아볼 수 있습니다.

조치 불가능한 오류

사용자가 Chat 앱에 다른 사용자와의 회의 일정을 예약해 달라고 요청합니다. Chat 앱이 도움을 주지 못하고 조치를 취할 수 없는 오류 메시지로 응답합니다.

Enter the correct date format.

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

• 회의가 예약되었는지 여부는 표시되지 않습니다. 사용자는 회의 일정을 변경하는 것을 주저하거나 회의가 이미 예약되었다고 생각할 수 있습니다.
• 사용자에게 날짜 형식을 지정하는 방법을 알려 주지 않습니다. 사용자가 날짜 형식을 지정하는 방법을 알고 있다고 가정하는 대신 날짜 형식 yyyy-mm-dd을 예상한다고 표시해야 합니다.
• 추가 지원을 제공하지 않습니다. 사용자가 막혀서 어떻게 진행해야 할지 모르는 경우 Chat 앱에 메시지를 보내지 않을 수 있습니다.

사용해 보기

이제 조치 가능한 오류를 작성하는 방법을 알았으므로 다음 시나리오에서 조치 가능한 오류를 찾아보세요.

사용자가 Chat 앱에 schedule 키워드로 메시지를 보내면 Chat 앱에서 캘린더 일정을 만듭니다. 캘린더 일정을 만들려면 Chat 앱에 사용자 인증이 필요합니다. 사용자가 인증되지 않은 경우 Chat 앱은 오류 메시지로 응답합니다.