Uygulamanız Bozulduğunda Ne Söylemeli: İnsanların Gerçekten Anladığı Hata Mesajları Yazmak

Her uygulama zaman zaman bozulur. İnternet kesilir, sunucu takılır, biri telefon numarasına harf karıştırır. Bu kısmı tamamen önleyemezsiniz. Kontrol edebileceğiniz şey ise hata mesajıdır — bir şeyler ters gittiğinde uygulamanızın gösterdiği metin — ve o tek mesaj çoğu zaman, omuz silkip yeniden deneyen bir kullanıcı ile sessizce uygulamanızın bozuk olduğuna karar verip bir daha geri dönmeyen bir kullanıcı arasındaki farktır.

Çoğu yapay zeka ile inşa edilmiş uygulama tam olarak bu anı yanlış yönetiyor. Bunun sebebi, uygulamayı oluşturan kişinin dikkatsiz davranması değil; hata mesajlarının, gerçek bir insanın gözü önünde bir şeyler ters gidene kadar kimsenin düşünmediği bir detay olması. Varsayılan olarak uygulamalar iki olası en kötü şeyden birini gösterme eğilimindedir: ya hiçbir şey, ya da ürkütücü bir teknik metin bloğu. Şimdi ikisini de düzeltelim.

Uygulamalar neden sessizce başarısız olur ya da korkutucu hata mesajları gösterir?

Uygulamalar iki şekilde kötü bozulur: bir şey başarısız olduğunda hiçbir şey söylemezler, ya da sıradan birinin okuyamayacağı teknik bir hata gösterirler. Her iki durumda da kullanıcı tahmin etmek zorunda kalır ve insanları vazgeçiren şey tam olarak bu tahmin etme halidir.

Sessiz başarısızlık. Maya diyeceğim bir serbest çalışan, fotoğrafçılık işi için bir rezervasyon formu oluşturmuştu. Bir müşteri “Rezervasyonu Onayla”ya dokundu, buton titredi ve… hiçbir şey olmadı. Onay yok, hata yok, yükleniyor animasyonu yok. İşe yaradı mı? Müşteri emin olamadı, bu yüzden tekrar rezervasyon yaptı. Şimdi Maya’nın elinde aynı saat için iki rezervasyon ve kafası karışmış bir müşteri vardı. Uygulama çökmemişti — kayıt işlemi sadece başarısız olmuştu ve uygulama hiçbir şey söylemediği için karşısındaki kişinin gerçekte ne olduğu hakkında hiçbir fikri yoktu.

Korkutucu teknik hata. Diğer başarısızlık türü daha gürültülü ve bir şekilde daha kötü. Bir toplum yardım kampanyası yürüten gönüllü bir kadın bir Excel dosyası yüklemeye çalıştı ve Error 500: Internal Server Error yazan kırmızı bir kutuyla karşılaştı. Bunu “Bir şeyi bozdum” diye okudu. Tekrar denemedi, yardım için e-posta atmadı, sadece sekmeyi kapattı — çünkü mesaj sorunu onun hatası gibi gösteriyor ve tekrar dokunmanın güvenli olmayabileceğini düşündürüyordu.

Her iki kullanıcı da normal, telafi edilebilir bir sorunla karşılaştı. İkisi de uzaklaştı, çünkü uygulamanın hata mesajları ya hiçbir şey söylemedi ya da korkutucu bir şey söyledi.

İyi bir hata mesajını ne yapar?

İyi bir hata mesajı, sade sözcüklerle dört küçük şey yapar: ne olduğunu söyler, kimin sorunu olduğunu söyler, sırada ne yapılması gerektiğini söyler ve kullanıcının çalışmasını kaybetmez.

Ne olduğunu söyler — “Rezervasyonunuzu kaydedemedik,” sessizlik veya 500 değil.
Kimin sorunu olduğunu söyler — genellikle dürüst cevap “bizim” olur ve bunu söylemek insanları sakinleştirir.
Sırada ne yapılması gerektiğini söyler — “Bir dakika sonra tekrar deneyin” ya da “İnternet bağlantınızı kontrol edip tekrar deneyin.”
Çalışmalarını kaybetmez — mesaj göründüğünde yazdıkları her ne ise hâlâ formda durur.

Hepsi bu kadar. Uzun bir özür yazısı yok, başlık olarak bir hata kodu yok, suçlama yok. İşte aynı üç başarısızlık, yeniden yazılmış hali:

❌ (hiçbir şey olmuyor) → ✅ “Az önce bunu kaydedemedik. Bilgileriniz hâlâ burada — tekrar denemek için Onayla’ya dokunun.”
❌ Error 500: Internal Server Error → ✅ “O dosyayı yüklerken bizim tarafımızda bir sorun oldu. Sizin hatanız değil. Bir dakika sonra tekrar deneyin.”
❌ Invalid input → ✅ “Bu telefon numarası doğru görünmüyor — 555-123-4567 gibi 10 haneli olmalı.”

