Menulis pesan error yang dapat ditindaklanjuti

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

Saat pengguna berinteraksi dengan aplikasi Google Chat, 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:

• Yang salah. Menjelaskan alasan aplikasi Chat tidak dapat menyelesaikan permintaan akan membantu pengguna menyelesaikan masalah. Menjelaskan alasan terjadinya error akan membangun kepercayaan.
• Cara pengguna dapat melanjutkan ke tujuan mereka. 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 dapat 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 direspons oleh aplikasi Chat:

Error yang dapat ditindaklanjuti

Pengguna meminta aplikasi Chat untuk menjadwalkan rapat dengan seseorang 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:

• Menjelaskan 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 orang memahami apa yang harus ditulis.
• Menawarkan bantuan lainnya dengan perintah garis miring /help. Jika masih mengalami masalah, pengguna akan tahu cara mempelajari lebih lanjut.

Error yang tidak dapat ditindaklanjuti

Pengguna meminta aplikasi Chat untuk menjadwalkan rapat dengan seseorang 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 rapat dijadwalkan atau tidak. Pengguna mungkin ragu untuk menjadwalkan ulang rapat, atau mereka mungkin berasumsi bahwa rapat telah dijadwalkan.
• Tidak memberi tahu pengguna cara memformat tanggal. Alih-alih mengasumsikan bahwa pengguna tahu cara memformat tanggal, seharusnya kode ini menyatakan bahwa kode ini mengharapkan format tanggal yyyy-mm-dd.
• Tidak menawarkan bantuan lebih lanjut. Jika 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 dalam skenario berikut error mana 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.