最初のエージェントの作成

ユーザーは、デバイス上の RCS 対応のメッセージ アプリ（Google メッセージなど）を使用してエージェントとやり取りします。このクイックスタートでは、テストデバイスにシンプルなメッセージを送信してレスポンスを受信できる基本的な RBM エージェントを作成します。

RBM 対応の会話でのメッセージのフロー

前提条件

エージェントを使用するには、次のものが必要です。

テストデバイスを設定する

リリースされていない RBM エージェントと通信するには、テストデバイスで RCS が有効になっている必要がありますが、すべての Android デバイスがデフォルトで RCS メッセージを受信できるわけではありません。デバイスの RCS のステータスを確認したり、必要に応じて RCS を有効にしたりするには、メッセージ アプリと Carrier Services アプリのプレリリース バージョンを使用してデバイスを構成します。

デバイスの RCS ステータスを確認する

  1. メッセージ アプリで ボタン、[設定] の順にタップします。

  2. [チャット機能] をタップし、[ステータス] の値を確認します。

    [ステータス] が [接続済み] の場合、デバイスで RCS が有効になっています。

次のステップ

デバイスで RCS が有効になっている場合は、エージェントをセットアップする準備が整っています。デバイスで RCS が有効になっていない場合は、RBM エージェントをテストする前に、デバイスで RCS を有効にする必要があります。

エージェントを設定する

RBM エージェントは RBM API を使用して、メッセージ、イベント、その他のリクエストをユーザーに送信します。エージェントを作成するときに、RBM API へのアクセスを有効にして、エージェントの基本情報を定義します。

エージェントのリージョンを確認する

RBM エージェントは、北米、ヨーロッパ、アジア太平洋の 3 つのリージョンのいずれかに存在できます。RBM API は3 つのリージョン エンドポイントをサポートしており、企業が地域およびビジネス要件を遵守するのに役立ちます。

エージェントを作成する際は、該当する規制、要件、エンドユーザーとの近さに基づいて、エージェントのリージョンを選択します。このリージョンによって、エージェントが操作を行う場所とデータを保存する場所が決まります。

ユーザーまたは想定ユーザーがこれらのリージョンに該当しない場合は、レイテンシを最小限に抑えるために、ユーザーに最も近いリージョンを選択します。次に例を示します。

  • 中南米にお住まいの場合は、北米リージョンを選択します。
  • アフリカにお住まいの場合は、ヨーロッパのリージョンを選択します。
  • オーストラリアにお住まいの場合は、アジア太平洋リージョンを選択します。

ターゲット キャリアに基づいてエージェントの地域を決定しないでください。すべての地域で、世界中の携帯通信会社に均等にアクセスできます。

エージェントの請求カテゴリを確認する

RBM エージェントを作成する際は、エージェントがユーザーとどのようにやり取りするかに基づいて、課金カテゴリを指定する必要があります。エージェントの意図した動作に最も近いカテゴリを選択します。

  • 会話型: ユーザーとのマルチターンの会話を行うエージェント向け。
  • 基本メッセージまたは単一メッセージ: 頻繁な返信を期待せずにメッセージを送信するエージェント向け。

エージェントの請求カテゴリを変更できるのは、エージェントをリリースする前のみです。リリース後に課金カテゴリを変更する必要がある場合は、rbm-support@google.com までメールでお問い合わせください。

RBM の課金モデルの詳細については、RBM の課金に関するよくある質問をご覧ください。

エージェントのユースケースを特定する

各 RBM エージェントには、事前定義されたユースケースが必要です。これにより、エージェントを分類し、適切なビジネスルールを適用して優れたユーザー エクスペリエンスを実現できます。RBM は次の 4 つのユースケースをサポートしています。

  • OTP: アカウントの安全な認証や取引の確認に必要なワンタイム パスワード。
  • トランザクション: アカウントの不審なアクティビティに関するアラート、購入確認、配送通知など、お客様の既存のサービスや商品に直接関連する情報を共有する通知、更新、アラート。
  • プロモーション: 新規顧客または既存顧客への販売、マーケティング、プロモーション メッセージ。認知度、エンゲージメント、売り上げの向上を目的としています。
  • マルチユース: アカウント通知の送信後に割引特典や新しいプロダクトやサービスへのアップグレードを提示するなど、トランザクション メッセージとプロモーション メッセージを組み合わせた会話。

ユースケースごとに、送信できる内容に関するルールが異なります。各ユースケースの詳細と、エージェントに最適なユースケースについては、エージェントに適したユースケースを選択するをご覧ください。

エージェントのリリースを送信した後は、ユースケースを変更できません。エージェントを送信する前に、お客様の国のユースケースとビジネスルールを確認してください。

エージェントを作成する

ビジネス コミュニケーション デベロッパー コンソールでエージェントを作成する手順は次のとおりです。

エージェントを作成する手順は次のとおりです。

  1. ビジネス コミュニケーション デベロッパー コンソールにアクセスし、RBM パートナーの Google アカウントでログインします。
  2. ホームページで、[+ エージェントを作成] をクリックします。
  3. [New RCS Business Messaging agent] ウィンドウで、次の情報を指定します。
  4. [Create Agent（エージェントを作成）] をクリックします。

エージェントが利用可能になると、ビジネス情報とブランディング情報を追加できます。エージェントを作成するをご覧ください。

テストデバイスを招待する

エージェントが作成され、テストデバイスで RCS が有効になっているので、デバイスを招待してエージェントをテストできます。

  1. 左側のナビゲーションで [デバイス] をクリックします。
  2. [テストデバイスを追加] でデバイスの電話番号を入力し、[追加] をクリックします。
  3. テストデバイスで、エージェントのテスター リクエストを承認します。

テストデバイスに招待状が届かない場合は、デバイスで RCS が有効になっていることを確認します。

メッセージを送信する

テストデバイスが登録されたので、エージェントはメッセージを送信できるようになりました。

API 呼び出しを安全に認証するには、サービス アカウント キーが必要です。パートナー アカウントのサービス アカウント キーをまだ作成していない場合は、ここで作成します。

開発マシンのターミナルで次のコマンドを実行します。

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'
  • REGION は、エージェントのリージョンに応じて、asia、europe、または us に置き換えます。
  • PHONE_NUMBER は、テストデバイスの電話番号に置き換えます。国コード、市外局番、先頭の + を含めますが、区切り文字は含めないでください。例: +14155555555
  • AGENT ID は、Business Communications Developer Console の [エージェント情報] ページにあるエージェント ID に置き換えます。
  • PATH_TO_SERVICE_ACCOUNT_KEY は、前に作成したキーのパスに置き換えます。

テストデバイスでエージェントから「Hello, world!」というメッセージが届きます。テストデバイスにメッセージが表示されない場合は、コマンドで電話番号とサービス アカウント キーのパスを正しく入力してフォーマットしていることを確認します。

返信候補やリッチカードなど、さまざまなタイプのメッセージを送信するには、メッセージを送信するをご覧ください。

次のステップ

エージェントがテストデバイスにメッセージを送信できるようになったので、ビジネスニーズに合ったものを作成しましょう。ご希望の言語でサンプル エージェントを取得し、サンプルの README の手順に沿って操作します。

サンプル エージェントを構成したら、RBM のベスト プラクティスを確認し、エージェントがメッセージを送信して受信する方法を確認します。

前へ
パートナー アカウントを設定する