Sonuncusunun belirli bir alanı işaret ettiğine ve doğru olanın nasıl göründüğünü gösterdiğine dikkat edin. “Invalid input” birini aramaya zorlar; “bu telefon numarası 10 haneli olmalı” ise ne değiştireceğini tam olarak söyler.

Öncelikle hangi uygulama hatalarını düzeltmelisiniz?

Her olası başarısızlık için özel bir mesaja ihtiyacınız yok — tipik bir uygulamada ters gidebilecek hemen hemen her şeyi üç kategori kapsar: başarısız olan kaydetme veya gönderme işlemi, uygulamanın kullanamadığı girdi ve sizin tarafınızda bozulan şey.

Başarısız olan kaydetme veya gönderme işlemi. Güveni en çok kıran türdür, çünkü kullanıcı her şeyi doğru yapmıştır ve işe yarayıp yaramadığından emin değildir. Her zaman başarıyı onaylayın ve başarısızlığı açıklayın. Onları asla tahminde bırakmayın ve yazdıklarını asla çöpe atmayın.

“Yazdığınızı kullanamıyoruz” durumu (doğrulama). Bu aslında bir hata değil — bir yanlış anlaşılma. Kullanıcı alandan ayrılır ayrılmaz yakalayın, tam olarak ilgili alanı işaret edin ve doğru formatın bir örneğini gösterin. Gönder’e basana kadar bekleyip koca bir kırmızı duvar göstermeyin.

“Bizim tarafımızda bir şey bozuldu” durumu. Gerçek sunucu veya ağ sorunları. Bunun sizin tarafınızda olduğunu söyleyin, sakin bir dil kullanın ve tekrar deneme imkânı verin. Kullanıcı sizin sunucunuzu düzeltemez, o yüzden bunu düzeltmek zorundaymış gibi hissettirmeyin.

Sessizce yardımcı olan üç alışkanlık

Başarısızlığı zarifçe yöneten uygulamaları yönetemeyenlerden ayıran birkaç şey var:

Ham bir hata kodunu asla tüm mesaj olarak göstermeyin. Bir kod, destek için altta küçük yazıyla durabilir, ama bir insanın okuyacağı başlık ERR_CONN_RESET değil, bir cümle olmalı.
Kullanıcıyı asla suçlamayın. “Yanlış bir şey girdiniz” acıtır; “bu tarih geçmişte gibi görünüyor — gelecek ayı mı demek istediniz?” yardımcı olur. Aynı bilgi, tamamen farklı bir his.
Girdilerini her zaman koruyun. Uygulama yeniden yüklenir veya kayıt başarısız olur ve form boşalırsa, küçük bir aksaklığı on dakikalık yeniden yazma işine dönüştürmüş olursunuz. İnsanlar başarısız bir kaydı bağışlar. İşi iki kez yapmayı bağışlamazlar.

AI uygulama oluşturucunuza daha iyi hata mesajları yazdırmak için ne yapmalısınız?

Bunun çoğunu tek bir istekle elde edebilirsiniz — aşağıdaki gibi bir istemi yapıştırın, AI uygulama oluşturucunuz yukarıdaki sade dil kurallarını tüm uygulamanıza uygulayacaktır.

“Bir kaydetme veya yükleme işlemi başarısız olduğunda, sessizce başarısız olmayın ve teknik bir hata kodu göstermeyin. Ne olduğunu söyleyen, tekrar denemenin sorun olmadığını belirten ve kullanıcının zaten yazdığı her şeyi koruyan kısa, samimi bir mesaj gösterin, sade bir dille. Form alanları için, kullanıcı her alandan ayrıldığında doğrulama yapın ve doğru formatın bir örneğiyle birlikte spesifik bir mesaj gösterin.”

Sonra ona üç durumda ne olduğunu adım adım anlatmasını isteyin: internet kapalıyken, zorunlu bir alan boşken ve sunucu yavaşken. Bunlardan herhangi birinin cevabı “hiçbir şey göstermiyor” ya da “ham hatayı gösteriyor” ise, sıradaki düzeltmeniz bu olmalı.

Uygulamanızın hata mesajlarını nasıl test edersiniz?

Wi-Fi’ınızı kapatın, uygulamanızı açın ve ana işlemi yapmaya çalışın — testin tamamı bu kadar ve iki dakika sürer.

Rezervasyonu yapın, notu kaydedin, dosyayı yükleyin. Ne söylediğine bakın. Sıradan bir insanın anlayacağı bir şey mi söyledi? Yazdıklarınızı kaybetti mi? Şimdi Wi-Fi’ı tekrar açın ve bilerek bir alana saçma bir şey yazın. Aynı sorular geçerli.

Çoğu uygulama bu testi ilk seferde geçemez, ve bu gayet normal — sadece tam olarak nereden başlayacağınızı gösterir. Her hata mesajını mükemmel yapmak zorunda değilsiniz. Uygulamanızda en sık bozulan tek şeyi bulun ve önce o mesajı nazik, açık ve dürüst yapın. Bir dahaki sefere gerçek bir kişi onunla karşılaştığında, ayrılmak yerine tekrar deneyecek — ve asıl mesele de bu.