Yang Harus Dikatakan Aplikasi Anda Saat Rusak: Menulis Pesan Error yang Benar-Benar Dipahami Orang

Setiap aplikasi pasti pernah rusak. Internet terputus, server bermasalah sesaat, seseorang mengetik nomor telepon dengan huruf di dalamnya. Bagian itu tidak bisa sepenuhnya Anda cegah. Yang bisa Anda kendalikan adalah pesan error — teks yang ditampilkan aplikasi Anda saat terjadi kesalahan — dan satu pesan itu sering kali menjadi pembeda antara pengguna yang hanya mengangkat bahu lalu mencoba lagi, dengan pengguna yang diam-diam memutuskan aplikasi Anda rusak dan tidak pernah kembali.

Sebagian besar aplikasi buatan AI salah menangani momen ini. Bukan karena pembuatnya ceroboh, tapi karena pesan error adalah bagian yang tidak dipikirkan siapa pun sampai ada yang salah di depan orang sungguhan. Secara default, aplikasi cenderung menampilkan salah satu dari dua hal terburuk: tidak menampilkan apa-apa sama sekali, atau blok teks teknis yang menakutkan. Mari kita perbaiki keduanya.

Mengapa aplikasi gagal secara diam-diam atau menampilkan pesan error yang menakutkan?

Aplikasi rusak dengan buruk dengan salah satu dari dua cara: tidak mengatakan apa-apa saat sesuatu gagal, atau menampilkan error teknis yang tidak bisa dibaca orang awam. Keduanya membuat pengguna menebak-nebak, dan menebak-nebak itulah yang membuat orang menyerah.

Kegagalan diam-diam. Seorang pekerja lepas yang akan saya sebut Maya membuat formulir pemesanan untuk bisnis fotografinya. Seorang klien mengetuk “Konfirmasi Pemesanan,” tombolnya berkedip, lalu… tidak ada apa-apa. Tidak ada konfirmasi, tidak ada error, tidak ada spinner. Apakah berhasil? Klien itu tidak yakin, jadi dia memesan lagi. Sekarang Maya punya dua pemesanan untuk slot yang sama dan seorang pelanggan yang kebingungan. Aplikasinya tidak crash — penyimpanannya saja yang gagal, dan aplikasi tidak mengatakan apa-apa, sehingga orang yang ada di depannya sama sekali tidak tahu apa yang sebenarnya terjadi.

Error teknis yang menakutkan. Kegagalan yang satu ini lebih mencolok dan entah bagaimana lebih buruk. Seorang relawan yang mengurus penggalangan dana komunitas mencoba mengunggah spreadsheet dan mendapat kotak merah bertuliskan Error 500: Internal Server Error. Dia membacanya sebagai “saya telah merusak sesuatu.” Dia tidak mencoba lagi, tidak mengirim email untuk minta bantuan, hanya menutup tab — karena pesan itu membuat masalahnya terdengar seperti kesalahannya sendiri dan seolah tidak aman untuk disentuh lagi.

Kedua pengguna ini mengalami masalah yang normal dan bisa dipulihkan. Keduanya pergi, karena pesan error aplikasi tidak mengatakan apa-apa atau mengatakan sesuatu yang menakutkan.

Apa yang membuat pesan error itu baik?

Pesan error yang baik melakukan empat hal kecil, dengan kata-kata sederhana: menjelaskan apa yang terjadi, menjelaskan itu masalah siapa, menjelaskan apa yang harus dilakukan selanjutnya, dan tidak menghilangkan pekerjaan pengguna.

1. Menjelaskan apa yang terjadi — “Kami tidak bisa menyimpan pemesanan Anda,” bukan diam saja dan bukan 500.
2. Menjelaskan itu masalah siapa — biasanya jawaban jujurnya adalah “kami,” dan mengatakannya membuat orang lebih tenang.
3. Menjelaskan apa yang harus dilakukan selanjutnya — “Coba lagi sesaat lagi” atau “Periksa koneksi internet Anda lalu coba lagi.”
4. Tidak menghilangkan pekerjaan mereka — apa pun yang mereka ketik masih ada di formulir saat pesan itu muncul.

Itu saja. Tidak perlu esai permintaan maaf, tidak perlu kode error sebagai judul utama, tidak perlu menyalahkan. Berikut tiga kegagalan yang sama, ditulis ulang:

• ❌ (tidak terjadi apa-apa) → ✅ “Kami tidak bisa menyimpan itu barusan. Detail Anda masih ada di sini — ketuk Konfirmasi untuk mencoba lagi.”
• ❌ Error 500: Internal Server Error → ✅ “Ada yang salah di sistem kami saat mengunggah file itu. Ini bukan salah Anda. Coba lagi dalam satu menit.”
• ❌ Invalid input → ✅ “Nomor telepon itu sepertinya kurang tepat — seharusnya 10 digit, seperti 555-123-4567.”

