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

本頁說明撰寫可採取行動的錯誤訊息的最佳做法 使用者解決問題才能達成目標

使用者與 Google Chat 應用程式互動時， 錯誤訊息無法採取行動，令人困擾。 例如，錯誤訊息 An error occurred 並不實用，因為 訊息未說明問題所在、使用者如何解決問題，或是 使用者就能取得協助本頁會說明如何建立錯誤訊息，以便 對使用者有幫助的實用範例。

錯誤訊息結構

可採取行動的錯誤訊息有以下結構：

• 發生錯誤。說明 Chat 應用程式為何無法操控 完成要求有助於使用者解決問題。說明錯誤的原因 建立信任感
• 使用者如何朝目標邁進。我們不只要 「哪裡出了問題」告訴使用者該如何避開錯誤並完成後續動作 他們的目標。
• 如何取得協助。如果使用者仍然停滯不前，可以告訴他們如何 取得更多協助。這可以是 /help 指令或以下項目的說明文件連結： Chat 應用程式。

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

在這個範例中，使用者輸入的日期格式為 Chat 應用程式沒有預期。創作者的寫法 November 19, 2021，但即時通訊應用程式預期 2021-11-19。

以下提供這則錯誤訊息採取的可行性與不可回應版本： 即時通訊應用程式會回應以下內容：

可採取行動的錯誤

使用者要求 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。
• 無法提供更多協助。當使用者卡住了，不知道如何繼續操作時 使用者可能會停止傳送訊息給 Chat 應用程式

立即試用

現在您已經瞭解如何編寫可操作的錯誤，接下來就可以 下列情況中，您可以著手處理這類錯誤：

這個 Chat 擴充應用程式會在使用者傳送訊息時建立日曆活動 Chat 應用程式，使用關鍵字「schedule」。目的地： 如要建立日曆活動，Chat 應用程式會要求使用者建立 驗證。如果使用者尚未通過驗證 Chat 應用程式傳回錯誤訊息。