エージェントを作成してブランドを管理する

ビジネス コミュニケーションのデベロッパー コンソールまたは API でエージェントを管理するかどうかを選択します。

デベロッパー コンソール API

パートナーとして登録したら、管理しているブランドのビジネス メッセージ エージェントを作成して、そのブランドの会話を有効にできます。

エージェント: パートナーが管理する、ブランドの情報を会話形式で提供します。ユーザーが操作するインターフェースと、その操作に必要なコードやインフラストラクチャが含まれます。

エージェントは、ユーザーが操作する会話エンティティです。エージェントは、管理するブランドごとに 1 つ作成します。エージェントの作成と管理には Business Communications API を使用し、エージェントのメッセージングを制御するには Business Messages API を使用します。

エージェントには、オンライン サポートや実店舗（ある場合）など、ブランドのビジネス機能が含まれます。各メッセージには、ユーザーが会話を開始したコンテキストが含まれています。メッセージ ルーティング インフラストラクチャは、ユーザーが特定のビジネス拠点を確認したか、一般的なサポートを探したかを検出し、メッセージを正しい宛先に転送できます。

たとえば、ウェブサイトと 2 つの店舗を持つ Growing Tree Bank ブランドを管理している場合は、単一の「Growing Tree Bank」エージェントを作成します。ユーザーは、一般的な検索または位置情報ベースの検索でエージェントに出会うことができます。ユーザーがエージェントを見つけたコンテキストは、各メッセージとともに Webhook に渡されます。そのコンテキストを使用して、メッセージのルーティング先を、店舗のスタッフまたはウェブサイト サポートチームに設定します。これらのチームは、レスポンスを作成してユーザーとの会話を続けます。

期待

エージェントを作成する前に、ビジネス メッセージでのエージェントの役割を理解してください。

• エージェントは、ビジネス メッセージの会話設計に記載されている設計ガイダンスに従う必要があります。

• エージェントは、自動化がリクエストを処理できない場合や、ユーザーからリクエストされた場合に、質問に答えられる人間の担当者を用意する必要があります。

  注: エージェントが人間の担当者をサポートしていない場合、位置情報ベースのエントリ ポイントまたはローカル以外のエントリ ポイントからエージェントを起動することはできません。エージェントのインタラクション タイプを指定して、Google が管理するエントリ ポイントに表示できるようにします。

• エージェントは、指標に記載されているように、顧客満足度（CSAT）が 80% 以上、販売者の応答率（MRR）が 95% 以上を維持する必要があります。

エージェントを作成する

エージェントを作成するときに、Business Messages Helper Bot を有効にして、プラットフォームを探索できます。Helper Bot を使用すると、エージェントとの会話をすばやく開始して、利用可能な機能を試したり、実装に役立つリソースを見つけたりすることができます。これは、最初のエージェントを作成するときに特に便利です。

エージェントを作成するには、ブランドとエージェントのユーザーへの表示方法に関する情報を収集して送信する必要があります。

注: エージェントを作成するには、ビジネス メッセージの Google アカウントが必要です。アカウントを登録するには、ビジネス メッセージに登録するを参照し、オペレーティング エージェントに対する要件を確認してください。

複数のブランドを管理している場合は、手順を繰り返してブランドごとにエージェントを作成します。

前提条件

管理するブランドのエージェントを作成する前に、次の情報を収集する必要があります。

• ブランド名
• エージェント名

エージェントを作成する

情報を収集したら、エージェントを作成します。

注: エージェントで Business Messages Helper Bot を有効にするには、まず、既存の webhook または Dialogflow との統合を無効にする必要があります。

1. ビジネス コミュニケーション デベロッパー コンソールを開き、ビジネス メッセージの Google アカウントでログインします。
2. [Create Agent（エージェントを作成）] をクリックします。
3. [エージェントの種類] で [ビジネス メッセージ] を選択します。
4. [ブランド名] と [エージェント名] に値を入力します。
5. 次のいずれかを行います。
   • 利用可能な機能を確認できるエージェントとの会話を体験するには、[Business Messages Helper Bot を有効にする] を選択します。
   • エージェントをカスタマイズしてメッセージ処理の準備を整えるには、[Business Messages Helper Bot を有効にする] の選択を解除します。
6. [Create Agent（エージェントを作成）] をクリックします。

Business Messages Helper Bot を有効にしている場合は、すぐに会話を開始できます。そうでない場合は、Webhook の設定に進みます。

エージェント レベルの Webhook を設定する

エージェントに送信されたメッセージは Webhook で受信します。特定のエージェントのメッセージを別の Webhook に転送する場合は、エージェント単位の Webhook を設定します。

注: Business Messages Helper Bot を有効にしている場合は、Webhook でメッセージを受信する前に、無効にする必要があります。

