本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

管理 RCS 代理程式

AWS RCS 代理程式是 AWS 最終使用者傳訊中最上層的資源，代表 RCS 訊息的品牌。它可做為統一的資源，將測試代理程式和國家/地區啟動代理程式 (RCS for Business IDs) 繫結在一起。關鍵字和雙向傳訊組態是在 AWS RCS 代理程式上定義。每個註冊都會定義品牌資產 （測試代理程式或國家/地區啟動代理程式）。如需 AWS RCS 代理程式如何與 RCS for Business IDs建立關聯的概觀，請參閱 什麼是 RCS？。

AWS RCS 代理程式遵循此生命週期：

一個 AWS RCS 代理程式映射到一個測試代理程式 （一個 RCS for Business ID) 加上多個國家/地區啟動代理程式 （每個國家/地區一個 RCS for Business ID)。當您在主控台中建立 AWS RCS 代理程式時，工作流程會立即引導您建立測試代理程式。然後，測試代理程式的品牌組態會用來預先填入國家/地區啟動註冊表單，以減少重複的資料輸入。

了解 AWS RCS 代理程式

AWS RCS 代理程式與其管理的 RCS for Business IDs 不同。下表摘要說明差異：

客服人員 ID 和 ARN

每個 AWS RCS 代理程式都有 格式的唯一識別符 rcs-a1b2c3d4（字首rcs-後接十六進位字串）。您在呼叫 UpdateRcsAgent和 等 API 操作時使用此 IDDeleteRcsAgent。

每個 AWS RCS 代理程式也有下列格式 AWS 的資源 ARN：

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

您可以在 API 中指定 AWS RCS 代理程式做為起始身分，SendTextMessage或將代理程式新增至電話集區時使用 ARN。

生命週期狀態

AWS RCS 代理程式會轉換下列生命週期狀態：

了解兩層身分模型

AWS 最終使用者傳訊中的 RCS 使用兩層身分模型：AWS RCS 代理程式和一或多個 RCS for Business IDs。

一個 AWS RCS 代理程式可以有下列 RCS for Business IDs：

下圖顯示這些身分之間的關係：

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 最終使用者傳訊主控台或 CreateRcsAgent API 來建立 AWS RCS 代理程式。當您建立代理程式時，您會在主控台中提供易記的名稱 （僅主控台的標籤以標籤形式存放，無法透過 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 最終使用者傳訊主控台或 DescribeRcsAgents API 檢視 AWS RCS 代理程式。

Console

若要在主控台中檢視您的 AWS RCS 代理程式，請導覽至導覽窗格中組態下的 RCS 代理程式頁面。清單頁面會顯示您帳戶中的所有 AWS RCS 代理程式，包括其目前的生命週期狀態、代理程式 ID 和顯示名稱。

選擇客服人員以檢視其詳細資訊，包括品牌資產、組態設定和相關聯的註冊。

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 代理程式的國家/地區啟動註冊後，您可以追蹤該國家/地區中每個電信業者的核准狀態。

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 代理程式可以在某國家/地區中至少有一個電信業者核准代理程式時立即傳送訊息。您不需要等待所有電信業者核准，即可開始傳送 RCS 訊息。當額外的電信業者核准您的代理程式時，您在該國家/地區的觸角會增加。

刪除 AWS RCS 代理程式

使用 DeleteRcsAgent API 永久刪除 AWS RCS 代理程式。當您刪除代理程式時，所有相關聯的 RCS for Business IDs（包括測試代理程式和所有國家/地區啟動代理程式） 都會停用。

您必須先刪除所有相關聯的註冊 （測試和國家/地區啟動註冊），然後停用刪除保護，才能刪除 AWS RCS 代理程式。如果啟用刪除保護，DeleteRcsAgentAPI 會傳回錯誤。若要停用刪除保護，請使用將刪除保護設為 的 UpdateRcsAgent APIfalse。