View a markdown version of this page

Gestione degli agenti RCS - AWS SMS di messaggistica per l'utente finale
Comprendere l'agente AWS RCSComprensione del modello di identità a due livelliCreazione di un agente AWS RCSAggiornamento di un agente AWS RCSVisualizzazione degli agenti AWS RCSEsamina il tuo agente di testVisualizzazione dello stato di lancio del PaeseEliminazione di un agente AWS RCS

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 RCS

Un agente AWS RCS è la risorsa di primo livello nella messaggistica per utenti AWS finali che rappresenta il tuo marchio per la messaggistica RCS. Funge da risorsa unificata che unisce l'agente di test e gli agenti di lancio nazionali (RCS for Business). IDs Le parole chiave e la configurazione della messaggistica bidirezionale sono definite nell'agente AWS RCS. Gli asset del marchio sono definiti in ogni registrazione (agente di test o agente di lancio nazionale). Per una panoramica di come l'agente AWS RCS si relaziona con RCS for Business IDs, consulta. Che cos'è RCS?

L'agente AWS RCS segue questo ciclo di vita:

  1. Crea l'agente AWS RCS.

  2. Aggiungi un agente di test (incluso nel flusso di creazione della console; opzionale tramite CLI).

  3. Metti alla prova la tua messaggistica RCS con dispositivi di test registrati. Per i test non è richiesta l'approvazione del corriere.

  4. Invia una registrazione al lancio per ogni paese in cui desideri inviare messaggi RCS di produzione.

  5. Approvato parzialmente: almeno un corriere ha approvato il tuo agente. Puoi iniziare a inviare a destinatari con corrieri approvati.

  6. Completamente approvato: tutti i corrieri del paese hanno approvato il tuo agente. Piena copertura in quel paese.

Un agente AWS RCS esegue il mapping su un agente di test (un RCS for Business ID) più agenti di lancio su più paesi (un RCS for Business ID per paese). Quando crei un agente AWS RCS nella console, il flusso di lavoro ti guida immediatamente alla creazione di un agente di test. La configurazione del marchio dell'agente di test viene quindi utilizzata per precompilare i moduli di registrazione per i lanci nazionali, riducendo l'immissione duplicata dei dati.

Comprendere l'agente AWS RCS

L'agente RCS di AWS è diverso da RCS for Business IDs che gestisce. La tabella seguente riassume le differenze:

AWS RCS Agent a confronto con RCS for Business ID
Attributo Agente AWS RCS RCS per l'ID aziendale
Gestito da Tu, tramite la console di messaggistica per l'utente AWS finale o l'API AWS Messaggistica con l'utente finale, durante il processo di registrazione
Scope Uno per marchio o per caso d'uso Uno per paese di lancio, più un agente di test
Configurazione Nome descrittivo, protezione dall'eliminazione, elenco di esclusione, tag, parole chiave, destinazione di messaggistica bidirezionale Risorse del marchio e altre impostazioni definite durante la registrazione
Identificatore rcs-a1b2c3d4 formato Gestito internamente dal fornitore dell'infrastruttura RCS

ID agente e ARN

Ogni agente AWS RCS ha un identificatore univoco nel formato rcs-a1b2c3d4 (il prefisso rcs- seguito da una stringa esadecimale). Utilizzi questo ID quando chiami operazioni API come e. UpdateRcsAgent DeleteRcsAgent

Ogni agente AWS RCS dispone inoltre di un ARN di AWS risorse nel seguente formato:

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

Puoi utilizzare l'ARN quando specifichi l'agente AWS RCS come identità di origine nell'SendTextMessageAPI o quando aggiungi l'agente a un pool di telefoni.

Stati del ciclo di vita

Un agente AWS RCS passa attraverso i seguenti stati del ciclo di vita:

CREATO

La risorsa AWS RCS Agent è stata creata in AWS End User Messaging, ma non è stata ancora inviata alcuna registrazione. Puoi aggiornare gli asset e la configurazione del marchio in questo stato.

PENDING

Una registrazione è stata inviata ed è in attesa di elaborazione. L'agente non è ancora disponibile per l'invio di messaggi.

TEST

La registrazione del test è stata approvata. L'agente dispone di un agente di test (RCS for Business ID) e può inviare messaggi ai dispositivi di test registrati. Non sono state completate le registrazioni per il lancio nei vari paesi.

