Wpisz przydatne komunikaty o błędach

Na tej stronie opisujemy sprawdzone metody pisania przydatnych komunikatów o błędach, które informują użytkownika, jak rozwiązać problem, aby mógł osiągnąć swój cel.

Gdy użytkownik korzysta z aplikacji Google Chat, napotkanie komunikatów o błędach może być frustrujące, jeśli nie można podjąć żadnych działań w związku z tym błędem. Na przykład komunikat o błędzie An error occurred nie jest przydatny, ponieważ nie wyjaśnia, co poszło nie tak, jak użytkownik może rozwiązać problem ani jak może uzyskać pomoc. Na tej stronie znajdziesz opis struktury komunikatów o błędach, które będą przydatne dla użytkowników. Znajdziesz tu przykłady komunikatów, które zawierają informacje o możliwych działaniach, oraz takich, które ich nie zawierają.

Struktura komunikatu o błędzie

Komunikat o błędzie, który umożliwia podjęcie działania, ma taką strukturę:

  • Co poszło nie tak. Wyjaśnienie, dlaczego aplikacja Chat nie może zrealizować prośby, pomaga użytkownikowi rozwiązać problem. Wyjaśnienie, dlaczego wystąpił błąd, buduje zaufanie.
  • Jak użytkownik może osiągnąć swój cel. Nie wystarczy tylko powiedzieć, co poszło nie tak. Poinformuj użytkowników, jak mogą rozwiązać problem i osiągnąć swój cel.
  • Jak uzyskać pomoc Jeśli użytkownik nadal ma problem, poinformuj go, jak może uzyskać więcej pomocy. Może to być polecenie /help lub link do dokumentacji aplikacji do obsługi Google Chat.

Przykładowy komunikat o błędzie: nieprawidłowy format daty

W tym przykładzie użytkownik wpisał datę w formacie, którego aplikacja Chat nie oczekiwała. Napisali November 19, 2021, ale aplikacja Google Chat oczekuje 2021-11-19.

Oto wersja komunikatu o błędzie, na który aplikacja Google Chat może zareagować, oraz wersja, na którą nie może zareagować:

Błąd wymagający działania

Użytkownik prosi aplikację Chat o zaplanowanie spotkania z inną osobą. Aplikacja Chat odpowiada dobrym, przydatnym komunikatem o błędzie:

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

Przykładowy komunikat o błędzie, który informuje użytkownika o tym, co poszło nie tak, jak postępować i jak uzyskać pomoc.

Ten komunikat o błędzie jest przydatny z tych powodów:

  • Wyjaśnia, co poszło nie tak. Aplikacja Chat nie rozpoznaje formatu daty.
  • Wyjaśnia, jak naprawić błąd, podając oczekiwany format daty i przykład daty, który pomaga użytkownikom zrozumieć, co należy wpisać.
  • Oferuje więcej pomocy za pomocą polecenia po ukośniku /help. Jeśli użytkownicy nadal będą mieć problemy, będą wiedzieć, jak uzyskać więcej informacji.

Błąd, który nie wymaga działania

Użytkownik prosi aplikację Chat o zaplanowanie spotkania z inną osobą. Aplikacja Chat odpowiada nieprzydatnym komunikatem o błędzie, który nie zawiera żadnych informacji o tym, co należy zrobić:

Enter the correct date format.

Przykładowy komunikat o błędzie, który nie zawiera informacji umożliwiających podjęcie działań.

Ten komunikat o błędzie nie wymaga żadnych działań z tych powodów:

  • Nie informuje, czy spotkanie zostało zaplanowane. Użytkownik może się wahać, czy przełożyć spotkanie, lub może założyć, że zostało ono zaplanowane.
  • Nie informuje użytkownika, jak sformatować datę. Zamiast zakładać, że użytkownicy wiedzą, jak sformatować datę, należy podać, że oczekiwany jest format daty yyyy-mm-dd.
  • Nie oferuje dodatkowej pomocy. Gdy użytkownicy utkną i nie będą wiedzieć, co dalej zrobić, mogą przestać wysyłać wiadomości do aplikacji Google Chat.

Wypróbuj

Skoro już wiesz, jak pisać błędy, które można naprawić, czy w poniższym scenariuszu potrafisz wskazać, który z tych błędów można naprawić:

Aplikacja do obsługi czatu tworzy wydarzenia w kalendarzu, gdy użytkownicy wysyłają do niej wiadomość ze słowem kluczowym schedule. Aby utworzyć wydarzenie w kalendarzu, aplikacja Chat wymaga uwierzytelnienia użytkownika. Jeśli użytkownik nie został uwierzytelniony, aplikacja Chat odpowie komunikatem o błędzie.

Który komunikat o błędzie wymaga podjęcia działań?
Zanim zaplanuję spotkanie, musisz się zalogować, wpisując /signin. Aby dowiedzieć się więcej, wpisz /help.
Ten komunikat o błędzie jest przydatny, ponieważ zawiera te informacje:
  • Co poszło nie tak. Aplikacja Chat wymaga uwierzytelnienia.
  • Co zrobić dalej. Wpisz /signin, aby się uwierzytelnić.
  • Jak uzyskać pomoc. Jeśli użytkownik chce uzyskać więcej informacji, może wpisać /help.
Musisz się uwierzytelnić.
Ten komunikat o błędzie jest bezużyteczny, ponieważ nie zawiera informacji o tym, jak się uwierzytelnić.
Zaloguj się.
Ten komunikat o błędzie jest bezużyteczny, ponieważ nie zawiera informacji o tym, jak się zalogować, i sugeruje, że użytkownik jest wylogowany, zamiast wyraźnie o tym informować, co jest mylące.
Nie można zaplanować spotkania.
Ten komunikat o błędzie jest bezużyteczny, ponieważ nie informuje użytkownika, dlaczego nie można zaplanować spotkania ani jak może on postępować dalej. Nie ma pomocy.