View a markdown version of this page

Gestione degli agenti AWS RCS nei pool - AWS SMS di messaggistica per l'utente finale

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestione degli agenti AWS RCS nei pool

Puoi aggiungere un agente AWS RCS come identità di origine in un pool di telefoni insieme ai tuoi numeri di telefono SMS. Quando un pool contiene sia un agente AWS RCS che numeri di telefono SMS, AWS End User Messaging tenta prima la consegna RCS e torna automaticamente agli SMS se la consegna RCS non è possibile. Per dettagli su come funziona il fallback, consulta. Fallback da RCS a SMS utilizzando pool di telefoni

Nota

Quando aggiungi un agente AWS RCS a un pool, usalo ZZ come codice paese ISO. Il ZZ codice indica che l'agente RCS non è specifico del paese a livello di pool. Il routing specifico per paese viene gestito tramite le registrazioni di lancio per paese dell'agente. Oltre all'agente RCS, un pool può contenere numeri di telefono di più paesi.

Il codice ISO del paese viene fornito al momento della creazione del pool ma non viene mantenuto nel pool. Se chiamiDescribePools, il codice ISO del paese non compare nella risposta.

Creazione di un pool con un agente AWS RCS

Puoi creare un nuovo pool che include il tuo agente AWS RCS utilizzando la console di messaggistica dell'utente AWS finale o l'CreatePoolAPI.

Console
Per creare un pool con un agente AWS RCS utilizzando la console
  1. Apri la console di messaggistica per l'utente AWS finale.

  2. Nel riquadro di navigazione, scegli Pool telefonici.

  3. Scegli Crea pool.

  4. Per l'identità di origine, seleziona il tuo agente AWS RCS. Il pool eredita la sua configurazione dall'identità di origine selezionata.

  5. Configura le impostazioni del pool secondo necessità, quindi scegli Crea pool.

  6. Dopo aver creato il pool, aggiungi i tuoi numeri di telefono SMS al pool per abilitare il fallback degli SMS. Tutte le identità di origine nel pool devono avere una configurazione corrispondente. Per informazioni dettagliate, vedi Requisiti di configurazione del pool per RCS.

AWS CLI

Usa l'CreatePoolAPI per creare un pool con il tuo agente AWS RCS come identità di origine iniziale. Specificare l'ARN dell'agente AWS RCS come identità di origine durante la creazione del pool.

L'esempio seguente crea un pool utilizzando la AWS CLI:

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

Dopo aver creato il pool, utilizzate l'AssociateOriginationIdentityAPI per aggiungere numeri di telefono SMS al pool per il fallback.

Aggiungere agenti AWS RCS ai pool esistenti

Se disponi già di un pool con numeri di telefono SMS, puoi aggiungere il tuo agente AWS RCS al pool per abilitare la messaggistica RCS con fallback SMS. Puoi anche aggiungere altri numeri di telefono SMS a un pool che contiene già un agente AWS RCS.

Importante

Prima di aggiungere un'identità di origine a un pool esistente, verifica che la configurazione del pool corrisponda all'identità che stai aggiungendo. Tutte le identità di origine in un pool devono avere metadati identici. Se c'è una mancata corrispondenza, l'operazione fallisce e restituisce un. ConflictException Per i dettagli sui campi che devono corrispondere e su come risolvere le mancate corrispondenze, vedere. Requisiti di configurazione del pool per RCS

Console

Prima di aggiungere un agente AWS RCS a un pool utilizzando la console, consulta la pagina dei dettagli del pool per esaminarne la configurazione corrente. Verifica che il tipo di messaggio del pool, il codice paese ISO e altre impostazioni siano compatibili con l'agente AWS RCS che desideri aggiungere.

Per aggiungere un agente AWS RCS a un pool esistente utilizzando la console
  1. Apri la console di messaggistica per l'utente AWS finale.

  2. Nel riquadro di navigazione, scegli Pool telefonici.

  3. Scegli il pool a cui vuoi aggiungere l'agente AWS RCS.

  4. Controlla la configurazione del pool nella pagina dei dettagli. Verifica che il tipo di messaggio e le altre impostazioni corrispondano all'agente AWS RCS che desideri aggiungere.

  5. Nella sezione Identità di origine, scegli Aggiungi identità di origine.

  6. Seleziona il tuo agente AWS RCS dall'elenco e scegli Aggiungi.

AWS CLI

Prima di aggiungere un agente AWS RCS a un pool utilizzando la CLI o l'API, utilizza DescribePools l'API per recuperare la configurazione corrente del pool. Verifica che le impostazioni del pool corrispondano all'agente AWS RCS che desideri aggiungere.

