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 praktyczną 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`.

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.

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.