Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan praktik terbaik untuk menulis pesan error yang dapat ditindaklanjuti yang memberi tahu pengguna cara memperbaiki masalah sehingga mereka dapat menyelesaikan tujuannya.
Saat pengguna berinteraksi dengan aplikasi Google Chat, munculnya pesan error dapat menjadi pengalaman yang menjengkelkan jika error tersebut tidak dapat ditindaklanjuti.
Misalnya, pesan error, An error occurred, tidak berguna karena pesan tidak menjelaskan apa yang salah, cara pengguna dapat memperbaiki masalah, atau cara pengguna mendapatkan bantuan. Halaman ini menjelaskan cara menyusun pesan error agar
berguna bagi pengguna dengan menampilkan contoh yang dapat ditindaklanjuti dan tidak dapat ditindaklanjuti.
Struktur pesan error
Pesan error yang dapat ditindaklanjuti memiliki struktur berikut:
Apa yang salah. Menyatakan alasan mengapa aplikasi Chat tidak dapat menyelesaikan permintaan akan membantu pengguna menyelesaikan masalah tersebut. Menjelaskan alasan terjadinya error
membangun kepercayaan.
Cara pengguna dapat melanjutkan untuk mencapai tujuannya. Tidak cukup hanya
mengatakan apa yang salah. Beri tahu pengguna cara mengatasi error dan menyelesaikan
tujuan mereka.
Cara mendapatkan bantuan. Jika pengguna masih mengalami masalah, beri tahu mereka cara mendapatkan bantuan lebih lanjut. Ini bisa 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 ditampilkan 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:
Menyatakan 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 lainnya dengan perintah garis miring /help. Jika pengguna masih mengalami masalah, mereka tahu cara 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 mengatakan apakah dia menjadwalkan rapat. Pengguna mungkin enggan menjadwalkan ulang rapat, atau mereka mungkin menganggap bahwa rapat telah dijadwalkan.
Tidak memberi tahu pengguna cara memformat tanggal. Daripada mengasumsikan bahwa pengguna tahu cara memformat tanggal, sebaiknya tulis bahwa format tanggal yang diharapkan adalah yyyy-mm-dd.
Tidak menawarkan bantuan lebih lanjut. Jika pengguna mengalami kebuntuan dan tidak tahu cara melanjutkan,
mereka mungkin berhenti mengirim pesan ke aplikasi Chat.
Cobalah
Sekarang setelah Anda mengetahui cara menulis error yang dapat ditindaklanjuti, dapatkah Anda mengidentifikasi dalam skenario berikut, mana di antara error ini 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.
Pesan error mana yang dapat ditindaklanjuti?
Sebelum saya dapat menjadwalkan 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. Ketik /signin untuk melakukan autentikasi.
Cara mendapatkan bantuan. Jika pengguna menginginkan informasi lebih lanjut, mereka dapat mengetik
/help.
Anda harus melakukan autentikasi.
Pesan error ini tidak dapat ditindaklanjuti karena tidak menjelaskan cara
mengautentikasi.
Login.
Pesan error ini tidak dapat ditindaklanjuti karena tidak menjelaskan cara login, dan menyiratkan bahwa pengguna logout, bukan menyatakan dengan jelas, sehingga membingungkan.
Tidak dapat menjadwalkan rapat.
Pesan error ini tidak dapat ditindaklanjuti karena tidak memberi tahu pengguna
mengapa rapat tidak dapat dijadwalkan atau cara pengguna dapat melanjutkan. Tidak ada bantuan
yang diberikan.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eGoogle Chat app error messages should be actionable, guiding users on how to resolve issues and proceed.\u003c/p\u003e\n"],["\u003cp\u003eActionable error messages clearly explain the problem, provide steps for fixing it, and offer additional help resources.\u003c/p\u003e\n"],["\u003cp\u003eInactionable error messages are vague, lack guidance, and can lead to user frustration and abandonment.\u003c/p\u003e\n"],["\u003cp\u003eUse the actionable error message structure: state the problem, guide the user on fixing it, and offer further help (e.g., \u003ccode\u003e/help\u003c/code\u003e command).\u003c/p\u003e\n"],["\u003cp\u003eWhen writing error messages, assume users need clear instructions and avoid ambiguity.\u003c/p\u003e\n"]]],["Actionable error messages in Google Chat apps should specify what went wrong, how to fix it, and how to get further assistance. For example, an actionable message for an incorrect date format would state that the format is unrecognized, specify the required format (yyyy-mm-dd), and provide a /help command. In contrast, inactionable errors are vague, omit how to correct the issue, and offer no additional support. A sign-in error should also include clear instructions, and help commands.\n"],null,["# Write actionable error messages\n\nThis page describes best practices to write actionable error messages that tell\nthe user how to fix the issue so that they can complete their goal.\n\nWhen a user is interacting with a Google Chat app, encountering\nerror messages can be a frustrating experience when the error isn't actionable.\nFor example, the error message, `An error occurred`, isn't useful because the\nmessage doesn't explain what went wrong, how the user can fix the issue, or how\nthe user can get help. This page describes how to structure error messages so\nthat they're useful to users by showing actionable and inactionable examples.\n\nError message structure\n-----------------------\n\nAn actionable error message has the following structure:\n\n- **What went wrong.** Saying why the Chat app can't complete a request helps the user resolve the issue. Explaining why an error occurred builds trust.\n- **How the user can proceed toward their goal.** It's never enough to just say what went wrong. Tell users how they can move past the error and complete their goal.\n- **How to get help.** If the user is still stuck, tell them how they can get more help. This could be a `/help` command or a link to documentation for your Chat app.\n\nExample error message: incorrect date format\n--------------------------------------------\n\nIn this example, the user entered a date in a format that\nthe Chat app didn't expect. They wrote\n`November 19, 2021`, but the Chat app expects\n`2021-11-19`.\n\nHere's an actionable and an inactionable version of the error message that the\nChat app responds with:\n\n#### Actionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with a good,\nactionable error message:\n\n``I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.``\n\nThis error message is actionable for the following reasons:\n\n- Says what went wrong. The Chat app doesn't recognize the date format.\n- Explains how to fix the error by telling the user the expected date format and gives an example date that helps people understand what to write.\n- Offers more help with a `/help` slash command. If users are still stuck, they know how to learn more.\n\n#### Inactionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with an\nunhelpful, inactionable error message:\n\n`Enter the correct date format.`\n\nThis error message is inactionable for the following reasons:\n\n- Doesn't say whether it scheduled the meeting. The user might be hesitant to reschedule the meeting, or they might assume that the meeting was scheduled.\n- Doesn't tell the user how to format the date. Instead of assuming that users know how to format the date, it should say that it's expecting the date format `yyyy-mm-dd`.\n- Doesn't offer more help. When users are stuck and don't know how to proceed, they might stop messaging the Chat app.\n\nTry it out\n----------\n\nNow that you know how to write actionable errors, can you identify in the\nfollowing scenario which of these errors is actionable:\n\nA Chat app creates calendar events when users message\nthe Chat app with the keyword `schedule`. To\ncreate a calendar event, the Chat app requires user\nauthentication. If a user hasn't been authenticated, then the\nChat app responds with an error message. \nWhich error message is actionable? \nBefore I can schedule the meeting, you must sign in by typing `/signin`. To learn more, type `/help`. \nThis error message is actionable because it says the following:\n\n- What went wrong. The Chat app requires authentication.\n- How to proceed. Type `/signin` to authenticate.\n- How to get help. If the user wants more information, they can type `/help`. \nYou must authenticate. \nThis error message is inactionable because it doesn't say how to authenticate. \nSign in. \nThis error message is inactionable because it doesn't say how to sign in, and it implies that the user is signed out instead of clearly saying so, which is confusing. \nCan't schedule meeting. \nThis error message is inactionable because it doesn't tell the user why the meeting can't be scheduled or how the user can proceed. No help is provided."]]
