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 tujuan mereka.

Saat pengguna berinteraksi dengan aplikasi Google Chat, menemukan pesan error bisa menjadi pengalaman yang menjengkelkan jika error tidak dapat ditindaklanjuti. Misalnya, pesan error, An error occurred, tidak berguna karena pesan tersebut tidak menjelaskan masalah yang terjadi, cara pengguna memperbaiki masalah, atau cara pengguna dapat memperoleh bantuan. Halaman ini menjelaskan cara menyusun pesan error sehingga bermanfaat bagi pengguna dengan menampilkan contoh yang dapat ditindaklanjuti dan tidak dapat ditindaklanjuti.

Struktur pesan error

Pesan error yang dapat ditindaklanjuti memiliki struktur berikut:

• Masalah yang terjadi. Mengatakan alasan aplikasi Chat tidak dapat menyelesaikan permintaan akan membantu pengguna menyelesaikan masalah tersebut. Menjelaskan mengapa kesalahan terjadi dapat membangun kepercayaan.
• Cara pengguna dapat mencapai tujuannya. Tidak pernah cukup untuk hanya mengatakan apa yang salah. Beri tahu pengguna bagaimana mereka dapat melewati kesalahan dan menyelesaikan tujuan mereka.
• Cara mendapatkan bantuan. Jika pengguna masih mengalami masalah, beri tahu mereka cara mendapatkan bantuan lebih lanjut. Hal 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 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 masalahnya. 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 apa yang harus ditulis.
• Menawarkan bantuan lebih lanjut dengan perintah garis miring /help. Jika pengguna masih terjebak, mereka tahu cara untuk 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 rapat menjadwalkan rapat 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 pengguna mengharapkan format tanggal yyyy-mm-dd.
• Tidak menawarkan bantuan lainnya. Saat pengguna mengalami kebuntuan dan tidak tahu cara melanjutkan, mereka mungkin akan berhenti mengirim pesan ke aplikasi Chat.

Cobalah

Setelah mengetahui cara menulis error yang dapat ditindaklanjuti, dalam skenario berikut, manakah dari error berikut 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.