Viết thông báo lỗi có thể xử lý được

Trang này mô tả các phương pháp hay nhất để viết thông báo lỗi có thể xử lý, cho người dùng biết cách khắc phục vấn đề để họ có thể hoàn thành mục tiêu.

Khi tương tác với một ứng dụng Google Chat, người dùng có thể cảm thấy khó chịu khi gặp phải thông báo lỗi mà không thể xử lý. Ví dụ: thông báo lỗi An error occurred không hữu ích vì thông báo này không giải thích vấn đề, cách người dùng có thể khắc phục vấn đề hoặc cách người dùng có thể được trợ giúp. Trang này mô tả cách cấu trúc thông báo lỗi để thông báo lỗi hữu ích cho người dùng bằng cách đưa ra các ví dụ có thể xử lý và không thể xử lý.

Cấu trúc thông báo lỗi

Thông báo lỗi có thể xử lý có cấu trúc như sau:

• Vấn đề đã xảy ra. Việc cho biết lý do ứng dụng Chat không thể hoàn tất yêu cầu sẽ giúp người dùng giải quyết vấn đề. Việc giải thích lý do xảy ra lỗi sẽ giúp xây dựng lòng tin.
• Cách người dùng có thể tiếp tục để đạt được mục tiêu. Chỉ nói vấn đề đã xảy ra là không đủ. Hãy cho người dùng biết cách vượt qua lỗi và hoàn thành mục tiêu.
• Cách được trợ giúp. Nếu người dùng vẫn gặp khó khăn, hãy cho họ biết cách được trợ giúp thêm. Đây có thể là lệnh /help hoặc đường liên kết đến tài liệu cho ứng dụng Chat của bạn.

Ví dụ về thông báo lỗi: định dạng ngày không chính xác

Trong ví dụ này, người dùng đã nhập ngày ở định dạng mà ứng dụng Chat không mong đợi. Họ đã viết November 19, 2021, nhưng ứng dụng Chat mong đợi 2021-11-19.

Dưới đây là phiên bản có thể xử lý và không thể xử lý của thông báo lỗi mà ứng dụng Chat phản hồi:

Lỗi có thể xử lý

Người dùng yêu cầu ứng dụng Chat lên lịch cuộc họp với một người khác. Ứng dụng Chat phản hồi bằng một thông báo lỗi hữu ích, có thể xử lý:

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

Thông báo lỗi này có thể xử lý vì những lý do sau:

• Cho biết vấn đề đã xảy ra. Ứng dụng Chat không nhận ra định dạng ngày.
• Giải thích cách khắc phục lỗi bằng cách cho người dùng biết định dạng ngày dự kiến và đưa ra một ví dụ về ngày giúp mọi người hiểu rõ những gì cần viết.
• Cung cấp thêm trợ giúp bằng lệnh dấu gạch chéo /help. Nếu vẫn gặp khó khăn, người dùng sẽ biết cách tìm hiểu thêm.

Lỗi không thể xử lý

Người dùng yêu cầu ứng dụng Chat lên lịch cuộc họp với một người khác. Ứng dụng Chat phản hồi bằng một thông báo lỗi không hữu ích, không thể xử lý:

Enter the correct date format.

Thông báo lỗi này không thể xử lý vì những lý do sau:

• Không cho biết liệu cuộc họp đã được lên lịch hay chưa. Người dùng có thể ngần ngại lên lịch lại cuộc họp hoặc có thể cho rằng cuộc họp đã được lên lịch.
• Không cho người dùng biết cách định dạng ngày. Thay vì cho rằng người dùng biết cách định dạng ngày, thông báo lỗi nên cho biết rằng ứng dụng đang mong đợi định dạng ngày yyyy-mm-dd.
• Không cung cấp thêm trợ giúp. Khi gặp khó khăn và không biết cách tiếp tục, người dùng có thể ngừng nhắn tin cho ứng dụng Chat.

Dùng thử

Bây giờ bạn đã biết cách viết thông báo lỗi có thể xử lý, bạn có thể xác định trong tình huống sau đây thông báo lỗi nào có thể xử lý:

Ứng dụng Chat tạo sự kiện trên lịch khi người dùng nhắn tin cho ứng dụng Chat bằng từ khoá schedule. Để tạo sự kiện trên lịch, ứng dụng Chat yêu cầu xác thực người dùng. Nếu người dùng chưa được xác thực, thì ứng dụng Chat sẽ phản hồi bằng một thông báo lỗi.