Perhatikan yang terakhir menunjuk ke kolom yang spesifik dan menunjukkan seperti apa yang benar. “Invalid input” membuat orang harus mencari-cari; “nomor telepon itu seharusnya 10 digit” memberi tahu mereka persis apa yang harus diubah.

Error aplikasi mana yang harus Anda perbaiki lebih dulu?

Anda tidak perlu pesan khusus untuk setiap kemungkinan kegagalan — tiga hal ini mencakup hampir semua yang bisa salah pada aplikasi biasa: penyimpanan atau pengiriman yang gagal, input yang tidak bisa digunakan aplikasi, dan hal yang rusak di sisi Anda.

Penyimpanan atau pengiriman yang gagal. Ini yang paling merusak kepercayaan, karena pengguna sudah melakukan semuanya dengan benar dan tidak yakin apakah berhasil. Selalu konfirmasi keberhasilan dan jelaskan kegagalan. Jangan pernah biarkan mereka menebak-nebak, dan jangan pernah membuang apa yang sudah mereka ketik.

“Kami tidak bisa menggunakan apa yang Anda ketik” (validasi). Ini sebenarnya bukan error — ini kesalahpahaman. Tangkap begitu mereka meninggalkan kolom itu, tunjuk ke kolom yang tepat, dan tunjukkan contoh format yang benar. Jangan tunggu sampai mereka menekan Kirim untuk memunculkan tembok merah.

“Ada yang rusak di sisi kami.” Masalah server atau jaringan yang sesungguhnya. Katakan itu di sisi Anda, tetap tenang, dan beri mereka opsi coba lagi. Pengguna tidak bisa memperbaiki server Anda, jadi jangan buat mereka merasa harus melakukannya.

Tiga kebiasaan yang diam-diam membantu

Ada beberapa hal yang membedakan aplikasi yang menangani kegagalan dengan baik dari yang tidak:

• Jangan pernah menampilkan kode error mentah sebagai keseluruhan pesan. Kode bisa diletakkan dalam teks kecil di bawah untuk keperluan dukungan, tapi judul utama yang dibaca manusia harus berupa kalimat, bukan ERR_CONN_RESET.
• Jangan pernah menyalahkan pengguna. “Anda memasukkan sesuatu yang salah” terasa menyakitkan; “tanggal itu sepertinya sudah lewat — maksud Anda bulan depan?” justru membantu. Informasinya sama, tapi kesannya sama sekali berbeda.
• Selalu simpan input mereka. Jika aplikasi memuat ulang atau penyimpanan gagal dan formulirnya jadi kosong, Anda telah mengubah gangguan kecil menjadi sepuluh menit mengetik ulang. Orang bisa memaafkan penyimpanan yang gagal. Mereka tidak akan memaafkan harus mengerjakan hal yang sama dua kali.

Bagaimana cara membuat AI builder Anda menulis pesan error yang lebih baik?

Anda bisa mendapatkan sebagian besar dari ini dalam satu permintaan — tempel sesuatu seperti prompt di bawah ini dan AI builder Anda akan menerapkan aturan bahasa sederhana di atas ke seluruh aplikasi Anda.

“Saat penyimpanan atau unggahan gagal, jangan gagal secara diam-diam dan jangan tampilkan kode error teknis. Tampilkan pesan singkat dan ramah dalam bahasa sederhana yang menjelaskan apa yang terjadi, mengatakan bahwa tidak apa-apa untuk mencoba lagi, dan menyimpan apa pun yang sudah diketik pengguna. Untuk kolom formulir, validasi saat pengguna meninggalkan setiap kolom dan tampilkan pesan spesifik dengan contoh format yang benar.”

Lalu minta ia menjelaskan apa yang terjadi dalam tiga kasus: internet mati, kolom wajib kosong, dan server lambat. Jika jawaban untuk salah satunya adalah “tidak menampilkan apa-apa” atau “menampilkan error mentah,” itulah perbaikan berikutnya yang harus Anda lakukan.

Bagaimana cara menguji pesan error aplikasi Anda?

Matikan wifi Anda, buka aplikasi Anda, dan coba lakukan hal utamanya — itulah keseluruhan pengujiannya, dan hanya butuh dua menit.

Pesan slot-nya, simpan catatannya, unggah filenya. Perhatikan apa yang ditampilkan. Apakah itu memberi tahu sesuatu yang bisa dipahami orang awam? Apakah itu menghilangkan apa yang sudah Anda ketik? Sekarang nyalakan kembali wifi dan sengaja ketik hal ngawur ke sebuah kolom. Pertanyaan yang sama.

Sebagian besar aplikasi gagal dalam pengujian ini pada percobaan pertama, dan itu tidak masalah — itu justru menunjukkan persis di mana Anda harus mulai. Anda tidak harus membuat setiap pesan error jadi sempurna. Temukan satu hal di aplikasi Anda yang paling sering rusak, dan jadikan pesan itu ramah, jelas, dan jujur terlebih dahulu. Lain kali orang sungguhan mengalaminya, mereka akan mencoba lagi, bukan pergi — dan mencoba lagi itulah inti dari semuanya.