Wpisz przydatne komunikaty o błędach

Na tej stronie opisujemy sprawdzone metody tworzenia 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, może być zirytowany, gdy pojawi się komunikat o błędzie, którego nie można naprawić. Na przykład komunikat o błędzie An error occurred nie jest przydatny, ponieważ nie wyjaśnia, co poszło nie tak, jak należy, jak użytkownik może rozwiązać problem ani jak może uzyskać pomoc. Na tej stronie znajdziesz informacje o tym, jak tworzyć komunikaty o błędach, aby były przydatne dla użytkowników. Pokazujemy w nich przykłady działań, które można wykonać, oraz tych, których nie można wykonać.

Struktura komunikatu o błędzie

Komunikat o błędzie z możliwością działania ma taką strukturę:

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

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

W tym przykładzie użytkownik wprowadził datę w formacie, którego aplikacja Google Chat nie rozpoznaje. Użytkownik napisał: November 19, 2021, ale aplikacja Google Chat oczekuje: 2021-11-19.

Oto wersja komunikatu o błędzie z możliwością działania i bez niej, który wyświetla aplikacja Google Chat:

Błąd, który umożliwia podjęcie działań

Użytkownik prosi aplikację Google Chat o zaplanowanie spotkania z inną osobą. Aplikacja Google Chat odpowiada odpowiednim 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`.

Ten komunikat o błędzie można wykorzystać w takich przypadkach:

• Informacja o tym, co poszło nie tak. Aplikacja Google Chat nie rozpoznaje formatu daty.
• wyjaśnia, jak naprawić błąd, podając oczekiwany format daty i podając przykładową datę, która pomoże użytkownikom zrozumieć, co należy wpisać.
• oferuje więcej pomocy za pomocą polecenia /help po ukośniku. Jeśli użytkownicy nadal mają problemy, wiedzą, jak uzyskać więcej informacji.

Błąd, którego nie można naprawić

Użytkownik prosi aplikację Google Chat o zaplanowanie spotkania z inną osobą. Aplikacja Google Chat odpowiada nieprzydatnym komunikatem o błędzie, na który nie można nic zrobić:

Enter the correct date format.

Ten komunikat o błędzie nie wymaga działania z tych powodów:

• Nie wiadomo, czy spotkanie zostało zaplanowane. Użytkownik może nie chcieć ponownie planować spotkania lub założyć, że spotkanie zostało już zaplanowane.
• Nie informuje użytkownika, jak sformatować datę. Zamiast zakładać, że użytkownicy wiedzą, jak sformatować datę, należy podać, że oczekuje się formatu yyyy-mm-dd.
• Nie oferuje dodatkowej pomocy. Gdy użytkownicy utkną i nie będą wiedzieć, jak kontynuować, mogą przestać wysyłać wiadomości do aplikacji Google Chat.

Wypróbuj

Teraz, gdy już wiesz, jak pisać błędy z możliwością działania, wskaż w tym scenariuszu, który z tych błędów można naprawić:

Aplikacja Google Chat tworzy wydarzenia w kalendarzu, gdy użytkownicy wysyłają wiadomości z kluczowym słowem schedule. Aby utworzyć wydarzenie w kalendarzu, aplikacja Google Chat wymaga uwierzytelnienia użytkownika. Jeśli użytkownik nie został uwierzytelniony, aplikacja Google Chat wyświetli komunikat o błędzie.