PARZIALE

La registrazione del lancio in almeno un paese è stata completata, ma non tutti i lanci inviati nei paesi sono attivi. L'agente può inviare messaggi nei paesi in cui è stato approvato, ma solo ai destinatari dello o dei corrieri specifici che hanno approvato l'agente. Il CountryStatus programma per un paese passa a PARTIAL non appena almeno un operatore in quel paese è attivo.

ACTIVE

Tutte le registrazioni di lancio inviate per paese sono complete e attive. L'agente è pienamente operativo in tutti i paesi registrati. Tieni presente che un agente ATTIVO può tornare allo stato PARZIALE quando viene inviata la registrazione per il lancio di un nuovo paese, poiché il nuovo paese non è ancora stato approvato.

ELIMINATO

L'agente AWS RCS è stato eliminato. Tutti gli RCS for Business associati IDs (agenti di test e di lancio nazionali) sono disattivati. Questa operazione non può essere annullata.

Comprensione del modello di identità a due livelli

RCS in AWS End User Messaging utilizza un modello di identità a due livelli: AWS RCS Agent e uno o più RCS for Business. IDs

Agente AWS RCS

L'agente AWS RCS è la risorsa di primo livello che crei e gestisci in AWS End User Messaging. Funge da risorsa unificata che unisce l'agente di test e gli agenti di lancio nazionali. Le parole chiave e la configurazione della messaggistica bidirezionale sono definite nell'agente AWS RCS. Gli asset del marchio sono definiti in ogni registrazione. Ogni agente AWS RCS ha un identificatore univoco nel formato rcs-a1b2c3d4 e un AWS ARN di risorsa. Pensa all'agente AWS RCS come all'identità unificata del tuo marchio in tutti i paesi in cui lanci RCS.

RCS for Business ID

Un RCS for Business ID è l'identità dell'agente per paese creata con il provider dell'infrastruttura RCS durante il processo di registrazione. Ogni lancio in un paese crea un ID RCS for Business separato sotto il tuo agente AWS RCS. Non gestisci direttamente RCS for Business. IDs AWS End User Messaging gestisce la creazione e il ciclo di vita come parte del processo di registrazione.

Un agente AWS RCS può avere il seguente RCS for Business: IDs

  • Un agente di test: un ID RCS for Business creato durante la fase di registrazione del test. L'agente di test funziona con dispositivi di test registrati e consente di convalidare l'integrazione RCS prima del lancio in produzione. I messaggi di test vengono addebitati secondo le tariffe standard.

  • Agenti di lancio in più paesi: ogni paese in cui viene avviato RCS crea un RCS for Business ID separato. Ad esempio, se effettui il lancio sia negli Stati Uniti che in Canada, il tuo agente AWS RCS dispone di due agenti di lancio nazionali (uno RCS for Business ID degli Stati Uniti e un RCS for Business ID del Canada) oltre all'agente di test.

Il diagramma seguente mostra la relazione tra queste identità:


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)

Le parole chiave e le destinazioni di messaggistica bidirezionale sono configurate sull'agente AWS RCS e si applicano a tutti gli RCS for Business associati. IDs Le risorse del marchio sono specifiche per ogni registrazione (agente di test o agente di lancio nazionale). L'agente AWS RCS contiene anche impostazioni a livello di account come il nome descrittivo, la protezione da eliminazione e l'elenco di opt-out.

Creazione di un agente AWS RCS

Puoi creare un agente AWS RCS utilizzando la console di messaggistica dell'utente AWS finale o l'CreateRcsAgentAPI. Quando crei un agente, fornisci un nome descrittivo nella console (un'etichetta riservata alla console memorizzata come tag, non visibile tramite l'API o visualizzata sui telefoni dei destinatari) e configuri impostazioni opzionali come la protezione dall'eliminazione e l'associazione degli elenchi di opt-out. Le risorse del marchio sono definite nella registrazione, non nell'agente AWS RCS stesso.

Requisiti degli asset del marchio

Le risorse del tuo marchio vengono mostrate ai destinatari insieme ai tuoi messaggi RCS. Le risorse del marchio vengono inviate come parte della registrazione al test, che la console presenta come continuazione del flusso di lavoro di creazione degli agenti. Le seguenti risorse sono necessarie per la creazione di un agente AWS RCS:

