View a markdown version of this page

在集區中管理 AWS RCS 代理程式 - AWS 最終使用者傳訊簡訊

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

在集區中管理 AWS RCS 代理程式

您可以新增 AWS RCS 代理程式做為電話集區中的起始身分,以及 SMS 電話號碼。當集區同時包含 AWS RCS 代理程式和 SMS 電話號碼時, AWS 最終使用者傳訊會先嘗試 RCS 交付,並在無法進行 RCS 交付時自動回到 SMS。如需備用運作方式的詳細資訊,請參閱 使用電話集區的 RCS 到 SMS 備用

注意

當您將 AWS RCS 代理程式新增至集區時,請使用 ZZ做為 ISO 國家/地區碼。此ZZ程式碼表示 RCS 代理程式在集區層級不是國家/地區特定。國家特定路由是透過客服人員的國家/地區啟動註冊來處理。集區可以包含來自多個國家/地區的電話號碼,以及 RCS 代理程式。

ISO 國家/地區代碼會在集區建立時提供,但不會保留在集區上。如果您呼叫 DescribePools,ISO 國家/地區代碼不會出現在回應中。

使用 AWS RCS 代理程式建立集區

您可以使用 AWS 最終使用者傳訊主控台或 CreatePool API 建立新的集區,其中包含您的 AWS RCS 代理程式。

Console
使用主控台建立具有 AWS RCS 代理程式的集區
  1. 開啟 AWS 最終使用者傳訊主控台。

  2. 在導覽窗格中,選擇電話集區

  3. 選擇建立集區

  4. 針對原始身分,選取您的 AWS RCS 代理程式。集區會從您選取的起始身分繼承其組態。

  5. 視需要設定集區設定,然後選擇建立集區

  6. 建立集區之後,請將您的 SMS 電話號碼新增至集區,以啟用 SMS 備用。集區中的所有起始身分都必須具有相符的組態。如需詳細資訊,請參閱RCS 的集區組態需求

AWS CLI

使用 CreatePool API 以您的 AWS RCS 代理程式做為初始起始身分來建立集區。建立集區時,請將 AWS RCS 代理程式 ARN 指定為起始身分。

下列範例使用 CLI AWS 建立集區:

aws pinpoint-sms-voice-v2 create-pool \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ \ --message-type TRANSACTIONAL

建立集區之後,請使用 AssociateOriginationIdentity API 將 SMS 電話號碼新增至集區以進行備用。

將 AWS RCS 代理程式新增至現有集區

如果您已有具有簡訊電話號碼的集區,您可以將 AWS RCS 代理程式新增至集區,以啟用具有簡訊備用功能的 RCS 訊息。您也可以將其他簡訊電話號碼新增至已包含 AWS RCS 代理程式的集區。

重要

將起始身分新增至現有集區之前,請確認集區的組態與您新增的身分相符。集區中的所有起始身分必須具有相同的中繼資料。如果不相符,操作會失敗並顯示 ConflictException。如需哪些欄位必須相符以及如何解決不相符的詳細資訊,請參閱 RCS 的集區組態需求

Console

使用主控台將 AWS RCS 代理程式新增至集區之前,請檢查集區的詳細資訊頁面,以檢閱其目前的組態。確認集區的訊息類型、ISO 國家/地區碼和其他設定與您要新增的 AWS RCS 代理程式相容。

使用主控台將 AWS RCS 代理程式新增至現有集區
  1. 開啟 AWS 最終使用者傳訊主控台。

  2. 在導覽窗格中,選擇電話集區

  3. 選擇您要新增 AWS RCS 代理程式的集區。

  4. 在詳細資訊頁面上檢閱集區的組態。確認訊息類型和其他設定符合您要新增的 AWS RCS 代理程式。

  5. 起始身分區段中,選擇新增起始身分

  6. 從清單中選擇您的 AWS RCS 代理程式,然後選擇新增

AWS CLI

使用 CLI 或 API 將 AWS RCS 代理程式新增至集區之前,請使用 DescribePools API 擷取集區目前的組態。確認集區的設定符合您要新增的 AWS RCS 代理程式。

