更新: 新機能とサービスの更新については、リリースノートをご覧ください。

このページは Cloud Translation API によって翻訳されました。

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

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

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

前提条件

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

エージェントが代理を務めるブランドの名前
エージェントの
有効な電話番号が設定されている Android デバイス
サンプルコードを実行できる開発マシン

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

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

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

メッセージアプリでボタン、[設定] の順にタップします。
[チャット機能] をタップし、[ステータス] の値を確認します。

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

次のステップ

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

エージェントを設定する

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

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

RBM API は、3 つのリージョンエンドポイントをサポートしており、企業が地域およびビジネス要件に準拠するのに役立ちます。RBM エージェントは、次の 3 つのリージョンのいずれかに存在できます。

北アメリカ
ヨーロッパ
アジア太平洋

エージェントを作成する際は、該当する規制、要件、エンドユーザーとの近さに基づいてリージョンを選択します。地域は国に固有のものではありません。エージェントが営業している地域を特定します。Google は、この情報を使用して、メッセージデータを保存する場所と、メッセージトラフィックを適切にルーティングする方法を決定します。

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

ネットワークで RBM コンテンツを承認する携帯通信会社は、この課金フレームワークを使用して、RBM メッセージを定期購入者に配信する料金も請求します。

会話 - 特定の期間内に複数の A2P メッセージと P2A メッセージで構成される会話に対する料金。
単一メッセージ - リッチ RBM コンテンツ（リッチカードやカルーセルを含むメッセージなど）を含む単一のメッセージに対して課金されます。
基本メッセージ - 最大 160 文字のテキストメッセージの料金。

エージェントを作成するときに、エージェントロジックの動作に最も近い課金カテゴリを選択します。

会話型 - このエージェントは、メッセージが双方向でやり取りされる複雑なユーザーインタラクションに対応します。

次の 2 つのカテゴリでは、会話型課金イベントが決して作成されません。携帯通信会社は、配信されるコンテンツに応じて、メッセージごとに基本メッセージ料金または単一メッセージ料金を請求します。

単一メッセージ - 通常、このエージェントはリッチメッセージを送信し、返信を期待することはほとんどありません。
基本メッセージ - このエージェントは SMS から RBM へのアップグレードを実装し、返信を受け取ることはほとんどありません。通常、エージェントは 160 文字までのプレーンテキストメッセージを送信する必要があります。ただし、エージェントは制限されません。プログラムされている場合は、より豊富なコンテンツを送信できます。その場合、それに応じて課金されます。

エージェントを起動する前に、エージェントの請求カテゴリを変更できます。別の請求カテゴリへの変更については、お問い合わせください。

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

各 RBM エージェントは、エンドユーザーとの会話の性質を反映し、企業がビジネスルールに準拠できるように、事前定義されたユースケースを用意する必要があります。RBM は次の 4 つのユースケースをサポートしています。

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

各ユースケースを使用するタイミングについて詳しくは、適切なユースケースを選択するをご覧ください。

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

エージェントを作成する

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

ビジネスコミュニケーションデベロッパーコンソールを開き、RBM パートナーの Google アカウントでログインします。
[Create Agent（エージェントを作成）] をクリックします。
[エージェントタイプ] で [RCS ビジネスメッセージ] を選択します。
[ブランド] で、エージェントが代理人となるブランドを選択するか、[新しいブランドを追加] をクリックして名前を入力します。
エージェントの名前を入力し、エージェントの地域、課金カテゴリ、ユースケースを選択します。[Create agent] をクリックします。
エージェントが対応可能になったら、エージェントの名前をクリックします。

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

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

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

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

テストデバイスに招待状が届かない場合は、デバイスで 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 のベストプラクティスを確認し、エージェントがメッセージを送信して受信する方法を確認します。

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