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

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

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

오류 메시지 구조

조치를 취할 수 있는 오류 메시지의 구조는 다음과 같습니다.

• 무엇이 잘못되었는지 채팅 앱이 요청을 완료할 수 없는 이유를 설명하면 사용자가 문제를 해결하는 데 도움이 됩니다. 오류가 발생한 이유를 설명하면 신뢰를 구축할 수 있습니다.
• 사용자가 목표를 달성하기 위해 취할 수 있는 조치 무엇이 잘못되었는지 말하는 것만으로는 충분하지 않습니다. 사용자에게 오류를 해결하고 목표를 달성하는 방법을 안내합니다.
• 도움을 받는 방법 사용자가 여전히 문제를 해결하지 못한 경우 추가 지원을 받을 수 있는 방법을 안내합니다. /help 명령어 또는 Chat 앱 문서 링크일 수 있습니다.

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

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

다음은 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`.

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

• 무엇이 잘못되었는지 알려줍니다. 채팅 앱에서 날짜 형식을 인식하지 못합니다.
• 사용자에게 예상되는 날짜 형식을 알려 오류를 수정하는 방법을 설명하고, 사람들이 무엇을 써야 하는지 이해하는 데 도움이 되는 날짜 예를 제공합니다.
• /help 슬래시 명령어를 통해 더 많은 도움말을 제공합니다. 사용자가 여전히 막히는 경우 자세히 알아보는 방법을 알 수 있습니다.

조치를 취할 수 없는 오류

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

Enter the correct date format.

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

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

사용해 보기

이제 조치 가능한 오류를 작성하는 방법을 알았으니 다음 시나리오에서 조치 가능한 오류를 식별할 수 있나요?

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