Wpisz przydatne komunikaty o błędach

Na tej stronie opisujemy sprawdzone metody pisania przydatnych komunikatów o błędach, jak rozwiązać problem i osiągnąć cel.

Gdy użytkownik wchodzi w interakcję z aplikacją Google Chat i ma bo komunikaty o błędach mogą być frustrujące, gdy nie można ich wyegzekwować. 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 w jaki sposób użytkownik może uzyskać pomoc. Na tej stronie opisujemy, jak uporządkować komunikaty o błędach, aby że są przydatne dla użytkowników, pokazując praktyczne przykłady.

Struktura komunikatu o błędzie

Zachęcający do działania komunikat o błędzie ma taką strukturę:

  • Co poszło nie tak. Wyjaśnienie, dlaczego aplikacja Google Chat nie może Pomaga użytkownikowi rozwiązać problem. Wyjaśnienie błędu buduje zaufanie.
  • Jak użytkownik może zrealizować swój cel. Nigdy nie wystarczy po prostu powiedzieć, co poszło nie tak. Poinformuj użytkowników, jak mogą pominąć błąd i dokończyć do osiągnięcia celu.
  • Jak uzyskać pomoc Jeśli użytkownik nadal utknął, poinformuj go, jak może uzyskać więcej pomocy. Może to być polecenie /help lub link do dokumentacji dotyczącej: aplikacji Google Chat.

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

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

Oto wersja komunikatu o błędzie z przydatną i niemożliwą do podjęcia działań, Aplikacja do obsługi czatu wysyła odpowiedź:

Możliwy do wykonania błąd

Użytkownik prosi aplikację Google Chat o zaplanowanie spotkania innej osobie. Aplikacja Google Chat wysyła komunikat przydatny komunikat 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 informujący użytkownika, co poszło nie tak, jak postępować dalej i jak uzyskać pomoc.

Ten komunikat o błędzie zawiera działanie z tych powodów:

  • Podaje, co poszło nie tak. Aplikacja Google Chat nie rozpoznają format daty.
  • Wyjaśnia, jak naprawić błąd, informując użytkownika o oczekiwanym formacie daty. i poda przykładową datę, która pomaga zrozumieć, co napisać.
  • Oferuje dodatkową pomoc dotyczącą polecenia /help po ukośniku. Jeśli użytkownicy utknęli, i wiedzą, jak może dowiedzieć się więcej.

Błąd związany z brakiem możliwości

Użytkownik prosi aplikację Google Chat o zaplanowanie spotkania innej osobie. Aplikacja Google Chat wysyła w odpowiedzi komunikat nieprzydatny komunikat o błędzie dotyczący braku działania:

Enter the correct date format.

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

Nie można podjąć działań w przypadku tego komunikatu o błędzie z następujących powodów:

  • Nie wskazuje, czy spotkanie zostało zaplanowane. Użytkownik może się zastanawiać, przełożyć spotkanie lub założyć, że zostało ono zaplanowane.
  • Nie zawiera instrukcji formatowania daty. Zamiast zakładać, że użytkowników wiedzą, jak sformatować datę, powinien on informować, że funkcja format daty yyyy-mm-dd.
  • Nie zapewnia dodatkowej pomocy. Gdy użytkownicy utknęli i nie wiedzą, jak postępować, mogą przestać wysyłać wiadomości do aplikacji Google Chat.

Wypróbuj

Wiesz już, jak pisać błędy zachęcające do działania. Czy potrafisz znajdować następujący scenariusz, w przypadku którego z tych błędów można podjąć działanie:

Aplikacja do obsługi czatu tworzy wydarzenia w kalendarzu, gdy użytkownicy wysyłają wiadomości aplikacji Google Chat ze słowem kluczowym schedule. Do Utworzenie wydarzenia w kalendarzu, aplikacja Google Chat wymaga użytkownika uwierzytelnianie. Jeśli użytkownik nie został uwierzytelniony, Aplikacja do obsługi czatu wyświetla komunikat o błędzie.

Który komunikat o błędzie skutkuje podjęciem działań?
Zanim zaplanuję spotkanie, musisz się zalogować, wpisując /signin Aby dowiedzieć się więcej, wpisz /help.
Ten komunikat o błędzie zawiera wszystkie możliwe działania, ponieważ:
  • Co poszło nie tak. Wymagania aplikacji Google Chat uwierzytelnianie.
  • Co zrobić? Wpisz /signin, aby uwierzytelnić.
  • Jak uzyskać pomoc? Jeśli użytkownik chce uzyskać więcej informacji, może wpisać /help
Musisz się uwierzytelnić.
Nie można podjąć działań w przypadku tego komunikatu o błędzie, ponieważ nie zawiera on instrukcji uwierzytelnienie.
Zaloguj się.
Nie można podjąć działań w przypadku tego komunikatu o błędzie, ponieważ nie zawiera on informacji o tym, jak się podpisać i sugeruje, że użytkownik jest wylogowany, zamiast powiedzieć wyraźnie co jest mylące.
Nie udało się zaplanować spotkania.
Nie można podjąć działań w przypadku tego komunikatu o błędzie, ponieważ nie informuje on użytkownika Dlaczego nie można zaplanować spotkania lub jak użytkownik może kontynuować rozmowę. Brak pomocy