실행 가능한 오류 메시지 작성
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 사용자가 목표를 달성할 수 있도록 문제를 해결하는 방법을 알려주는 실행 가능한 오류 메시지를 작성하는 권장사항을 설명합니다.
사용자가 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 키워드를 사용하여 채팅 앱에 메시지를 보내면 채팅 앱에서 캘린더 일정을 만듭니다. 캘린더 일정을 만들려면 채팅 앱에 사용자 인증이 필요합니다. 사용자가 인증되지 않은 경우 채팅 앱은 오류 메시지로 응답합니다.
어떤 오류 메시지가 실행 가능한가요?
회의를 예약하려면 /signin를 입력하여 로그인해야 합니다. 자세히 알아보려면 /help를 입력하세요.
이 오류 메시지는 다음과 같은 내용을 포함하므로 조치를 취할 수 있습니다.
- 무엇이 잘못되었는지 채팅 앱에는 인증이 필요합니다.
- 진행 방법
/signin를 입력하여 인증합니다.
- 도움을 받는 방법 사용자가 추가 정보를 원하는 경우
/help를 입력하면 됩니다.
인증을 받아야 합니다.
이 오류 메시지에는 인증 방법이 나와 있지 않아 조치를 취할 수 없습니다.
로그인합니다.
이 오류 메시지는 로그인 방법을 설명하지 않으며 사용자가 로그아웃되었음을 명확하게 언급하지 않고 암시하므로 조치를 취할 수 없습니다.
회의를 예약할 수 없습니다.
이 오류 메시지는 회의를 예약할 수 없는 이유나 사용자가 어떻게 진행해야 하는지 알려주지 않으므로 조치를 취할 수 없습니다. 도움말이 제공되지 않습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eGoogle Chat app error messages should be actionable, guiding users on how to resolve issues and proceed.\u003c/p\u003e\n"],["\u003cp\u003eActionable error messages clearly explain the problem, provide steps for fixing it, and offer additional help resources.\u003c/p\u003e\n"],["\u003cp\u003eInactionable error messages are vague, lack guidance, and can lead to user frustration and abandonment.\u003c/p\u003e\n"],["\u003cp\u003eUse the actionable error message structure: state the problem, guide the user on fixing it, and offer further help (e.g., \u003ccode\u003e/help\u003c/code\u003e command).\u003c/p\u003e\n"],["\u003cp\u003eWhen writing error messages, assume users need clear instructions and avoid ambiguity.\u003c/p\u003e\n"]]],["Actionable error messages in Google Chat apps should specify what went wrong, how to fix it, and how to get further assistance. For example, an actionable message for an incorrect date format would state that the format is unrecognized, specify the required format (yyyy-mm-dd), and provide a /help command. In contrast, inactionable errors are vague, omit how to correct the issue, and offer no additional support. A sign-in error should also include clear instructions, and help commands.\n"],null,["# Write actionable error messages\n\nThis page describes best practices to write actionable error messages that tell\nthe user how to fix the issue so that they can complete their goal.\n\nWhen a user is interacting with a Google Chat app, encountering\nerror messages can be a frustrating experience when the error isn't actionable.\nFor example, the error message, `An error occurred`, isn't useful because the\nmessage doesn't explain what went wrong, how the user can fix the issue, or how\nthe user can get help. This page describes how to structure error messages so\nthat they're useful to users by showing actionable and inactionable examples.\n\nError message structure\n-----------------------\n\nAn actionable error message has the following structure:\n\n- **What went wrong.** Saying why the Chat app can't complete a request helps the user resolve the issue. Explaining why an error occurred builds trust.\n- **How the user can proceed toward their goal.** It's never enough to just say what went wrong. Tell users how they can move past the error and complete their goal.\n- **How to get help.** If the user is still stuck, tell them how they can get more help. This could be a `/help` command or a link to documentation for your Chat app.\n\nExample error message: incorrect date format\n--------------------------------------------\n\nIn this example, the user entered a date in a format that\nthe Chat app didn't expect. They wrote\n`November 19, 2021`, but the Chat app expects\n`2021-11-19`.\n\nHere's an actionable and an inactionable version of the error message that the\nChat app responds with:\n\n#### Actionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with a good,\nactionable error message:\n\n``I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.``\n\nThis error message is actionable for the following reasons:\n\n- Says what went wrong. The Chat app doesn't recognize the date format.\n- Explains how to fix the error by telling the user the expected date format and gives an example date that helps people understand what to write.\n- Offers more help with a `/help` slash command. If users are still stuck, they know how to learn more.\n\n#### Inactionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with an\nunhelpful, inactionable error message:\n\n`Enter the correct date format.`\n\nThis error message is inactionable for the following reasons:\n\n- Doesn't say whether it scheduled the meeting. The user might be hesitant to reschedule the meeting, or they might assume that the meeting was scheduled.\n- Doesn't tell the user how to format the date. Instead of assuming that users know how to format the date, it should say that it's expecting the date format `yyyy-mm-dd`.\n- Doesn't offer more help. When users are stuck and don't know how to proceed, they might stop messaging the Chat app.\n\nTry it out\n----------\n\nNow that you know how to write actionable errors, can you identify in the\nfollowing scenario which of these errors is actionable:\n\nA Chat app creates calendar events when users message\nthe Chat app with the keyword `schedule`. To\ncreate a calendar event, the Chat app requires user\nauthentication. If a user hasn't been authenticated, then the\nChat app responds with an error message. \nWhich error message is actionable? \nBefore I can schedule the meeting, you must sign in by typing `/signin`. To learn more, type `/help`. \nThis error message is actionable because it says the following:\n\n- What went wrong. The Chat app requires authentication.\n- How to proceed. Type `/signin` to authenticate.\n- How to get help. If the user wants more information, they can type `/help`. \nYou must authenticate. \nThis error message is inactionable because it doesn't say how to authenticate. \nSign in. \nThis error message is inactionable because it doesn't say how to sign in, and it implies that the user is signed out instead of clearly saying so, which is confusing. \nCan't schedule meeting. \nThis error message is inactionable because it doesn't tell the user why the meeting can't be scheduled or how the user can proceed. No help is provided."]]
