Menulis pesan error yang dapat ditindaklanjuti

Halaman ini menjelaskan praktik terbaik untuk menulis pesan error yang dapat ditindaklanjuti yang memberi tahu pengguna cara memperbaiki masalah sehingga mereka dapat menyelesaikan tujuannya.

Saat pengguna berinteraksi dengan aplikasi Google Chat, munculnya pesan error dapat menjadi pengalaman yang menjengkelkan jika error tersebut tidak dapat ditindaklanjuti. Misalnya, pesan error, An error occurred, tidak berguna karena pesan tidak menjelaskan apa yang salah, cara pengguna dapat memperbaiki masalah, atau cara pengguna mendapatkan bantuan. Halaman ini menjelaskan cara menyusun pesan error agar berguna 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 mengapa aplikasi Chat tidak dapat menyelesaikan permintaan akan membantu pengguna menyelesaikan masalah tersebut. Menjelaskan alasan terjadinya error membangun kepercayaan.
• Cara pengguna dapat melanjutkan untuk mencapai tujuannya. Tidak cukup hanya mengatakan apa yang salah. Beri tahu pengguna cara mengatasi error dan menyelesaikan tujuan mereka.
• Cara mendapatkan bantuan. Jika pengguna masih mengalami masalah, beri tahu mereka cara mendapatkan bantuan lebih lanjut. Ini bisa berupa perintah /help atau 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 ditampilkan 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:

• Menyatakan apa yang salah. Aplikasi Chat tidak mengenali format tanggal.
• Menjelaskan cara memperbaiki error dengan memberi tahu pengguna format tanggal yang diharapkan dan memberikan contoh tanggal yang membantu orang memahami apa yang harus ditulis.
• Menawarkan bantuan lainnya dengan perintah garis miring /help. Jika pengguna masih mengalami masalah, 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 mengatakan apakah dia menjadwalkan rapat. Pengguna mungkin enggan menjadwalkan ulang rapat, atau mereka mungkin menganggap bahwa rapat telah dijadwalkan.
• Tidak memberi tahu pengguna cara memformat tanggal. Daripada mengasumsikan bahwa pengguna tahu cara memformat tanggal, sebaiknya tulis bahwa format tanggal yang diharapkan adalah yyyy-mm-dd.
• Tidak menawarkan bantuan lebih lanjut. Jika pengguna mengalami kebuntuan dan tidak tahu cara melanjutkan, mereka mungkin berhenti mengirim pesan ke aplikasi Chat.

Cobalah

Sekarang setelah Anda mengetahui cara menulis error yang dapat ditindaklanjuti, dapatkah Anda mengidentifikasi dalam skenario berikut, mana di antara error ini yang dapat ditindaklanjuti:

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.