撰寫可採取行動的錯誤訊息

本頁將說明最佳做法，說明如何撰寫可採取行動的錯誤訊息，引導使用者修正問題，以便完成目標。

使用者與 Google Chat 應用程式互動時，如果錯誤無法採取行動，卻收到錯誤訊息，可能會讓使用者感到不悅。舉例來說，錯誤訊息 An error occurred 不實用，因為訊息沒有說明發生錯誤的原因、使用者如何修正問題，或是使用者如何尋求協助。本頁面說明如何建構錯誤訊息的結構，讓訊息能夠顯示可採取行動且無法做為參考的範例，讓使用者享有良好的使用體驗。

錯誤訊息結構

具體可行的錯誤訊息如下：

• 發生錯誤說明 Chat 應用程式無法完成要求的原因，有助於使用者解決問題。說明錯誤發生的原因可培養信任感
• 使用者如何繼續達成目標。只要說哪裡出錯是不夠的請告知使用者應如何克服錯誤，並完成目標。
• 如何取得協助如果使用者仍然遇到問題，請告訴他們如何取得進一步協助。這可以是 /help 指令，或 Chat 應用程式的說明文件連結。

錯誤訊息示例：日期格式不正確

在本範例中，使用者輸入的日期格式是 Chat 應用程式非預期的日期。他們編寫了 November 19, 2021，但 Chat 應用程式預期的是 2021-11-19。

針對 Chat 應用程式回覆的錯誤訊息，以下提供可採取行動和無法做為行動的版本：

可採取行動的錯誤

使用者要求 Chat 應用程式安排與其他人的會議。Chat 應用程式會以良好且可採取行動的錯誤訊息回應：

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

系統顯示這則錯誤訊息的可能原因如下：

• 說出問題。Chat 應用程式無法辨識日期格式。
• 說明如何透過向使用者提供預期的日期格式來修正錯誤，並舉例提供日期範例，協助使用者瞭解要寫入的內容。
• /help 斜線指令提供更多協助。如果使用者仍然覺得困難 就知道如何瞭解詳情

無法採取行動的錯誤

使用者要求 Chat 應用程式安排與其他人的會議。Chat 應用程式回應時，會顯示沒有幫助且無法採取行動的錯誤訊息：

Enter the correct date format.

無法帶出這則錯誤訊息，原因如下：

• 不會說明是否安排了會議。使用者可能會猶豫是否要重新安排會議，也可能認為會議已經排定時間。
• 不會向使用者說明如何設定日期格式。您應假設使用者知道如何設定日期格式，而應以 yyyy-mm-dd 來說，這是預期的日期格式。
• 無法提供更多協助。如果使用者遇到困難，且不知道如何繼續操作，可能會停止通訊應用程式。

立即體驗

現在您已瞭解如何編寫可做為行動依據的錯誤，可以在下列情境中找出這些錯誤可以做為行動依據的情況：

當使用者使用關鍵字 schedule 傳送訊息給 Chat 應用程式時，Chat 應用程式會建立日曆活動。Chat 應用程式需要使用者驗證，才能建立日曆活動。如果使用者尚未通過驗證，Chat 應用程式會回應錯誤訊息。