本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 管理 RCS 代理程式 AWS RCS 代理程式是 AWS 最終使用者傳訊中最上層的資源，代表 RCS 訊息的品牌。它可做為統一的資源，將測試代理程式和國家/地區啟動代理程式 (RCS for Business IDs) 繫結在一起。關鍵字和雙向傳訊組態是在 AWS RCS 代理程式上定義。每個註冊都會定義品牌資產 （測試代理程式或國家/地區啟動代理程式）。如需 AWS RCS 代理程式如何與 RCS for Business IDs建立關聯的概觀，請參閱 [什麼是 RCS？](rcs-overview.md)。 AWS RCS 代理程式遵循此生命週期： 1. **建立** AWS RCS 代理程式。 1. **新增測試代理程式 **（包含在主控台建立流程中；透過 CLI 選用）。 1. 使用已註冊**的測試**裝置測試 RCS 訊息。測試不需要任何電信業者核准。 1. 針對您要傳送生產 RCS 訊息的每個國家/地區，提交國家/地區**啟動**註冊。 1. **部分核准**：至少有一個電信業者已核准您的客服人員。您可以開始在核准的電信業者上傳送給收件人。 1. **完全核准**：該國的所有電信業者都已核准您的客服人員。該國的完整觸角。 一個 AWS RCS 代理程式映射到一個測試代理程式 （一個 RCS for Business ID) 加上多個國家/地區啟動代理程式 （每個國家/地區一個 RCS for Business ID)。當您在主控台中建立 AWS RCS 代理程式時，工作流程會立即引導您建立測試代理程式。然後，測試代理程式的品牌組態會用來預先填入國家/地區啟動註冊表單，以減少重複的資料輸入。 **Topics** + [了解 AWS RCS 代理程式](#rcs-agents-concept) + [了解兩層身分模型](#rcs-agents-identity-model) + [建立 AWS RCS 代理程式](#rcs-agents-create) + [更新 AWS RCS 代理程式](#rcs-agents-update) + [檢視 AWS RCS 代理程式](#rcs-agents-view) + [檢閱您的測試代理程式](#rcs-agents-review-test-agent) + [檢視國家/地區啟動狀態](#rcs-agents-country-launch-status) + [刪除 AWS RCS 代理程式](#rcs-agents-delete) ## 了解 AWS RCS 代理程式 AWS RCS 代理程式與其管理的 RCS for Business IDs 不同。下表摘要說明差異： **AWS RCS 代理程式與 RCS for Business ID 的比較** | 屬性 | AWS RCS 代理程式 | RCS for Business ID | | --- | --- | --- | | 受管者 | 您透過 AWS 最終使用者傳訊主控台或 API | AWS 註冊程序期間的最終使用者傳訊 | | Scope (範圍) | 每個品牌或每個使用案例一個 | 每個國家/地區啟動一個，加上一個測試代理程式 | | Configuration | 易記名稱、刪除保護、選擇退出清單、標籤、關鍵字、雙向傳訊目的地 | 註冊期間定義的品牌資產和其他設定 | | 識別符 | rcs-a1b2c3d4 格式 | 由 RCS 基礎設施供應商在內部管理 | ### 客服人員 ID 和 ARN 每個 AWS RCS 代理程式都有 格式的唯一識別符 `rcs-a1b2c3d4`（字首`rcs-`後接十六進位字串）。您在呼叫 `UpdateRcsAgent`和 等 API 操作時使用此 ID`DeleteRcsAgent`。 每個 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 for Business ID)，可以傳送訊息至已註冊的測試裝置。尚未完成國家/地區啟動註冊。 **部分** 至少已完成一個國家/地區啟動註冊，但並非所有提交的國家/地區啟動都處於作用中狀態。客服人員可以在已核准的國家/地區傳送訊息，但只能傳送給已核准客服人員之特定電信業者的收件人 （們）。一旦某個國家/地區的至少一個電信業者處於作用中狀態， `CountryStatus` 就會移至 PARTIAL。 **ACTIVE** 所有提交的國家/地區啟動註冊都已完成且處於作用中狀態。代理程式可在所有已註冊的國家/地區完全運作。請注意，在提交新的國家/地區啟動註冊時，ACTIVE 代理程式可以返回 PARTIAL 狀態，因為新的國家/地區尚未核准。 **DELETED** 已刪除 AWS RCS 代理程式。所有相關聯的 RCS for Business IDs（測試和國家/地區啟動代理程式） 都會停用。這個動作無法復原。 ## 了解兩層身分模型 AWS 最終使用者傳訊中的 RCS 使用兩層身分模型：**AWS RCS 代理程式**和一或多個 **RCS for Business IDs**。 **AWS RCS 代理程式** AWS RCS 代理程式是您在 AWS 最終使用者傳訊中建立和管理的最上層資源。它可做為統一的資源，將測試代理程式和國家/地區啟動代理程式繫結在一起。關鍵字和雙向傳訊組態是在 AWS RCS 代理程式上定義。每個註冊都會定義品牌資產。每個 AWS RCS 代理程式都有格式的唯一識別符`rcs-a1b2c3d4`和資源 AWS ARN。將 AWS RCS 代理程式視為您品牌在您啟動 RCS 的所有國家/地區的統一身分。 **RCS for Business ID** RCS for Business ID 是在註冊程序期間使用 RCS 基礎設施提供者建立的每個國家代理程式身分。每個國家/地區啟動都會在您的 AWS RCS 代理程式下建立個別的 RCS for Business ID。您不會直接管理 RCS for Business IDs。 AWS 最終使用者傳訊會在註冊程序中處理建立和生命週期。 一個 AWS RCS 代理程式可以有下列 RCS for Business IDs： + **一個測試代理程式** — 在測試註冊階段建立的 RCS for Business ID。測試代理程式可與已註冊的測試裝置搭配使用，並可讓您在生產環境中啟動之前驗證 RCS 整合。測試訊息按標準費率收費。 + **多國家/地區啟動代理**程式 — 您啟動 RCS 的每個國家/地區都會建立個別的 RCS for Business ID。例如，如果您同時在美國和加拿大啟動，除了測試代理程式之外，您的 AWS RCS 代理程式還有兩個國家/地區啟動代理程式 （一個美國 RCS for Business ID 和一個加拿大 RCS for Business 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 最終使用者傳訊主控台或 `CreateRcsAgent` API 來建立 AWS RCS 代理程式。當您建立代理程式時，您會在主控台中提供易記的名稱 （僅主控台的標籤以標籤形式存放，無法透過 API 顯示或顯示在收件人的手機上），並設定選擇性設定，例如刪除保護和選擇退出清單關聯。品牌資產是在註冊時定義，而不是在 AWS RCS 代理程式本身。 ### 品牌資產需求 您的品牌資產會與您的 RCS 訊息一起顯示給收件人。品牌資產會做為測試註冊的一部分提交，主控台會呈現為代理程式建立工作流程的延續。建立 AWS RCS 代理程式時需要下列資產： **標誌** 代表您的品牌的方形影像。標誌與您的訊息一起顯示在簡訊應用程式中。 + 維度：224 × 224 像素 + 格式：具有透明度的 PNG + 檔案大小上限：50 KB **橫幅影像** 顯示在簡訊應用程式中客服人員設定檔頂端的寬影像。橫幅影像只會在 Android 裝置上顯示。 + 維度：1440 × 448 像素 + 格式：PNG 或 JPEG + 檔案大小上限：200 KB **品牌顏色** 在簡訊應用程式中用作重音顏色的十六進位顏色代碼 （例如 `#1A73E8`)。顏色與白色背景的最小對比度必須為 4.5：1，以符合可存取性要求。如果未正確設定對比比率，您的代理可能未獲得核准。 **重要** 建立代理程式後，品牌資產對變更有限制。一旦代理提交註冊，就無法修改某些品牌資產。在建立 AWS RCS 代理程式之前準備您的最終品牌資產。 ------ #### [ Console ] AWS 最終使用者傳訊主控台會將 AWS RCS 代理程式建立和測試註冊顯示為單一引導式工作流程。如需step-by-step主控台說明，請參閱 [步驟 1：建立 AWS RCS 代理程式並提交測試註冊](rcs-getting-started.md#rcs-getting-started-create-agent)。 ------ #### [ 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 代理程式的設定。您可以更新下列設定： + **刪除保護** — 啟用或停用代理程式的刪除保護。 + **選擇退出清單** — 將選擇退出清單與客服人員建立關聯或取消關聯。 + **雙向傳訊目的地** — 設定傳入訊息的 Amazon SNS 主題和 IAM 角色。RCS 一律啟用雙向傳訊。客戶會以標準費率支付所有傳入 RCS 訊息的費用。此設定會控制傳入訊息的傳遞位置，而不是接收到的訊息。 **注意** 透過 API 變更 AWS RCS 代理程式設定可立即使用。不過，RCS 基礎設施供應商會檢閱品牌資產的更新 （註冊欄位，例如標誌、橫幅和顯示名稱），而且可能需要一些時間才能出現在收件人的裝置上。若要確認您的 API 變更已套用，請使用 `DescribeRcsAgents` API 在 AWS 最終使用者傳訊中確認目前的代理程式組態。 ## 檢視 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 代理程式是永久性的，無法復原。與代理程式相關聯的所有註冊、國家/地區啟動和測試組態都會遺失。 您必須先刪除所有相關聯的註冊 （測試和國家/地區啟動註冊），然後停用刪除保護，才能刪除 AWS RCS 代理程式。如果啟用刪除保護，`DeleteRcsAgent`API 會傳回錯誤。若要停用刪除保護，請使用將刪除保護設為 的 `UpdateRcsAgent` API`false`。 **刪除 AWS RCS 代理程式** 1. 如果啟用刪除保護，請呼叫將刪除保護設定為 的 `UpdateRcsAgent` API 來停用它`false`。 1. 使用您要刪除的 AWS RCS 代理程式的代理程式 ID 或 ARN 呼叫 `DeleteRcsAgent` API。 1. 呼叫 `DescribeRcsAgents` API 來確認代理程式已刪除。代理程式不應再出現在結果中，否則其狀態應為刪除。