Menulis pesan error yang dapat ditindaklanjuti

Halaman ini menjelaskan praktik terbaik untuk menulis pesan {i>error<i} yang dapat ditindaklanjuti dan memberi tahu bagaimana cara memperbaiki masalah agar pengguna dapat menyelesaikan tujuan mereka.

Saat pengguna berinteraksi dengan aplikasi Google Chat, melalui pesan {i>error<i} dapat menjadi pengalaman yang menjengkelkan ketika kesalahan tidak dapat ditindaklanjuti. Misalnya, pesan error, An error occurred, tidak berguna karena tidak menjelaskan apa yang salah, bagaimana pengguna dapat memperbaiki masalah, atau bagaimana pengguna bisa mendapatkan bantuan. Halaman ini menjelaskan cara menyusun pesan {i>error<i} sehingga memberikan manfaat bagi pengguna dengan menunjukkan contoh yang dapat ditindaklanjuti dan tidak dapat ditindaklanjuti.

Struktur pesan error

Pesan error yang dapat ditindaklanjuti memiliki struktur berikut:

  • Apa yang salah. Mengatakan alasan aplikasi Chat tidak dapat menyelesaikan permintaan membantu pengguna menyelesaikan masalah. Menjelaskan mengapa terjadi kesalahan terjadi membangun kepercayaan.
  • Cara pengguna dapat mencapai sasaran mereka. Tidak akan pernah cukup untuk mengatakan apa yang salah. Beri tahu pengguna bagaimana mereka dapat melewati kesalahan dan menyelesaikannya tujuan mereka.
  • Cara mendapatkan bantuan. Jika pengguna masih terjebak, beri tahu mereka bagaimana mereka bisa sampai bantuan lainnya. 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 yang tidak diharapkan oleh aplikasi Chat. Mereka menulis November 19, 2021, tetapi aplikasi Chat mengharapkan 2021-11-19.

Berikut adalah versi pesan {i>error<i} yang dapat ditindaklanjuti dan tidak dapat ditindaklanjuti Aplikasi Chat merespons dengan:

Error yang dapat ditindaklanjuti

Pengguna meminta aplikasi Chat untuk menjadwalkan rapat dengan orang lain. Aplikasi Chat merespons dengan pesan {i>error<i} yang 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`.

Contoh pesan error yang memberi tahu pengguna tentang masalah yang terjadi, cara melanjutkan, dan cara mendapatkan bantuan.

Pesan error ini dapat ditindaklanjuti karena alasan berikut:

  • Mengatakan 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 lebih lanjut dengan perintah garis miring /help. Jika pengguna masih terjebak, mereka tahu cara untuk mempelajarinya lebih lanjut.

Error yang tidak dapat ditindaklanjuti

Pengguna meminta aplikasi Chat untuk menjadwalkan rapat dengan orang lain. Aplikasi Chat merespons dengan pesan {i>error<i} yang tidak membantu dan tidak dapat ditindaklanjuti:

Enter the correct date format.

Contoh pesan error yang tidak memberikan informasi yang dapat ditindaklanjuti.

Pesan error ini tidak dapat ditindaklanjuti karena alasan berikut:

  • Tidak menyatakan apakah rapat dijadwalkan atau tidak. Pengguna mungkin ragu untuk menjadwalkan ulang pertemuan, atau mereka mungkin beranggapan bahwa pertemuan itu dijadwalkan.
  • Tidak memberi tahu pengguna cara memformat tanggal. Alih-alih berasumsi bahwa pengguna mengetahui cara memformat tanggal, seharusnya tertulis bahwa tanggal format tanggal yyyy-mm-dd.
  • Tidak menawarkan bantuan lebih lanjut. Ketika pengguna terjebak dan tidak tahu bagaimana melanjutkan, mereka mungkin berhenti mengirim pesan ke aplikasi Chat.

Cobalah

Setelah Anda mengetahui cara menulis {i>error<i} yang dapat ditindaklanjuti, dapatkah Anda mengidentifikasi error berikut yang dapat ditindaklanjuti:

Aplikasi Chat membuat acara kalender saat pengguna mengirim pesan aplikasi Chat dengan kata kunci schedule. Kepada membuat acara kalender, aplikasi Chat mengharuskan autentikasi. Jika seorang pengguna belum diotentikasi, maka Aplikasi Chat merespons dengan pesan error.

Pesan error mana yang dapat ditindaklanjuti?
Sebelum saya bisa jadwalkan rapat, Anda harus login dengan mengetik /signin. Untuk mempelajari lebih lanjut, ketik /help.
Pesan error ini dapat ditindaklanjuti karena menyatakan hal berikut:
  • Apa yang salah. Aplikasi Chat memerlukan autentikasi.
  • Cara melanjutkan. Ketikkan /signin untuk mengautentikasi.
  • Cara mendapatkan bantuan. Jika pengguna menginginkan lebih banyak informasi, mereka dapat mengetik /help.
Anda harus melakukan autentikasi.
Pesan {i>error<i} ini tidak dapat ditindaklanjuti karena tidak disebutkan bagaimana melakukan otentikasi.
Login
Pesan error ini tidak dapat ditindaklanjuti karena tidak disebutkan cara menandatangani di dalamnya, dan ini menyiratkan bahwa pengguna telah {i>logout<i} alih-alih mengatakan dengan jelas Jadi, hal ini membingungkan.
Tidak dapat menjadwalkan rapat.
Pesan error ini tidak dapat ditindaklanjuti karena tidak memberi tahu pengguna mengapa rapat tidak bisa dijadwalkan atau bagaimana pengguna dapat melanjutkan. Tidak ada bantuan disediakan.