下列範例會擷取集區詳細資訊:

aws pinpoint-sms-voice-v2 describe-pools \ --pool-ids pool-id

確認組態相符後,請使用 AssociateOriginationIdentity API 將 AWS RCS 代理程式新增至集區:

aws pinpoint-sms-voice-v2 associate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

RCS 的集區組態需求

集區中的所有起始身分必須具有相同的中繼資料。當您將起始身分新增至集區時, AWS 最終使用者傳訊會將身分的組態與集區的現有組態進行比較。如果不相符,操作會失敗ConflictException,其中包含不同特定欄位的詳細資訊。

集區組態欄位分為兩個類別:建立集區時設定且無法變更的不可變欄位,以及您可以在建立後更新的可變欄位。

不可變與可變集區組態欄位
欄位 可變更性 備註
訊息類型 固定 在集區建立時設定 。所有身分都必須相符。
ISO 國家/地區代碼 固定 在集區建立時設定 。對於 AWS RCS 代理程式,值為 ZZ。集區可以包含來自多個國家/地區的電話號碼。
刪除保護 Mutable 可在建立後切換。必須在身分之間保持一致。
選擇不接收清單 Mutable 可以在建立後變更。必須在身分之間保持一致。

下列組態欄位必須符合集區中所有起始身分:

  • 訊息類型 — 必須針對相同的訊息類型設定所有身分 (例如 TRANSACTIONAL 或 PROMOTIONAL)。

  • ISO 國家/地區代碼 — 在集區建立時設定。對於 AWS RCS 代理程式,請使用 ZZ做為 ISO 國家/地區碼。集區可以包含來自多個國家/地區的電話號碼。

  • 刪除保護 — 刪除保護設定必須跨身分保持一致。

  • 選擇退出清單 — 所有身分都必須與相同的選擇退出清單相關聯,否則這些身分都不應有選擇退出清單。

了解 ConflictException 錯誤

當您嘗試將起始身分新增至集區,且組態不相符時, AssociateOriginationIdentityCreatePool API 會傳回 ConflictException。例外狀況訊息包含有關哪些欄位在身分和集區之間不同的詳細資訊。

例如,如果您嘗試將針對 PROMOTIONAL 訊息設定的電話號碼新增至針對 TRANSACTIONAL 訊息設定的集區,錯誤訊息會指出訊息類型不相符。

若要解析 ConflictException

  1. 檢閱錯誤訊息以識別哪些欄位不同。

  2. 更新起始身分或集區組態,讓欄位相符。

  3. 重試 AssociateOriginationIdentityCreatePool操作。

注意

如果您無法解決組態不相符的問題,請考慮為起始身分建立單獨的集區。每個集區都可以有自己的組態,而且您可以針對不同的使用案例使用不同的集區。

從集區移除 AWS RCS 代理程式

您可以使用 AWS 最終使用者傳訊主控台或 DisassociateOriginationIdentity API,從集區中移除 AWS RCS 代理程式。從集區移除 AWS RCS 代理程式會停用透過該集區傳送之訊息的 RCS 交付。移除代理程式後傳送到集區的訊息只會透過 SMS 傳遞 (使用集區中剩餘的電話號碼)。

Console
使用主控台從集區移除 AWS RCS 代理程式
  1. 開啟 AWS 最終使用者傳訊主控台。

  2. 在導覽窗格中,選擇電話集區

  3. 選擇包含您要移除之 AWS RCS 代理程式的集區。

  4. 起始身分區段中,選取 AWS RCS 代理程式。

  5. 選擇移除,然後確認移除。

AWS CLI

使用 DisassociateOriginationIdentity API 從集區中移除 AWS RCS 代理程式:

aws pinpoint-sms-voice-v2 disassociate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

移除 AWS RCS 代理程式後,透過集區傳送的訊息只會透過 SMS 傳送。若要重新啟用 RCS 交付,請使用 AssociateOriginationIdentity API 將 AWS RCS 代理程式新增至集區。