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 occurrednie 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 są przydatne dla użytkowników. Zawiera ona przykłady działań, które można podjąć, i takich, których nie można podjąć.

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. Samo stwierdzenie, co poszło nie tak, nigdy nie wystarczy. 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ć dodatkową pomoc. Może to być polecenie /help lub link do dokumentacji aplikacji w 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. Użytkownik wpisał November 19, 2021, ale aplikacja Google Chat oczekuje 2021-11-19.

Oto wersja komunikatu o błędzie, na który aplikacja do czatu odpowiada, gdy można podjąć działanie, i wersja, gdy nie można podjąć działania:

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ć dalej i jak uzyskać pomoc.

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

  • Wyświetla informacje o tym, 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 pozwala podjąć żadnych działań:

Enter the correct date format.

Przykładowy komunikat o błędzie, który nie zawiera przydatnych informacji.

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 do czatu.

Wypróbuj

Teraz, gdy wiesz już, jak pisać błędy, które można naprawić, w poniższym scenariuszu wskaż, który z tych błędów można naprawić:

Aplikacja Google Chat tworzy wydarzenia w kalendarzu, gdy użytkownicy wysyłają do niej wiadomości 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ć. 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.