1. ビジネス コミュニケーション デベロッパー コンソールを開き、ビジネス メッセージの Google アカウントでログインします。
2. エージェントをクリックします。
3. [Integrations] をクリックします。
4. [Webhook] で [構成] をクリックします。
5. [Webhook のエンドポイント URL] に、Webhook の URL（「https://」で始まる）を入力します。
6. clientToken の値をメモします。これは、受信したメッセージが Google から送信されたものであることを確認するために必要です。

7. 指定された clientToken パラメータを含む POST リクエストを受け取り、secret パラメータの値を含む 200 OK レスポンスを送信するように Webhook を構成します。

   たとえば、Webhook が次の本文を含む POST リクエストを受信した場合

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"0123456789"
   }
   

   Webhook は clientToken 値を確認し、clientToken が正しい場合は、secret URL パラメータを 0123456789 に設定した 200 OK レスポンスを返します。

8. コンソールで [確認] をクリックします。

   ビジネス メッセージが Webhook を確認すると、ダイアログが閉じます。

エージェントをテストする

各エージェントにはテスト URL があり、そのエージェントとの会話がユーザーにどのように表示されるかを確認したり、メッセージ インフラストラクチャを確認したりできます。

エージェントをテストするには、

1. ビジネス コミュニケーション デベロッパー コンソールを開き、ビジネス メッセージの Google アカウントでログインします。
2. エージェントを選択します。

3. [概要] ページの [エージェント テスト URL] で、テスト URL にアクセスする方法を選択します。

   • モバイル デバイスで URL にアクセスするには、[Android] ボタンまたは [iOS] ボタンをクリックします。次に、対応するデバイスで QR コードをスキャンし、[起動] をクリックします。または、[Android の URL をコピー] または [iOS の URL をコピー] をクリックして、エージェントのテスト URL をデバイスのクリップボードにコピーします。
   • URL をメールアドレスに送信するには、[送信] をクリックします。

4. モバイル デバイスで URL を開きます。（iOS デバイスの場合は Google マップ アプリが必要です）。

注: Business Communications Developer Console でエージェントのプレビューを操作して、エージェントをテストすることもできます。

エージェント情報を更新する

エージェントを作成したら、[エージェント情報] ページでエージェント情報を編集できます。

• ブランド名
• エージェント名

• エージェントのロゴ（1,024 x 1,024 ピクセル）

  会話では、ロゴは直径 1, 024 ピクセルの円として表示されます。ロゴが円形として適切に表示されるようにします。

  ロゴをテストする

  ロゴの URL を入力すると、ユーザーにどのように表示されるかを確認できます。

  注: 画像をホストするウェブサーバーで、他のウェブサイトへの画像の埋め込みが許可されている必要があります。

• 電話番号

• プライバシー ポリシーの URL

• デフォルトの言語 / 地域

• ウェルカム メッセージ

• オフライン メッセージ

• お客様との会話のきっかけ

• メイン インタラクションとセカンダリ インタラクションによるメッセージの可用性

[概要] ページと [エージェント情報] ページには、エージェントが会話でどのように表示されるかが表示されます。

エージェントを検証した後、更新できるのは次のフィールドのみです。

• 電話番号
• カスタム エージェント ID
• デフォルトの言語 / 地域
• ウェルカム メッセージ
• オフライン メッセージ
• プライバシー ポリシー
• お客様との会話のきっかけ
• メインのインタラクション

エージェントの確認後に他のフィールドを更新する必要がある場合は、 お問い合わせください。（まず、ビジネス メッセージの Google アカウントでログインする必要があります。アカウントを登録するには、ビジネス メッセージで登録するをご覧ください）。

エージェントを削除する

エージェントを削除すると、ビジネス メッセージからエージェントのデータがすべて削除されます。ビジネス メッセージでは、エージェントが送信したメッセージがユーザーのデバイスに転送中または保存中の場合、そのメッセージは削除されません。ユーザーへのメッセージはエージェントデータではありません。

エージェントに位置情報が関連付けられている場合、またはエージェントの確認を 1 回以上試みた場合は、削除リクエストが失敗します。ロケーションを更新するには、ロケーションを追加するをご覧ください。

確認済みのエージェントは削除できません。確認済みまたは確認を試みたエージェントを削除するには、 お問い合わせください。（まず、ビジネス メッセージの Google アカウントでログインする必要があります。アカウントを登録するには、ビジネス メッセージに登録するをご覧ください）。

警告: エージェントを削除すると、ビジネス メッセージからエージェントに関するすべての情報が完全に削除されます。

エージェントを削除するには:

1. ビジネス コミュニケーション デベロッパー コンソールを開き、ビジネス メッセージの Google アカウントでログインします。
2. エージェントを選択します。
3. [概要] ページの下部にある [エージェントを削除] をクリックします。
4. 「DELETE」と入力し、[エージェントを削除] をクリックします。

エージェントを削除しても、関連するブランドデータは削除されません。Business Communications API を使用してブランドを削除します。

次のステップ

エージェントが作成されたら、次の手順を行います。

• エージェントに場所を追加する
• 会話エクスペリエンスを設計する
• メッセージ フローを開発する