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 các thông báo lỗi có thể xử lý để cho biết người dùng cách khắc phục vấn đề để họ có thể hoàn thành mục tiêu của mình.

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

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

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

• Đã xảy ra lỗi. Đưa ra lý do khiến ứ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 đề. Giải thích nguyên nhân xảy ra lỗi xảy ra thì tạo dựng được lòng tin.
• Cách người dùng có thể đạt được mục tiêu của mình. Không bao giờ là đủ nếu chỉ nói xem đã xảy ra sự cố gì. Cho người dùng biết cách họ có thể vượt qua lỗi và hoàn tất mục tiêu của mình.
• Cách yêu cầu trợ giúp. Nếu người dùng vẫn còn gặp sự cố, hãy chỉ cho họ cách truy cập để đượ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 dành cho ứng dụng Chat.

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 ứng dụng Chat không như mong đợi. Họ đã viết November 19, 2021, nhưng ứng dụng Chat dự kiến 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 sẽ phản hồi bằng:

Lỗi có thể xử lý

Một người dùng yêu cầu ứng dụng Chat lên lịch họp với một người khác. Ứng dụng Chat đưa ra phản hồi hữu ích thông báo lỗi 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`.

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

• Cho biết lỗi. Ứ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 tháng để giúp mọi người hiểu nội dung cần viết.
• Cung cấp thêm sự trợ giúp với lệnh dấu gạch chéo /help. Nếu người dùng vẫn còn gặp khó khăn, họ biết cách tìm hiểu thêm.

Lỗi không xử lý được

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

Enter the correct date format.

Thông báo lỗi này không thể thực hiện được vì những lý do sau:

• Không cho biết liệu cuộc họp có được lên lịch hay không. Người dùng có thể do dự hãy lên lịch lại cuộc họp hoặc họ 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, phải thể hiện rằng nó mong đợi định dạng ngày yyyy-mm-dd.
• Không giúp được gì thêm. Khi người dùng bị mắc kẹt và không biết cách tiếp tục, họ 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 các lỗi có thể xử lý, bạn có thể xác định trong tình huống sau đây, những lỗi nào sau đây có thể xử lý được:

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