ビジネス メッセージは、Business Communications デベロッパー コンソールというウェブ ユーザー インターフェースを提供します。このコンソールは、エージェントの作成、管理、起動に使用します。
Business Communications デベロッパー コンソールは、Google Cloud Platform とは異なります。(GCP)Console で使用できます。Business Communications デベロッパー コンソールを使用してビジネス メッセージ エージェントを管理し、GCP Console を使用して GCP 固有の設定(課金や API など)とその他の GCP リソースを管理します。
エージェントの作成と管理には Business Communications デベロッパー コンソールを使用しますが、自社プロダクトとの統合など、高度なシナリオでは Business Communications API を使用してエージェントを作成、管理することもできます。
クイックスタートと入門ガイドでは、コンソールと API の両方を使用する手順について説明しています。このページでは、ユーザー インターフェースのレイアウトとコンソールの用途の概要を説明します。
コンソールの使い方
コンソールは、エージェントの作成、管理、更新、検証、起動に使用されます。これを使用すると、次のことができます。
- Webhook とその他のパートナー アカウントの設定を構成します。
- ブランドの会話表現を定義するすべてのプロパティとデータを含むエージェントを作成し、管理します。
- 非ローカル エージェントの設定とメッセージの可用性を構成します。
- ビジネスの拠点を表すビジネス拠点の作成と管理を行う。
- エージェントと位置情報のテスト URL を取得して、エージェントとの会話がユーザーにどのように表示されるかを確認します。
- Dialogflow を統合して、よくある質問に回答します。
- エージェントとロケーションを確認する。
- エージェントとロケーションを起動します。
コンソールのホーム画面
コンソールを初めて読み込むと、エージェント選択画面が表示されます。[パートナー アカウント設定] をクリックすると、パートナーのアカウント設定ページが表示されます。
また、ホーム画面は次の用途に使用されます。
- 既存のエージェントを選択します。
- 新しいエージェントを作成する。
- ソート エージェント。
- パートナー アカウントでエージェントをフィルタします。
デフォルトでは、エージェントはカードビューに表示されます。エージェントは、最終更新日時で並べ替えられます。リスト表示に変更するには、右側の [表示] オプションを使用します。リスト表示では、エージェントは名前、タイプ、ステータス、最終更新日で並べ替えることができます。
パートナー アカウントが複数ある場合は、パートナー アカウントのプルダウン セレクタを使用して、パートナー アカウントでエージェントの選択をフィルタできます。
アカウント設定
[設定] ページでは、次の項目を更新できます。
- 会社名
- 表示名
- 技術関連の連絡窓口
- Webhook
サイド ナビゲーション パネルで、ブランドとユーザーの管理、サービス アカウントにアクセスできます。
ブランド管理
ブランドとは、ビジネスや組織、グループのことです。エージェントとは、ブランドの会話表現です。
このページを使用して、ブランドの追加、編集、削除を行います。ブランドを削除すると、関連付けられているすべてのエージェントも削除されます。起動されたエージェントに関連付けられているブランドは削除できません。
ユーザー管理
登録済みのパートナー アカウントへのアクセス権を追加または削除するには、このページをご利用ください。アカウントを切り替えるには、上部のナビゲーション バーのプルダウンを使用します。
ユーザーを追加
ユーザーを追加するには、メールアドレス入力フィールドにメールアドレスを入力し、ロールを選択します。
新規ユーザーは、管理者または読み取りのロールを持つことができます。マネージャー ロールでは、コンソールのすべての機能にアクセスできます。一方、読み取りロールでは、エージェントと位置情報に関する情報に対する読み取り専用アクセス権が付与されます。
新しいユーザーを追加すると、そのユーザーがパートナー アカウントにアクセスできるようになったことを通知するメールが届きます。
最初にパートナー アカウントを登録したメールアドレスには、オーナーのロールが割り当てられます。
ユーザーを削除する
ユーザーを削除するには:
- リストで、削除するユーザーを探します。
- ボタンをクリックします。
- [ユーザーを削除] を選択します。
- 削除を確認します。
削除したユーザーに、アカウントへのアクセス権がなくなったことを通知するメールが届きます。
オーナーのロールを持つユーザーを削除することはできません。オーナーを変更または削除するには、サポートにご連絡ください。
ユーザー役割を変更する
ユーザーロールを更新するには:
- 更新するユーザーを探します。
- ボタンをクリックします。
- [ロールを編集] を選択します。
- プルダウンから新しいロールを選択します。
- [保存] をクリックします。
サービス アカウント
Business Communications と Business Messages API を呼び出す場合、サービス アカウント キーを使用して呼び出しを認証します。サービス アカウント キーを使用すると、ブランド、エージェント、ロケーションの作成と管理、エージェントとしてのメッセージとリクエストの送信を行うことができます。
サービス アカウント キーを生成するには、サイド ナビゲーションから [サービス アカウント] を選択します。現在選択されているパートナー アカウントに関連付けられている GCP プロジェクトの GCP Console が開きます。
サービス アカウントとキーを作成するには:
- [サービス アカウントを作成] をクリックします。
- [サービス アカウント名] にエージェントの名前を入力し、[作成] をクリックします。
- [完了] をクリックします。
- テーブルで新しいサービス アカウントを見つけて、[ ] > [キーを作成] の順にクリックします。
- [JSON] を選択し、[作成] をクリックします。
ブラウザにサービス アカウント キーがダウンロードされます。
エージェントの選択
エージェントを選択すると、選択したエージェントの [概要] ページが表示されます。
概要が表示されます。
- ブランド名
- エージェント名
- エージェントが作成されたパートナー アカウント
- ブランド ID
- エージェント ID
- エージェント テスト URL を使用して、エージェントとの会話がユーザーにどのように表示されるかを確認し、メッセージ インフラストラクチャを検証できます。
- エージェントの確認ステータス
- エージェントのプレビュー
- エージェントに関連付けられている場所
- 関連ドキュメントへのリンク
左側のナビゲーションから次のものにアクセスできます。
エージェント情報
エージェント情報ページを使用してエージェントのプロパティを更新します。
このページは 2 つの列に分かれています。左の列の入力フィールドを使用して、エージェント名、ロゴ、ウェルカム メッセージ、会話の開始条件、場所と非ローカルのエントリ ポイントのプロパティなどのエージェント フィールドを更新します。エージェントの起動後に、エージェント名やロゴなどの一部のフィールドを更新できなくなります。
右側の列を使用してエージェントのテスト URL を取得し、ユーザーのデバイスでエージェントがどのように表示されるかをプレビューできます。
ビジネスの管理
エージェントの確認が完了したら、このページを使用して場所の追加、ビジネス拠点のテスト URL の取得、場所の確認を行います。
統合
このページでは、Dialogflow を統合し、よくある質問に回答する bot を設定します。
サーベイ
このページを使用して、エージェントの顧客アンケートをカスタマイズします。
ログ
このページを使用して、メッセージ配信の問題をデバッグします。ログは 14 日間有効です。会話 ID、メッセージ ID、タイムスタンプ、方向、ステータスでフィルタして、ユーザーの問題に関連するログを見つけます。このページで、誤って無効なメッセージを送信していないことも確認してください。
ログには、秘匿化された機密フィールド(メッセージ テキスト コンテンツなど)を除いて、メッセージ ペイロードが含まれます。失敗したメッセージと拒否されたメッセージには、デバッグに役立つその他のエラーの詳細が含まれています。
入力インジケーターなど、配信確認のない一部のイベントでは、ステータスが [送信済み] になります。
検証
このページでは、検証用にエージェントを送信できます。
リリース
このページを使用して、位置情報やローカル以外のエントリ ポイントのエージェントを起動する、個々のロケーションを起動する。