이 페이지에서는 사용자가 목표를 완료할 수 있도록 문제 해결 방법을 알려주는 실행 가능한 오류 메시지를 작성하는 권장사항을 설명합니다.
사용자가 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를 입력하면 됩니다.