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ý nhằm 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 một ứng dụng Google Chat, việc nhận được thông báo lỗi có thể khiến người dùng 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 lỗi, 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 sao cho thông báo lỗi đó hữu ích cho người dùng bằng cách hiển thị các ví dụ thiết thực và không thực hiện được.

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 lỗi xảy ra 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 của họ. Chỉ cần nói điều gì đó đã xảy ra là đủ. Hãy 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 cò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 dành cho ứng dụng trong 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 một 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 yêu cầu 2021-11-19.

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

Lỗi có thể xử lý

Một người dùng yêu cầu ứng dụng Chat đặt lịch 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ợp lý và có thể xử lý được:

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

Ví dụ về thông báo lỗi cho người dùng biết đã xảy ra lỗi gì, cách tiếp tục và cách nhận trợ giúp.

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

  • Cho biết đã xảy ra sự cố gì. Ứng dụng Chat không nhận ra định dạng ngày.
  • Giải thích cách sửa lỗi bằng cách cho người dùng biết định dạng ngày dự kiến và đưa ra ngày ví dụ để giúp mọi người hiểu nên viết gì.
  • Cung cấp thêm sự trợ giúp bằng lệnh dấu gạch chéo /help. Nếu người dùng vẫn gặp khó khăn, họ sẽ 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 đặt lịch 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ể thực hiện được:

Enter the correct date format.

Ví dụ về thông báo lỗi không cung cấp thông tin hữu ích.

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

  • Không cho biết liệu cuộc họp có đã lên lịch 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, hệ thống sẽ cho biết rằng họ đang đợi định dạng ngày là yyyy-mm-dd.
  • Không cung cấp thêm sự trợ giúp. Khi người dùng bị 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ờ, khi đã biết cách viết các lỗi có thể xử lý, bạn có thể xác định lỗi nào sau đây là lỗi 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 cho ứng dụng Chat bằng từ khoá schedule. Để tạo một sự kiện trên lịch, ứng dụng Chat yêu cầu người dùng phải xác thực. 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.

Thông báo lỗi nào có thể xử lý được?
Để tôi có thể lên lịch cuộc họp, bạn phải đăng nhập bằng cách nhập /signin. Để tìm hiểu thêm, hãy nhập /help.
Bạn có thể xử lý thông báo lỗi này vì có nội dung như sau:
  • Đã xảy ra lỗi. Ứng dụng Chat yêu cầu xác thực.
  • Cách tiếp tục. Nhập /signin để xác thực.
  • Cách nhận trợ giúp. Nếu muốn biết thêm thông tin, người dùng có thể nhập /help.
Bạn phải xác thực.
Thông báo lỗi này không xử lý được vì không nêu cách xác thực.
Đăng nhập.
Thông báo lỗi này không xử lý được vì không nêu cách đăng nhập và ngụ ý rằng người dùng đã đăng xuất thay vì thông báo rõ ràng nên điều này gây nhầm lẫn.
Không thể lên lịch cuộc họp.
Thông báo lỗi này không xử lý được vì không cho người dùng biết lý do không thể lên lịch cuộc họp hoặc cách người dùng có thể tiếp tục. Không nhận được sự trợ giúp.