Halaman ini menjelaskan praktik terbaik untuk menulis pesan error yang dapat ditindaklanjuti yang memberi tahu pengguna cara memperbaiki masalah sehingga mereka dapat menyelesaikan tujuan mereka.
Saat pengguna berinteraksi dengan aplikasi Google Chat, mendapatkan
pesan error dapat menjadi pengalaman yang menjengkelkan jika error tidak dapat ditindaklanjuti.
Misalnya, pesan error, An error occurred, tidak berguna karena
pesan tidak menjelaskan masalah yang terjadi, cara pengguna memperbaiki masalah, atau cara
pengguna mendapatkan bantuan. Halaman ini menjelaskan cara menyusun pesan error agar bermanfaat bagi pengguna dengan menampilkan contoh yang dapat ditindaklanjuti dan tidak dapat ditindaklanjuti.
Struktur pesan error
Pesan error yang dapat ditindaklanjuti memiliki struktur berikut:
- Apa yang salah. Menyatakan alasan aplikasi Chat tidak dapat menyelesaikan permintaan akan membantu pengguna menyelesaikan masalah tersebut. Menjelaskan mengapa kesalahan terjadi dapat membangun kepercayaan.
- Bagaimana pengguna dapat melanjutkan pencapaian sasarannya. Tidak pernah cukup untuk hanya mengatakan apa yang salah. Beri tahu pengguna cara melewati error dan menyelesaikan tujuan mereka.
- Cara mendapatkan bantuan. Jika pengguna masih mengalami kesulitan, beri tahu cara mendapatkan
bantuan lebih lanjut. Link ini dapat berupa perintah
/helpatau link ke dokumentasi untuk aplikasi Chat Anda.
Contoh pesan error: format tanggal salah
Dalam contoh ini, pengguna memasukkan tanggal dalam format yang tidak diharapkan oleh aplikasi Chat. Mereka menulis
November 19, 2021, tetapi aplikasi Chat mengharapkan
2021-11-19.
Berikut adalah versi pesan error yang dapat ditindaklanjuti dan tidak dapat ditindaklanjuti yang direspons oleh aplikasi Chat:
Error yang dapat ditindaklanjuti
Pengguna meminta aplikasi Chat untuk menjadwalkan rapat dengan orang lain. Aplikasi Chat merespons dengan pesan error yang baik dan dapat ditindaklanjuti:
I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.
Pesan error ini dapat ditindaklanjuti karena alasan berikut:
- Mengatakan masalah yang terjadi. Aplikasi Chat tidak mengenali format tanggal.
- Menjelaskan cara memperbaiki error dengan memberi tahu pengguna format tanggal yang diharapkan dan memberikan contoh tanggal yang membantu pengguna memahami informasi yang harus ditulis.
- Menawarkan bantuan lebih lanjut dengan perintah garis miring
/help. Jika pengguna masih terjebak, mereka tahu cara mempelajari lebih lanjut.
Error yang tidak dapat ditindaklanjuti
Pengguna meminta aplikasi Chat untuk menjadwalkan rapat dengan orang lain. Aplikasi Chat merespons dengan pesan error yang tidak membantu dan tidak dapat ditindaklanjuti:
Enter the correct date format.
Pesan error ini tidak dapat ditindaklanjuti karena alasan berikut:
- Tidak menyebutkan apakah fitur menjadwalkan rapat. Pengguna mungkin ragu untuk menjadwalkan ulang rapat, atau mereka mungkin berasumsi bahwa rapat tersebut telah dijadwalkan.
- Tidak memberi tahu pengguna cara memformat tanggal. Alih-alih berasumsi bahwa
pengguna tahu cara memformat tanggal, sebaiknya aplikasi mengharapkan
format tanggal
yyyy-mm-dd. - Tidak menawarkan bantuan lainnya. Saat pengguna mengalami masalah dan tidak tahu cara melanjutkan, mereka mungkin berhenti mengirim pesan ke aplikasi Chat.
Cobalah
Setelah mengetahui cara menulis error yang dapat ditindaklanjuti, dapatkah Anda mengidentifikasi error mana yang dapat ditindaklanjuti dalam skenario berikut:
Aplikasi Chat membuat acara kalender saat pengguna mengirim pesan ke aplikasi Chat dengan kata kunci schedule. Untuk
membuat acara kalender, aplikasi Chat memerlukan autentikasi
pengguna. Jika pengguna belum diautentikasi, aplikasi Chat akan merespons dengan pesan error.
/signin. Untuk mempelajari lebih lanjut, ketik /help.- Apa yang salah. Aplikasi Chat memerlukan autentikasi.
- Cara melanjutkan. Ketik
/signinuntuk mengautentikasi. - Cara mendapatkan bantuan. Jika pengguna menginginkan informasi selengkapnya, mereka dapat mengetik
/help.