Logo

Un'immagine quadrata che rappresenta il tuo marchio. Il logo appare nell'app di messaggistica accanto ai tuoi messaggi.

  • Dimensioni: 224 × 224 pixel

  • Formato: PNG con trasparenza

  • Dimensione di file massima: 50 KB

Immagine del banner

Un'immagine ampia che appare nella parte superiore del profilo del tuo agente nell'app di messaggistica. L'immagine del banner viene visualizzata solo sui dispositivi Android.

  • Dimensioni: 1440 × 448 pixel

  • Formato: PNG o JPEG

  • Dimensione massima del file: 200 KB

Colore del marchio

Un codice colore esadecimale (ad esempio,#1A73E8) utilizzato come colore di accento nell'app di messaggistica. Il colore deve avere un rapporto di contrasto minimo di 4, 5:1 su uno sfondo bianco per soddisfare i requisiti di accessibilità. Se il rapporto di contrasto non è impostato correttamente, il tuo agente potrebbe non essere approvato.

Importante

Le risorse del marchio presentano limitazioni sulle modifiche dopo la creazione dell'agente. Alcune risorse del marchio non possono essere modificate una volta che l'agente è stato inviato per la registrazione. Prepara gli asset finali del tuo marchio prima di creare il tuo AWS RCS Agent.

Console

La console AWS End User Messaging presenta la creazione di AWS RCS Agent e la registrazione dei test come un unico flusso di lavoro guidato. Per le istruzioni step-by-step sulla console, consultaFase 1: crea il tuo agente AWS RCS e invia una registrazione di test.

AWS CLI

Usa il create-rcs-agent comando per creare un agente AWS RCS. Le risorse del marchio (nome visualizzato, descrizione, logo, banner e colore del marchio) non sono parametri di questo comando. Vengono inviati come campi di registrazione quando si crea una registrazione di prova.

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

Sono disponibili i seguenti parametri opzionali:

  • --deletion-protection-enabled— Impedisce l'eliminazione dell'agente fino a quando la protezione dall'eliminazione non viene disabilitata.

  • --opt-out-list-name— Associa un elenco di opt-out esistente all'agente.

  • --tags— Coppie chiave-valore per organizzare e identificare il tuo agente AWS RCS.

Aggiornamento di un agente AWS RCS

Utilizza l'UpdateRcsAgentAPI per modificare le impostazioni di un agente AWS RCS esistente. Puoi aggiornare le seguenti impostazioni:

  • Protezione dall'eliminazione: abilita o disabilita la protezione dall'eliminazione per l'agente.

  • Elenco di opt-out: associa o annulla l'associazione di un elenco di opt-out all'agente.

  • Destinazione di messaggistica bidirezionale: configura l'argomento Amazon SNS e il ruolo IAM in cui vengono recapitati i messaggi in entrata. La messaggistica bidirezionale è sempre abilitata per RCS. Ai clienti vengono addebitati i costi per tutti i messaggi RCS in entrata secondo le tariffe standard. Questa impostazione controlla dove vengono recapitati i messaggi in entrata, non se vengono ricevuti.

Nota

Le modifiche alle impostazioni di AWS RCS Agent tramite l'API sono immediatamente disponibili. Tuttavia, gli aggiornamenti agli asset del marchio (campi di registrazione come logo, banner e nome visualizzato) vengono esaminati dal fornitore dell'infrastruttura RCS e potrebbero richiedere del tempo prima che vengano visualizzati sui dispositivi dei destinatari. Per verificare che le modifiche all'API siano state applicate, utilizzate l'DescribeRcsAgentsAPI per confermare la configurazione corrente dell'agente in AWS End User Messaging.

Visualizzazione degli agenti AWS RCS

Puoi visualizzare i tuoi agenti AWS RCS utilizzando la console di messaggistica dell'utente AWS finale o l'DescribeRcsAgentsAPI.

Console

Per visualizzare gli agenti AWS RCS nella console, accedi alla pagina Agenti RCS in Configurazioni nel riquadro di navigazione. La pagina di elenco mostra tutti gli agenti AWS RCS presenti nel tuo account, inclusi lo stato attuale del ciclo di vita, l'ID agente e il nome visualizzato.

Scegli un agente per visualizzarne i dettagli, tra cui gli asset del marchio, le impostazioni di configurazione e le registrazioni associate.

AWS CLI

Usa il describe-rcs-agents comando per elencare tutti gli agenti AWS RCS presenti nel tuo account:

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

Per recuperare i dettagli di un agente specifico, usa il --rcs-agent-ids parametro:

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

Esamina il tuo agente di test

Prima di inviare una registrazione per il lancio nel Paese, controllate la configurazione del vostro agente di test per assicurarvi che gli asset del marchio, le parole chiave e le impostazioni di messaggistica siano corrette. L'agente di test funge da modello per le registrazioni dei lanci nazionali, quindi eventuali problemi devono essere risolti prima di procedere.

Per esaminare il tuo agente di test, accedi al tuo agente AWS RCS nella console AWS End User Messaging e scegli la scheda Registrazioni. La registrazione di prova mostra la configurazione attuale del marchio, inclusi il logo, l'immagine del banner, il colore del marchio e il nome visualizzato così come appaiono sui dispositivi dei destinatari.

Puoi anche utilizzare l'DescribeRegistrationFieldValuesAPI per recuperare i valori dei campi correnti per la registrazione dei test in modo programmatico.

Visualizzazione dello stato di lancio del Paese

Dopo aver inviato una registrazione di lancio nazionale per il tuo agente AWS RCS, puoi monitorare lo stato di approvazione di ciascun operatore in quel paese.

Console

Per visualizzare lo stato del lancio nel Paese nella console, vai alla pagina dei dettagli del tuo agente AWS RCS e scegli la scheda Stato di lancio per Paese. Questa scheda mostra lo stato di approvazione per ogni operatore in ogni paese in cui hai inviato una registrazione al lancio.

AWS CLI

Usa il describe-rcs-agent-country-launch-status comando per recuperare lo stato di lancio per operatore:

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

La risposta include lo stato di approvazione per ogni corriere in ogni paese in cui hai inviato una registrazione al lancio.

Ogni operatore esamina e approva il proprio agente in modo indipendente. Il tuo agente AWS RCS può inviare messaggi in un paese non appena almeno un operatore in quel paese ha approvato l'agente. Non è necessario attendere l'approvazione di tutti i corrieri prima di iniziare a inviare messaggi RCS. Man mano che altri corrieri approvano il tuo agente, la tua presenza in quel paese aumenta.

Nota

Puoi richiedere lanci in altri Paesi dalla schermata di stato del lancio del Paese. Ogni lancio in un nuovo Paese crea una registrazione separata e viene sottoposto a un processo di approvazione specifico del corriere.

Eliminazione di un agente AWS RCS

Usa l'DeleteRcsAgentAPI per eliminare definitivamente un agente AWS RCS. Quando elimini un agente, tutti gli RCS for Business associati IDs (inclusi l'agente di test e gli agenti di lancio per tutti i paesi) vengono disattivati.

avvertimento

L'eliminazione di un agente AWS RCS è permanente e non può essere annullata. Tutte le registrazioni, i lanci nei paesi e le configurazioni di test associate all'agente vengono perse.

Prima di poter eliminare un agente AWS RCS, devi prima eliminare tutte le registrazioni associate (sia le registrazioni di test che quelle di lancio per paese), quindi disabilitare la protezione dall'eliminazione. Se la protezione da eliminazione è abilitata, l'DeleteRcsAgentAPI restituisce un errore. Per disabilitare la protezione da eliminazione, utilizza l'UpdateRcsAgentAPI con la protezione da eliminazione impostata sufalse.

Per eliminare un agente AWS RCS

  1. Se la protezione da eliminazione è abilitata, disabilitala chiamando l'UpdateRcsAgentAPI con la protezione da eliminazione impostata su. false

  2. Chiama l'DeleteRcsAgentAPI con l'ID agente o l'ARN dell'agente AWS RCS che desideri eliminare.

  3. Verifica che l'agente sia stato eliminato chiamando l'DescribeRcsAgentsAPI. L'agente non dovrebbe più apparire nei risultati o il suo stato dovrebbe essere ELIMINATO.