Trang này mô tả các phương pháp hay nhất để viết thông báo lỗi có thể hành động, 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 người dùng tương tác với một ứng dụng Google Chat, việc gặp phải thông báo lỗi có thể gây khó chịu nếu lỗi đó 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ể nhận đượ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 đó hữu ích cho người dùng bằng cách cho thấy 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 khiến ứng dụng Chat không thể hoàn tất mộ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ến tới mục tiêu của mình. Chỉ nói về những gì đã xảy ra là chưa đủ. Cho người dùng biết cách họ có thể 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 vấn đề, hãy cho họ biết cách họ có thể được trợ giúp thêm. Đây có thể là lệnh
/helphoặ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.
Sau đây là phiên bản có thể thực hiện và không thể thực hiện của thông báo lỗi 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 lên lịch cuộc 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 hữu ích và có thể thực hiện 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ể thực hiện hành động đối với 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 ví dụ về ngày để giúp mọi người hiểu được nội dung cần viết.
- Cung cấp thêm thông tin 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ể khắc phục
Một 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ể thực hiện hành động:
Enter the correct date format.
Bạn không thể làm gì khi gặp thông báo lỗi này vì những lý do sau:
- Không cho biết liệu yêu cầu có lên lịch cuộc họp hay không. Người dùng có thể do dự khi 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 mong đợi định dạng ngày
yyyy-mm-dd. - Không hỗ trợ thêm. 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 lỗi có thể xử lý, bạn có thể xác định trong tình huống sau đây lỗi nào trong số những lỗi này 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 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 sẽ phản hồi bằng một thông báo lỗi.
/signin. Để tìm hiểu thêm, hãy nhập /help.- Đã xảy ra lỗi. Ứng dụng Chat yêu cầu xác thực.
- Cách tiến hành. 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.