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 hữu ích, 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 của mình.

Khi người dùng đang tương tác với ứng dụng Google Chat, việc gặp phải thông báo lỗi có thể gây khó chịu khi lỗi đó không thể xử lý được. 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 đề 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ể yêu cầu trợ giúp. Trang này mô tả cách định cấu trúc thông báo lỗi để thông báo đó hữu ích cho người dùng bằng cách đưa ra các ví dụ có thể hành động và không thể hành động.

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:

• Đã xảy ra lỗi. 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 tạo dựng niềm tin.
• Cách người dùng có thể tiến tới mục tiêu của họ. Bạn không bao giờ chỉ có thể nói về lỗi xảy ra. Cho người dùng biết cách khắc phục lỗi và hoàn thành mục tiêu.
• Cách yêu cầu trợ giúp. Nếu người dùng vẫn gặp khó khăn, hãy cho họ biết cách yêu cầu 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.

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 theo định dạng mà ứng dụng Chat không mong đợi. Họ đã viết November 19, 2021, nhưng ứng dụng Chat lại mong đợi 2021-11-19.

Dưới đây là phiên bản có thể hành động và không thể hành động 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ể hành động:

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 vấn đề đã xảy ra. Ứng dụng Chat không nhận dạng được đị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 ngày mẫu để giúp mọi người hiểu rõ nội dung 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 và không thể hành động:

Enter the correct date format.

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

• Không cho biết liệu ứng dụng có lên lịch cuộc họp hay không. Người dùng có thể do dự trong việc 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ì giả định rằng người dùng biết cách định dạng ngày, bạn nên cho biết rằng bạn đang chờ định dạng ngày yyyy-mm-dd.
• Không cung cấp thêm sự 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ử

Giờ đây, bạn đã biết cách viết lỗi có thể xử lý. Bạn có thể xác định trong trường hợp sau đây 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 thông báo lỗi.