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

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

使用者與 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 應用程式傳回錯誤訊息。

下列哪一項錯誤訊息可採取行動?
你必須先輸入內容,才能進行會談時間 /signin。如要瞭解詳情,請輸入 /help
錯誤訊息顯示以下情況,因此可以採取行動:
  • 發生錯誤。Chat 應用程式必須使用 驗證。
  • 我該怎麼做。輸入 /signin 進行驗證。
  • 如何取得協助。如果使用者想瞭解更多資訊,可以輸入 /help
您必須進行驗證。
這則錯誤訊息並非實際行動,因為內容並未說明 並進行驗證。
登入。
這則錯誤訊息並未說明簽署方式,因此無法採取行動 而且暗示使用者登出後 這點又令人困惑
無法安排會議時間,
這則錯誤訊息沒有告知使用者,因此不適用 無法安排會議的原因,或使用者該怎麼做沒有幫助 而不是每個 Pod 的名稱