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

エージェント ブランドに代わってユーザーにメッセージを送信するプログラム エンティティ。エージェントには、ユーザーが操作するインターフェースと、操作に必要なコードやインフラストラクチャが含まれます。エージェントは、通知の送信などの一方向のシンプルなエクスペリエンスを提供することも、会話形式でユーザーの応答に反応することもできます。

ユーザーは、デバイスの Google メッセージなどの RCS 対応メッセージ アプリを通じてエージェントとやり取りします。このクイックスタートでは、テストデバイスに簡単なメッセージを送信してレスポンスを受信できる、基本的な RCS for Business エージェントを作成します。

前提条件

エージェントの使用を開始する前に、次のものが必要になります。

• エージェントが代表するブランドの名前
• エージェントの
  • 名前
  • エージェントが動作するリージョン
  • 請求カテゴリ
  • ユースケース
• 有効な電話番号が設定されている Android デバイス
• サンプルコードを実行できる開発マシン

テストデバイスをセットアップする

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

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

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

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

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

次のステップ

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

エージェントを設定する

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

エージェントのリージョンを特定する

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

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

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

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

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

注: エージェントを作成した後で、エージェントのリージョンを変更することはできません。

エージェントの課金カテゴリを決定する

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

• 会話型: ユーザーとマルチターンの会話を行うエージェント。
• Basic Message または Single Message: 頻繁な返信を想定せずにメッセージを送信するエージェント向け。

注: 会話以外の 2 つの請求カテゴリ（Basic Message と Single Message）は、まったく同じように機能します。これは歴史的な経緯によるもので、現在簡素化に取り組んでいます。当面の間は、会話以外のメッセージ（プレーン テキストまたはリッチカード）にどちらのカテゴリを使用しても構いません。標準の会話以外のレートで課金されます。詳細については、エージェントの課金カテゴリをご覧ください。

エージェントの請求カテゴリを変更できるのは、エージェントを起動する前のみです。リリース後に請求カテゴリを変更する必要がある場合は、[e-mail] までメールでお問い合わせください。

標準の RCS またはビジネスの課金モデルについて詳しくは、課金に関するよくある質問をご覧ください。

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

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

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

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

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

エージェントを作成する

Business Communications デベロッパー コンソールでエージェントを作成する手順は次のとおりです。

注: RBM Management API を使用してエージェントを作成するには、エージェントを管理するのドキュメントを参照してください。

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

1. Business Communications Developer Console にアクセスし、RCS for Business パートナーの Google アカウントでログインします。
2. ホームページで、[+ エージェントを作成] をクリックします。
3. [New RCS Business Messaging] ウィンドウで、次の情報を指定します。
   • エージェントが代理を務めるブランド
   • エージェント名
   • ホスティング リージョン
   • 請求カテゴリ
   • ユースケース
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!"
  },
  "messageTrafficType": "PROMOTION"
}'

• エージェントのリージョンに応じて、REGION を asia、europe、または us に置き換えます。
• PHONE_NUMBER は、テストデバイスの電話番号に置き換えます。国コード、市外局番、先頭の + を含めますが、区切り文字は含めません。例: [phone]
• AGENT ID は、Business Communications Developer Console の [エージェント情報] ページにあるエージェント ID に置き換えます。
• PATH_TO_SERVICE_ACCOUNT_KEY は、先ほど作成したキーのパスに置き換えます。

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

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

次のステップ

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

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