Pesan eror yang mengurangi tiket dukungan untuk aplikasi bisnis
Pelajari cara menulis pesan eror yang mengurangi tiket dukungan dengan membuat masalah validasi dan izin jelas, dapat ditindaklanjuti, dan aman untuk pengguna bisnis.

Mengapa pesan eror yang tidak jelas menimbulkan lebih banyak tiket dukungan
Pesan eror yang tidak jelas bukan hanya menyebalkan. Mereka menghentikan orang di tengah tugas, dan pengguna tidak punya langkah selanjutnya yang jelas.
Seorang pengguna bisnis biasanya tidak mencoba “mendebug” aplikasi. Mereka berusaha mengirimkan formulir, menyetujui permintaan, atau memperbarui catatan pelanggan. Ketika pesan mengatakan sesuatu seperti “Invalid input” atau “Access denied,” pengguna tidak tahu apa yang salah, apa yang harus diubah, atau siapa yang bisa memperbaikinya.
Ketidakpastian ini berubah menjadi tiket dukungan. Pertama pengguna melaporkan masalah dengan sedikit detail. Lalu dukungan meminta screenshot, langkah tepatnya, catatan yang sedang diedit, dan waktu kejadian. Pengguna menjawab nanti, seringkali setelah mereka sudah pindah ke tugas lain. Sementara itu, pekerjaan terblokir.
Inilah sebabnya pesan eror yang mengurangi tiket dukungan berfokus pada tindakan, bukan pada menyalahkan. Mereka membantu orang di depan layar menyelesaikan masalah segera, atau setidaknya mengarahkan masalah ke jalur yang benar tanpa bolak-balik lama.
Dua jenis eror menyebabkan sebagian besar tiket “Saya tersangkut” di aplikasi bisnis:
- Eror validasi: pengguna bisa memperbaikinya dengan mengubah data yang dimasukkan (field wajib kosong, format salah, nilai di luar rentang).
- Eror izin: pengguna tidak bisa memperbaikinya sendiri karena akses diatur (batasan peran, aturan kepemilikan catatan, hak persetujuan yang hilang).
Jika ditulis buruk, keduanya terasa sama bagi pengguna. Keduanya tampak seperti jalan buntu.
Pesan yang jelas menciptakan jalur pendek ke depan. Ia menjawab beberapa pertanyaan praktis:
- Apa yang tepatnya salah (dengan kata-kata sederhana)?
- Di mana masalahnya (field mana, catatan mana, langkah mana)?
- Apa yang bisa saya lakukan sekarang (memperbaiki, meminta akses, mencoba lagi nanti)?
- Jika saya butuh bantuan, detail apa yang harus saya kirim?
Contoh: di alat internal yang dibangun dengan platform seperti AppMaster, seorang pengguna mencoba membuat vendor baru. “Error 400” memaksa membuat tiket. “Tax ID must be 9 digits. You entered 8.” menyelesaikan pekerjaan dalam beberapa detik.
Artikel ini berfokus pada menulis ulang pesan validasi dan izin agar pengguna bisnis bisa memecahkan masalah umum tanpa akses khusus atau pengetahuan admin tersembunyi.
Eror validasi vs eror izin: apa yang dirasakan pengguna
Eror validasi terjadi ketika data yang dimasukkan seseorang tidak bisa diterima. Pengguna berusaha melakukan hal yang benar, tetapi sebuah field kosong, format salah, atau nilai berada di luar rentang yang diperbolehkan. Pesan validasi yang baik terasa seperti dorongan yang membantu karena perbaikannya biasanya ada di layar yang sama.
Momen validasi umum terlihat seperti ini:
- Field wajib kosong (mis. Nama Pelanggan)
- Nilai dalam format yang salah (email, telepon, tanggal)
- Angka di luar rentang (diskon lebih dari 100%, kuantitas kurang dari 1)
- Teks terlalu panjang (catatan melebihi batas)
- Pilihan tidak valid (status yang tidak diizinkan)
Eror izin berbeda. Mereka terjadi ketika pengguna tidak diizinkan melakukan sesuatu, walau datanya valid. Itu bisa karena pembatasan peran (viewer vs manager), aturan kepemilikan (hanya pemilik catatan yang bisa mengedit), atau kebijakan bisnis (hanya tim keuangan yang bisa mengembalikan dana). Pengguna sering tidak bisa memperbaikinya sendiri, itulah sebabnya eror izin bisa menimbulkan frustrasi lebih besar.
Pesan izin yang ditulis jelek bisa terasa personal: “Access denied” terdengar seperti sistem menghakimi pengguna, bukan menjelaskan aturan. Mereka juga bisa membingungkan karena tidak ada yang berubah di layar. Pengguna melakukan aksi yang sama kemarin, dan hari ini gagal, jadi mereka mengira aplikasi rusak dan membuka tiket.
Pesan terbaik bergantung pada siapa yang melihatnya. Pengguna akhir membutuhkan langkah sederhana: apa yang bisa mereka lakukan sebagai gantinya, atau siapa yang dihubungi. Admin membutuhkan aturan dan izin yang hilang agar bisa mengubah peran dengan aman. Di alat di mana tim membangun aplikasi bisnis (misalnya dengan AppMaster dan akses berbasis peran), pembagian ini penting: satu pesan bisa mengurangi kebisingan untuk pengguna sekaligus memberi admin detail yang cukup untuk menyelesaikannya.
Saat merancang pesan eror yang mengurangi tiket dukungan, anggap validasi sebagai “Anda bisa memperbaiki ini sekarang” dan izin sebagai “ini alasannya diblokir, dan jalur tercepat ke depan.”
Prinsip pesan eror yang bisa ditindaklanjuti pengguna bisnis
Jika Anda ingin pesan eror yang mengurangi tiket dukungan, anggap setiap pesan seperti seperangkat instruksi kecil. Seorang pengguna bisnis harus bisa membacanya sekali dan tahu apa yang harus diperbaiki tanpa merasa disalahkan.
Mulai dengan deskripsi singkat, satu kalimat, tentang apa yang terjadi. Hindari istilah yang menyiratkan pengguna salah. “Kami tidak bisa menyimpan catatan” terasa lebih tenang daripada “You entered invalid data.”
Selanjutnya, jelaskan secara tepat di mana masalahnya. Tunjuk field, catatan, atau langkah yang tepat. “Tanggal faktur” lebih baik daripada “Invalid input.” Jika masalah terkait item tertentu, sertakan pengenal yang dikenali pengguna, seperti nomor pesanan atau nama pelanggan.
Kemudian berikan satu tindakan berikutnya yang jelas. Singkat, dan hindari paragraf panjang saran. Pengguna tidak perlu alasan internal Anda, cukup langkah terbaik berikutnya: pilih nilai, ubah format, minta akses, atau hubungi admin.
Struktur sederhana membantu pengguna belajar pola ini seiring waktu. Banyak tim menggunakan template konsisten seperti ini:
- Apa yang terjadi (dengan bahasa sederhana)
- Di mana (field, catatan, layar, atau langkah)
- Apa yang dilakukan berikutnya (satu tindakan)
- Jika terblokir, apa yang harus dikirimkan dan ke siapa
Spesifik lebih baik daripada kreatif. Lewatkan istilah internal, kode sistem, dan nama alat kecuali pengguna sudah tahu. “Status harus salah satu: Draft, Approved, Paid” lebih baik daripada “Enum validation failed.” Jika Anda harus menyertakan referensi untuk dukungan, letakkan di akhir dan beri label jelas (misalnya, “Reference: 8F2A”), agar tidak mengganggu.
Konsistensi juga berarti nada dan format yang konsisten. Jika satu pesan menggunakan “Fix:” dan yang lain menggunakan “Resolution:”, pengguna melambat. Pilih satu pola dan gunakan kembali.
Berikut beberapa pemeriksaan cepat yang menjaga pesan tetap dapat ditindaklanjuti:
- Gunakan kata-kata pengguna, bukan nama kolom database (Billing email, bukan contact_email)
- Batasi ke 1–2 kalimat pendek, lalu tindakan
- Hindari kata menyalahkan seperti “wrong” atau “failed” ketika “can’t” atau “needs” lebih cocok
- Jika field wajib, jelaskan apa yang diperlukan dan mengapa penting untuk tugas
- Jika akses hilang, sebutkan peran atau tim yang biasanya memberikan akses
Menulis ulang eror validasi agar pengguna bisa memperbaiki dengan cepat
Eror validasi adalah tempat termudah untuk mengurangi tiket dukungan karena pengguna biasanya bisa memperbaiki masalah segera. Kuncinya adalah mengganti pesan kabur seperti “Invalid input” dengan pesan yang menjawab empat pertanyaan dengan kata-kata sederhana: apa yang terjadi, di mana, bagaimana memperbaikinya, dan apa langkah berikutnya.
Template sederhana yang hampir selalu bekerja:
- Masalah: apa yang salah
- Di mana: field atau langkah yang tepat
- Perbaikan: aturan dengan kata-kata manusiawi
- Langkah berikutnya: apa yang terjadi setelah mereka memperbaikinya
Jaga bagian “Perbaikan” tetap konkret. Pengguna bisnis lebih mudah memahami contoh, angka, dan format yang diperbolehkan dibandingkan istilah teknis.
Berikut penulisan ulang untuk kasus umum:
- Field wajib: “Informasi hilang di Invoice Date. Masukkan tanggal dalam format YYYY-MM-DD (contoh: 2026-01-25). Lalu klik Save.”
- Format tidak valid: “Format nomor telepon tidak dikenali di Customer Phone. Gunakan hanya angka, mis. 4155550123. Lalu coba lagi.”
- Di luar rentang: “Diskon terlalu besar di Discount %. Masukkan nilai antara 0 sampai 30. Lalu klik Apply.”
- Duplikat: “Email ini sudah digunakan di Email. Gunakan email lain, atau buka catatan pelanggan yang ada dan perbarui di sana.”
Perhatikan apa yang tidak disertakan: ID field internal, regex, error database, atau aturan yang bisa disalahgunakan. Anda masih bisa membantu tanpa mengekspos logika sensitif. Misalnya, daripada “Password must match policy v3”, gunakan “Gunakan setidaknya 12 karakter, termasuk satu angka.”
Tentukan di mana menampilkan pesan berdasarkan berapa banyak masalah yang dapat dimiliki pengguna sekaligus. Gunakan teks inline ketika pengguna dapat memperbaiki field di tempat, dan gunakan banner tunggal untuk masalah yang melibatkan banyak field.
Contoh: di pembangun tanpa kode seperti AppMaster, pesan inline di dekat setiap field bekerja paling baik untuk field wajib dan format, sementara banner cocok untuk kasus seperti “Start date must be before end date” karena melibatkan beberapa input.
Jika Anda menerapkan pendekatan ini secara konsisten, Anda akan mendapatkan pesan eror yang mengurangi tiket dukungan karena pengguna dapat memperbaiki sendiri tanpa menebak atau meminta bantuan.
Menulis ulang eror izin tanpa mengekspos detail sensitif
Eror izin rumit karena pengguna butuh panduan, tapi Anda tidak boleh bocorkan apa yang tidak boleh mereka lihat. Tujuannya adalah mengubah “access denied” menjadi langkah berikutnya yang jelas, sambil menjaga nada netral.
Mulai dengan memisahkan autentikasi dari otorisasi. Jika orang belum masuk (atau sesi kadaluwarsa), katakan itu dengan jelas dan tawarkan tindakan masuk. Jika mereka sudah masuk tapi kurang hak, katakan bahwa mereka tidak memiliki akses dan jelaskan jalur yang aman untuk memperolehnya.
Gunakan bahasa yang ramah peran dan sesuai cara kerja bisnis Anda. Kebanyakan pengguna bisnis tidak berpikir dalam istilah “403” atau “policy evaluation”. Mereka berpikir dalam istilah workspace, tim, dan pemilik.
Struktur sederhana yang cenderung menciptakan pesan eror yang mengurangi tiket dukungan:
- Apa yang terjadi: “Anda tidak memiliki akses ke halaman/aksi ini.”
- Mengapa (tingkat tinggi): “Peran Anda di workspace ini tidak menyertakan izin ini.”
- Apa yang dilakukan berikutnya: “Minta akses dari pemilik workspace” atau “Ganti workspace.”
- Cadangan: “Jika Anda yakin ini kesalahan, hubungi admin Anda.”
- Opsional: “Reference ID: ABC123” (hanya bila membantu pelacakan log)
Jaga detail sensitif tetap tersembunyi. Jangan konfirmasi bahwa catatan tertentu ada, siapa pemiliknya, atau mengapa dibatasi. Hindari pesan seperti “Invoice #48102 belongs to Finance” atau “This customer is flagged for investigation”. Bahkan menampilkan nama proyek yang dibatasi bisa menjadi kebocoran.
Buruk: “You can’t view ‘Acquisition Plan 2026’ because you’re not in the M&A group.”
Lebih baik: “Anda tidak memiliki akses ke item ini. Minta akses dari pemilik workspace, atau beralih ke workspace di mana Anda memiliki izin.”
Tawarkan jalur yang tepat berdasarkan konteks. Jika aplikasi Anda memiliki banyak workspace atau akun, “Switch workspace” sering kali perbaikan tercepat. Jika masalahnya soal peran, “Request access” lebih baik daripada “Contact support”. Di platform di mana aplikasi dibangun dengan peran dan modul jelas (misalnya, di AppMaster dengan autentikasi dan aturan akses berbasis peran), ini mencerminkan bagaimana akses sebenarnya dikelola.
Tambahkan ID referensi hanya ketika itu menghemat waktu. Jika dukungan tidak dapat mendiagnosis tanpa log server, ID singkat berguna. Jika pengguna dapat memperbaiki sendiri (salah workspace, peran hilang), kode tambahan hanya menambah kebisingan.
Contoh cepat: Maria klik “Export Payments Report” dan melihat, “Anda tidak memiliki akses untuk mengekspor laporan di Workspace: Retail Ops. Ganti workspace atau minta peran Reporter dari pemilik workspace.” Dia beralih ke “HQ Finance” dan menyelesaikan ekspor tanpa menghubungi siapa pun.
Apa yang disertakan di pesan izin (dan apa yang dikecualikan)
Pesan izin harus menjawab satu pertanyaan cepat: “Apa yang bisa saya lakukan selanjutnya?” Jika pesan hanya mengatakan “Access denied,” kebanyakan orang akan mencoba lagi, refresh, atau ganti perangkat. Itu tidak mengubah hak akses, sehingga berujung pada tiket dukungan.
Mulai dengan detail minimal yang membantu pengguna bisnis memperbaiki sendiri. Sebutkan aksi yang diblokir dengan bahasa sederhana, lalu berikan alasan singkat. “Anda tidak bisa menyetujui faktur” lebih jelas daripada “403 Forbidden.” Jika masalahnya berbasis peran, sebutkan itu: “Peran Anda tidak termasuk persetujuan faktur.”
Juga beri tahu siapa yang bisa membuka blokir, tanpa mengekspos detail berisiko. Di banyak tim, menyebut orang spesifik baik-baik saja. Di tim lain, ini bisa membocorkan struktur organisasi atau memicu ping yang tidak perlu. Default yang lebih aman adalah merujuk pada peran atau grup: “Tanya Workspace Admin” atau “Tanya Account Owner.”
Pesan izin yang baik biasanya mencakup:
- Aksi yang diblokir (view, edit, export, delete, approve)
- Alasan dalam istilah sederhana (peran hilang, tidak ditugaskan pada catatan ini, fitur dimatikan)
- Langkah aman berikutnya (minta akses, pilih workflow lain, atau simpan sebagai draft)
- Petunjuk apa yang tidak membantu (mencoba lagi tidak akan mengubah akses)
- Nada singkat dan netral (tanpa menyalahkan atau sarkasme)
Apa yang dikecualikan: kode internal, istilah stack teknis, dan aturan akses sensitif. Hindari baris seperti “Anda tidak di grup Finance-AP-Approvers” jika nama grup mengungkap struktur privat. Jangan sertakan ID catatan, ID pengguna, atau “cara melewati” detail. Jika Anda mencatat detail itu untuk dukungan, simpan di log server, bukan di layar.
Tambahkan satu opsi jelas. Jika aplikasi Anda mendukungnya, tombol “Request access” ideal karena menangkap konteks. Di platform seperti AppMaster, Anda bisa mengarahkan ini ke alur kerja sederhana: buat record permintaan, beri tahu admin yang tepat, dan lacak status.
Pertahankan konsistensi pesan di seluruh aplikasi. Pengguna mempelajari pola. Jika setiap eror izin mengikuti bentuk yang sama, mereka berhenti menebak dan mulai melakukan langkah yang benar.
Contoh penulisan ulang:
“Permission denied.”
Menjadi:
“Anda tidak bisa mengekspor laporan ini karena peran Anda tidak mengizinkan ekspor. Mencoba lagi tidak akan mengubah akses. Minta Workspace Admin untuk mengaktifkan 'Report Export' untuk peran Anda, atau ajukan permintaan akses.”
Langkah demi langkah: buat playbook pesan eror untuk aplikasi Anda
Playbook adalah katalog sederhana dari eror yang ditampilkan aplikasi Anda, ditulis dengan cara konsisten dan diperbarui. Jika dikerjakan dengan baik, ini menjadi jalur tercepat Anda menuju pesan eror yang mengurangi tiket dukungan.
1) Pemetaan tempat eror benar-benar terjadi
Mulai dari perjalanan pengguna, bukan tabel database Anda. Pilih beberapa aksi yang menghasilkan gesekan paling besar untuk pengguna bisnis: membuat catatan, menyetujui permintaan, mengekspor laporan, dan menghapus sesuatu yang mereka sesali. Untuk setiap aksi, catat di mana pengguna berhenti, mencoba lagi, atau meminta bantuan.
Tulis momen tepat ketika eror muncul (misalnya: “saat klik Approve” vs “di formulir”), karena masalah yang sama butuh kata-kata berbeda bergantung langkahnya.
2) Kumpulkan eror nyata dari pengguna nyata
Jangan mulai dengan menyusun draf. Mulai dengan mengumpulkan. Tarik contoh dari tiket dukungan, pesan chat, dan screenshot yang dibagikan pengguna. Simpan teks asli, meskipun jelek. Itu menunjukkan pola yang perlu diperbaiki.
Jika Anda membangun dengan platform seperti AppMaster, ekspor daftar pesan validasi dan izin saat ini dari aplikasi Anda dan bandingkan dengan tumpukan tiket. Kesenjangan itu adalah prioritas Anda.
3) Kelompokkan pesan berdasarkan maksud (biar penulisan konsisten)
Alih-alih ratusan pesan unik, buat beberapa kategori jelas dan standarkan. Bucket umum meliputi:
- Data hilang (field wajib kosong)
- Data bertentangan (dua field tidak cocok, nilai duplikat)
- Diblokir oleh kebijakan (jendela waktu, aturan status, batas persetujuan)
- Diblokir oleh peran (pengguna tidak punya izin)
- Masalah sistem (timeout, layanan tidak tersedia)
Setelah Anda mengelompokkan berdasarkan maksud, Anda bisa menggunakan ulang struktur, nada, dan panduan “langkah berikutnya.”
4) Tulis satu pesan standar per kasus, lalu ijinkan variasi aman
Buat satu template “emas” per bucket dan hanya ubah yang perlu: nama field, format yang diperbolehkan, status saat ini, atau siapa yang bisa menyetujui. Jika perlu lokaliasi, lokalisasi setelah template standar disepakati, bukan sebelum.
Pertahankan setiap pesan pada: apa yang terjadi, mengapa itu terjadi (dalam kata pengguna), dan langkah paling aman berikutnya.
5) Tetapkan pemilik dan aturan review
Katalog pesan akan membusuk tanpa pemilik. Putuskan:
- Siapa yang mengedit katalog (biasanya produk atau UX)
- Siapa yang menyetujui perubahan (pemimpin dukungan + keamanan untuk izin)
- Kapan pembaruan terjadi (daftar cek rilis)
- Bagaimana Anda melacak perubahan (dokumen versi)
- Bagaimana mengukur dampak (tag tiket, jumlah eror teratas)
Tujuannya sederhana: setiap fitur baru dirilis dengan pesan yang membantu pengguna memperbaiki masalah sendiri.
Kesalahan umum yang diam-diam menambah tiket
Beberapa tiket dukungan bukan disebabkan bug berat. Mereka muncul karena pesan tidak membantu pengguna bisnis mengambil langkah berikutnya. Pilihan kata kecil bisa mengubah perbaikan 10 detik menjadi rangkaian tanya jawab.
Salah satu pendorong terbesar adalah menggunakan teks generik untuk masalah yang diharapkan dan dapat diperbaiki. “Something went wrong” masuk akal untuk gangguan, tapi membuat frustrasi untuk field wajib yang hilang. Jika Anda sudah tahu penyebab yang mungkin, sebutkan dengan kata sederhana dan tunjukkan tempat tepat untuk memperbaikinya.
Masalah umum lain adalah menyembunyikan penyebab sebenarnya di balik istilah teknis. Kata-kata seperti “exception,” “stack trace,” atau “HTTP 403” mungkin akurat, tapi kebanyakan pengguna bisnis tidak bisa bertindak berdasarkan itu. Bahkan ketika Anda butuh kode teknis untuk debugging internal, letakkan itu sekunder dan pisahkan dari penjelasan untuk manusia.
Generator tiket diam-diam adalah menyuruh pengguna menghubungi dukungan sebagai opsi pertama dan satu-satunya. Jika pesan langsung mengatakan “Contact support,” pengguna akan melakukan itu, meski perbaikan sederhana tersedia. Beri jalur swalayan terlebih dulu, lalu dukungan sebagai cadangan.
Nada juga lebih penting daripada yang diperkirakan tim. Pesan yang menyalahkan pengguna (“You entered wrong data”) menciptakan gesekan dan membuat orang ragu mencoba lagi. Kata-kata yang lebih baik berfokus pada tujuan dan perbaikan: apa yang kurang, format yang diperlukan, dan langkah berikutnya.
Terakhir, inkonsistensi menciptakan kebingungan yang terlihat seperti “kesalahan pengguna” padahal sebenarnya utang UI. Jika satu layar mengatakan “workspace,” layar lain mengatakan “team,” dan layar ketiga mengatakan “account,” pengguna tidak akan tahu apa yang dimaksud oleh eror. Standarkan kata benda penting di produk Anda dan gunakan kembali di mana-mana, terutama di pesan eror.
Berikut checklist cepat kesalahan yang harus diwaspadai:
- Pesan generik untuk masalah validasi yang diharapkan
- Jargon teknis alih-alih penyebab dan perbaikan yang jelas
- “Contact support” sebagai satu-satunya langkah
- Bahasa menyalahkan alih-alih membimbing
- Istilah berbeda untuk konsep yang sama di layar berbeda
Jika Anda membangun aplikasi di platform seperti AppMaster, banyak masalah ini bisa dicegah dengan menjaga sistem penamaan UI yang konsisten dan menulis teks eror yang bisa digunakan ulang untuk validasi dan pemeriksaan izin umum. Perubahan kecil di sini sering kali mengurangi tiket dukungan nyata tanpa mengubah logika inti.
Contoh: pengguna bisnis memperbaiki masalah tanpa menghubungi dukungan
Maya bekerja di Operasi. Dia sedang menggunakan alat pesanan internal, mencoba menyetujui Order #10482 agar bisa dikirim hari ini. Dia klik Approve dan mendapat pesan ini:
Asli (tidak membantu): Error: Access denied.
Maya tidak tahu apakah sistem turun, dia salah klik tombol, atau dia butuh manajer. Jalur tercepat adalah tiket dukungan: “Saya tidak bisa menyetujui pesanan. Tolong perbaiki.” Dukungan selalu menanyakan hal yang sama: “Anda ada di peran apa? Workspace mana? Langkah mana?”
Bandingkan dengan pesan yang diperbaiki yang tetap melindungi detail sensitif:
Diperbaiki (dapat ditindaklanjuti): Anda tidak bisa menyetujui pesanan di Warehouse A dengan peran Anda saat ini.
Apa yang bisa Anda lakukan:
- Minta Order Manager untuk menyetujui pesanan ini, atau
- Minta izin Order Approval dari admin Anda.
Reference: PERM-APPROVE-ORDER
Dengan pesan itu, Maya tidak perlu menebak. Dia melakukan tiga hal sederhana:
- Memeriksa header pesanan dan memastikan itu untuk Warehouse A.
- Menghubungi Order Manager warehouse tersebut agar menyetujui sekarang.
- Menyertakan kode referensi (PERM-APPROVE-ORDER) dalam permintaan izin supaya admin tahu persis apa yang harus diubah.
Satu menit kemudian, manager menyetujui pesanan. Maya mencoba lagi, tetapi formulir kini menghentikannya karena alasan berbeda: nomor faktur kosong.
Asli (tidak membantu): Validation failed.
Itu biasanya membuat tiket lagi: “Tertulis validation failed. Maksudnya apa?” Sebagai gantinya, pesan yang diperbaiki menunjuk field dan memberi tahu seperti apa kondisi “baik” itu:
Diperbaiki (dapat ditindaklanjuti): Nomor faktur diperlukan untuk menyetujui pesanan.
Tambahkan pada Invoice number (contoh: INV-10482), lalu klik Approve lagi.
Maya menyalin nomor faktur dari email, menempelkannya ke field, dan berhasil menyetujui.
Begitulah cara kerja pesan eror yang mengurangi tiket dukungan di kehidupan nyata: mereka mengubah “ada yang salah” menjadi langkah yang jelas. Dukungan tetap membantu kasus tepi, tetapi mereka melihat lebih sedikit pertanyaan berulang seperti “Kenapa saya diblokir?” dan “Field mana yang salah?”, karena aplikasi menjawabnya di tempat masalah terjadi.
Pemeriksaan cepat dan langkah berikutnya
Sebelum merilis perubahan, lakukan peninjauan cepat untuk eror yang menyebabkan bolak-balik terbanyak. Target yang baik adalah pesan eror yang mengurangi tiket dukungan dengan membuat perbaikan jelas pada tampilan pertama.
Checklist cepat: eror validasi
Validasi harus memberi tahu orang tepat apa yang akan diubah, di tempat mereka bisa mengubahnya.
- Sebutkan field yang tepat dan tunjukkan (highlight input, letakkan pesan dekat)
- Katakan apa yang diperbolehkan (format, panjang, rentang, contoh seperti "Gunakan YYYY-MM-DD")
- Berikan perbaikan jelas dengan bahasa sederhana (hindari istilah internal seperti "constraint" atau "schema")
- Jika ada nilai yang diperbolehkan, tampilkan (atau beberapa teratas dan cara menemukan sisanya)
- Tetap spesifik, jangan kabur ("Masukkan nomor telepon" lebih baik daripada "Invalid input")
Checklist cepat: eror izin
Pesan izin harus menjelaskan apa yang terjadi tanpa mengungkap detail sensitif.
- Nyatakan aksi yang diblokir ("Anda tidak bisa menyetujui faktur")
- Beri alasan aman ("Peran Anda tidak termasuk persetujuan") alih-alih menyebut peran atau kebijakan tersembunyi
- Beri tahu siapa yang bisa membantu (pemilik tim, admin departemen, atau peran seperti "Finance Admin")
- Tawarkan langkah berikutnya (minta akses, pilih workflow lain, atau simpan sebagai draft)
- Jaga pekerjaan pengguna aman (jangan buang perubahan; konfirmasi apa yang tersimpan)
Lakukan pemeriksaan konsistensi di seluruh layar. Gunakan istilah yang sama untuk konsep yang sama (role vs access, project vs workspace), nada yang sama, dan struktur yang sama (apa yang terjadi, mengapa, apa yang harus dilakukan). Ketidaksesuaian kecil adalah tempat orang ragu.
Uji dengan 3–5 pengguna non-teknis. Minta mereka memperbaiki beberapa masalah yang sudah disiapkan sementara Anda diam. Catat kata-kata yang mereka ulangi, tempat mereka ragu, dan apa yang mereka klik selanjutnya. Jika mereka masih menebak, tulis ulang lagi.
Langkah berikutnya: implementasikan, ukur, dan iterasi. Mulai dengan 5 eror teratas yang menyebabkan tiket dan perbaiki hanya itu minggu ini. Jika Anda membangun alat internal dengan AppMaster, gunakan UI builder dan Business Process flows untuk menampilkan umpan balik validasi tingkat field dan blok izin yang jelas tanpa menulis kode, lalu perbarui logika sesuai perubahan aturan.


