翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

RCS エージェントの管理

AWS RCS エージェントは、RCS メッセージングのブランドを表す AWS エンドユーザーメッセージングの最上位リソースです。これは、テストエージェントと国起動エージェント (RCS for Business IDs。キーワードと双方向メッセージング設定は、AWS RCS エージェントで定義されます。ブランドアセットは、各登録 (テストエージェントまたは国起動エージェント) で定義されます。AWS RCS エージェントと RCS for Business IDs「」を参照してくださいRCS とは。

AWS RCS エージェントはこのライフサイクルに従います。

1 つの AWS RCS エージェントは、1 つのテストエージェント (ビジネス ID の RCS) と複数の国起動エージェント (国ごとにビジネス ID の RCS) にマッピングされます。コンソールで AWS RCS エージェントを作成すると、ワークフローによってすぐにテストエージェントを作成するように指示されます。次に、テストエージェントのブランド設定を使用して国起動登録フォームを事前入力し、重複するデータ入力を減らします。

AWS RCS エージェントについて

AWS RCS エージェントは、管理する RCS for Business IDs とは異なります。次の表は、違いをまとめたものです。

エージェント ID と ARN

各 AWS RCS エージェントには、 形式の一意の識別子があります rcs-a1b2c3d4 (プレフィックスのrcs-後に 16 進文字列が続きます）。この ID は、 UpdateRcsAgentや などの API オペレーションを呼び出すときに使用しますDeleteRcsAgent。

各 AWS RCS エージェントには、次の形式の AWS リソース ARN もあります。

arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id

AWS RCS エージェントを SendTextMessage API の送信元 ID として指定するとき、またはエージェントを電話プールに追加するときに、ARN を使用できます。

ライフサイクル状態

AWS RCS エージェントは、次のライフサイクル状態に移行します。

2 レベルの ID モデルについて

AWS エンドユーザーメッセージングの RCS は、AWS RCS エージェントと 1 つ以上の RCS for Business IDs 2 つのレベルの ID モデルを使用します。

1 つの AWS RCS エージェントは、次の RCS for Business IDsを持つことができます。

次の図は、これらの ID の関係を示しています。

AWS RCS Agent (rcs-a1b2c3d4)
├── Testing agent (RCS for Business ID)
├── US country launch agent (US RCS for Business ID)
└── CA country launch agent (Canada RCS for Business ID)
        

キーワードと双方向メッセージングの送信先は AWS RCS エージェントで設定され、関連するすべての RCS for Business IDsに適用されます。ブランドアセットは、各登録 (テストエージェントまたは国起動エージェント) に固有です。AWS RCS エージェントには、フレンドリ名、削除保護、オプトアウトリストなどのアカウントレベルの設定も保持されます。

AWS RCS エージェントの作成

AWS RCS エージェントは、 AWS エンドユーザーメッセージングコンソールまたは CreateRcsAgent API を使用して作成できます。エージェントを作成するときは、コンソールでわかりやすい名前 (タグとして保存され、API では表示されない、または受信者の電話では表示されないコンソール専用ラベル) を指定し、削除保護やオプトアウトリストの関連付けなどのオプションの設定を行います。ブランドアセットは、AWS RCS エージェント自体ではなく、登録時に定義されます。

ブランドアセットの要件

ブランドアセットは、RCS メッセージとともに受信者に表示されます。ブランドアセットはテスト登録の一部として送信され、コンソールはエージェント作成ワークフローの継続として表示します。AWS RCS エージェントを作成するときは、次のアセットが必要です。

Console

AWS エンドユーザーメッセージングコンソールは、AWS RCS エージェントの作成と登録のテストを単一のガイド付きワークフローとして表示します。コンソールstep-by-step「」を参照してくださいステップ 1: AWS RCS エージェントを作成してテスト登録を送信する。

AWS CLI

create-rcs-agent コマンドを使用して AWS RCS エージェントを作成します。ブランドアセット (表示名、説明、ロゴ、バナー、ブランドカラー) は、このコマンドのパラメータではありません。これらは、テスト登録を作成するときに登録フィールドとして送信されます。

aws pinpoint-sms-voice-v2 create-rcs-agent \
    --deletion-protection-enabled

以下のオプションパラメータを使用できます。

• --deletion-protection-enabled — 削除保護が無効になるまで、エージェントが削除されないようにします。

• --opt-out-list-name — 既存のオプトアウトリストをエージェントに関連付けます。

• --tags — AWS RCS エージェントを整理して識別するためのキーと値のペア。

AWS RCS エージェントの更新

UpdateRcsAgent API を使用して、既存の AWS RCS エージェントの設定を変更します。次の設定を更新できます。

AWS RCS エージェントの表示

AWS RCS エージェントは、 AWS エンドユーザーメッセージングコンソールまたは DescribeRcsAgents API を使用して表示できます。

Console

コンソールで AWS RCS エージェントを表示するには、ナビゲーションペインの設定の下にある RCS エージェントページに移動します。リストページには、現在のライフサイクル状態、エージェント ID、表示名など、アカウント内のすべての AWS RCS エージェントが表示されます。

エージェントを選択すると、ブランドアセット、設定、関連する登録などの詳細が表示されます。

AWS CLI

describe-rcs-agents コマンドを使用して、アカウント内のすべての AWS RCS エージェントを一覧表示します。

aws pinpoint-sms-voice-v2 describe-rcs-agents

特定のエージェントの詳細を取得するには、 --rcs-agent-idsパラメータを使用します。

aws pinpoint-sms-voice-v2 describe-rcs-agents \
    --rcs-agent-ids rcs-a1b2c3d4

テストエージェントの確認

国の起動登録を送信する前に、テストエージェント設定を確認して、ブランドアセット、キーワード、メッセージング設定が正しいことを確認します。テストエージェントは国起動登録のテンプレートとして機能するため、続行する前に問題を解決する必要があります。

テストエージェントを確認するには、 AWS エンドユーザーメッセージングコンソールで AWS RCS エージェントに移動し、登録タブを選択します。テスト登録には、受信者のデバイスに表示されるロゴ、バナーイメージ、ブランドカラー、表示名など、現在のブランド設定が表示されます。

DescribeRegistrationFieldValues API を使用して、テスト登録の現在のフィールド値をプログラムで取得することもできます。

国の起動ステータスの表示

AWS RCS Agent の国起動登録を送信すると、その国の各キャリアの承認ステータスを追跡できます。

Console

コンソールで国起動ステータスを表示するには、AWS RCS エージェントの詳細ページに移動し、国起動ステータスタブを選択します。このタブには、起動登録を送信した各国の各キャリアの承認ステータスが表示されます。

AWS CLI

describe-rcs-agent-country-launch-status コマンドを使用して、キャリアごとの起動ステータスを取得します。

aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \
    --rcs-agent-id rcs-a1b2c3d4

レスポンスには、起動登録を送信した各国の各キャリアの承認ステータスが含まれます。

各キャリアはエージェントを個別に確認および承認します。AWS RCS エージェントは、その国の少なくとも 1 つのキャリアがエージェントを承認するとすぐに、その国でメッセージを送信できます。RCS メッセージの送信を開始する前に、すべてのキャリアが承認するのを待つ必要はありません。追加のキャリアがエージェントを承認すると、その国のリーチが増加します。

AWS RCS エージェントの削除

DeleteRcsAgent API を使用して AWS RCS エージェントを完全に削除します。エージェントを削除すると、関連するすべての RCS for Business IDs (テストエージェントとすべての国起動エージェントを含む) が非アクティブ化されます。

AWS RCS エージェントを削除する前に、まず関連するすべての登録 (テスト登録と国起動登録の両方) を削除してから、削除保護を無効にする必要があります。削除保護が有効になっている場合、DeleteRcsAgentAPI はエラーを返します。削除保護を無効にするには、削除保護を に設定して UpdateRcsAgent API を使用しますfalse。