このページでは、ユーザーが目標を達成できるように問題を解決する方法をユーザーに伝える、対処可能なエラー メッセージを作成するためのベスト プラクティスについて説明します。
ユーザーが Google Chat アプリを操作しているときに、エラー メッセージが表示され、そのエラーに対処できない場合、ユーザーは不満を感じる可能性があります。たとえば、エラー メッセージ An error occurred は役に立ちません。このメッセージには、エラーの原因、問題を解決する方法、ユーザーがサポートを受ける方法が説明されていないためです。このページでは、対処可能な例と対処不可能な例を表示してユーザーにとって有用なエラー メッセージを作成する方法について説明します。
エラー メッセージの構造
対処可能なエラー メッセージの構造は次のとおりです。
- エラーの原因チャットアプリがリクエストを完了できない理由を説明すると、ユーザーが問題を解決しやすくなります。エラーが発生した理由を説明すると、信頼関係が築かれます。
- ユーザーが目標達成に向けて進む方法。問題点を伝えるだけでは不十分です。エラーを回避して目標を達成する方法をユーザーに伝えます。
- サポートの利用方法それでも問題が解決しない場合は、詳しいサポートを受ける方法をお客様に伝えます。これは、
/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を想定していることを明記する必要があります。 - 他にサポートを提供しない。ユーザーが行き詰まり、先に進む方法がわからない場合、Chat アプリでのメッセージの送信を停止する可能性があります。
試してみる
対処可能なエラーの記述方法を理解したところで、次のシナリオで、対処可能なエラーを特定できますか。
ユーザーが Chat アプリに schedule というキーワードを含むメッセージを送信すると、Chat アプリはカレンダーの予定を作成します。カレンダーの予定を作成するには、Chat アプリでユーザー認証が必要です。ユーザーが認証されていない場合、Chat アプリはエラー メッセージを返します。
/signin と入力してログインする必要があります。詳しくは、/help と入力してください。- 何が問題だったか。Chat アプリには認証が必要です。
- 手順は次のとおりです。認証するには、「
/signin」と入力します。 - サポートの利用方法。お客様が詳細な情報を必要とする場合は、
/helpと入力します。