이 페이지에서는 사용자가 목표를 달성할 수 있도록 문제를 해결하는 방법을 사용자에게 알려주는 실용적인 오류 메시지를 작성하는 권장사항을 설명합니다.
사용자가 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 앱에 메시지를 보낼 때 Calendar 일정을 만듭니다. Calendar 일정을 만들려면 Chat 앱에 사용자 인증이 필요합니다. 사용자가 인증되지 않은 경우 Chat 앱은 오류 메시지로 응답합니다.
/signin을 입력하여 로그인해야 합니다. 자세히 알아보려면 /help를 입력하세요.- 무엇이 문제였나요? Chat 앱에 인증이 필요합니다.
- 진행 방법
/signin을 입력하여 인증합니다. - 도움을 받는 방법 사용자가 자세한 정보를 원하는 경우
/help를 입력하면 됩니다.