L'esempio seguente recupera i dettagli del pool:

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

Dopo aver confermato le corrispondenze di configurazione, utilizza l'AssociateOriginationIdentityAPI per aggiungere l'agente AWS RCS al pool:

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

Requisiti di configurazione del pool per RCS

Tutte le identità di origine in un pool devono avere metadati identici. Quando si aggiunge un'identità di origine a un pool, AWS End User Messaging confronta la configurazione dell'identità con la configurazione esistente del pool. In caso di mancata corrispondenza, l'operazione ha esito negativo e viene visualizzato un messaggio ConflictException che include dettagli sui campi specifici che differiscono.

I campi di configurazione del pool si dividono in due categorie: campi immutabili che vengono impostati al momento della creazione del pool e non possono essere modificati e campi mutabili che è possibile aggiornare dopo la creazione.

Campi di configurazione del pool immutabili e mutabili
Campo Mutabilità Note
Tipo di messaggio Non modificabile Impostato al momento della creazione della piscina. Tutte le identità devono corrispondere.
Codice ISO del paese Non modificabile Impostato al momento della creazione della piscina. Per gli agenti AWS RCS, il valore èZZ. I pool possono contenere numeri di telefono di più paesi.
Protezione da eliminazione Mutable Può essere attivata dopo la creazione. Deve essere coerente tra le identità.
Elenco di opt-out Mutable Può essere modificato dopo la creazione. Deve essere coerente tra le identità.

I seguenti campi di configurazione devono corrispondere in tutte le identità di origine in un pool:

  • Tipo di messaggio: tutte le identità devono essere configurate per lo stesso tipo di messaggio (ad esempio, TRANSACTIONAL o PROMOTIONAL).

  • Codice ISO del paese: impostato al momento della creazione del pool. Per gli agenti AWS RCS, utilizza ZZ come codice ISO del paese. I pool possono contenere numeri di telefono di più paesi.

  • Protezione dall'eliminazione: l'impostazione della protezione dall'eliminazione deve essere coerente tra le identità.

  • Elenco di opt-out: tutte le identità devono essere associate allo stesso elenco di opt-out, altrimenti nessuna di esse deve avere un elenco di opt-out.

Comprendere gli errori ConflictException

Quando si tenta di aggiungere un'identità di origine a un pool e la configurazione non corrisponde, l'CreatePoolAPI AssociateOriginationIdentity o restituisce unConflictException. Il messaggio di eccezione include dettagli su quali campi differiscono tra l'identità e il pool.

Ad esempio, se si tenta di aggiungere un numero di telefono configurato per i messaggi PROMOZIONALI a un pool configurato per i messaggi TRANSAZIONALI, il messaggio di errore indica che il tipo di messaggio non corrisponde.

Per risolvere un: ConflictException

  1. Esamina il messaggio di errore per identificare quali campi sono diversi.

  2. Aggiorna l'identità di origine o la configurazione del pool in modo che i campi corrispondano.

  3. Riprova l'operazione AssociateOriginationIdentity orCreatePool.

Nota

Se non riesci a risolvere la mancata corrispondenza della configurazione, valuta la possibilità di creare un pool separato per l'identità di origine. Ogni pool può avere una propria configurazione ed è possibile utilizzare pool diversi per casi d'uso diversi.

Rimuovere gli agenti AWS RCS dai pool

Puoi rimuovere un agente AWS RCS da un pool utilizzando la console AWS End User Messaging o l'DisassociateOriginationIdentityAPI. La rimozione di un agente AWS RCS da un pool disabilita la consegna RCS per i messaggi inviati tramite quel pool. I messaggi inviati al pool dopo la rimozione dell'agente vengono consegnati solo tramite SMS (utilizzando i numeri di telefono rimanenti nel pool).

Console
Per rimuovere un agente AWS RCS da un pool utilizzando la console
  1. Apri la console di messaggistica per l'utente AWS finale.

  2. Nel riquadro di navigazione, scegli Pool telefonici.

  3. Scegli il pool che contiene l'agente AWS RCS che desideri rimuovere.

  4. Nella sezione Identità di origine, seleziona l'agente AWS RCS.

  5. Scegli Rimuovi, quindi conferma la rimozione.

AWS CLI

Usa l'DisassociateOriginationIdentityAPI per rimuovere un agente AWS RCS da un pool:

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

Dopo aver rimosso l'agente AWS RCS, i messaggi inviati tramite il pool vengono consegnati solo tramite SMS. Per riabilitare la distribuzione RCS, aggiungi nuovamente l'agente AWS RCS al pool utilizzando l'API. AssociateOriginationIdentity