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à.
# Guida introduttiva a RCS
Questa guida illustra come configurare il primo agente RCS in AWS End User Messaging e inviare e ricevere il primo messaggio RCS. Alla fine, avrai un ambiente di test RCS funzionante. Tempo stimato di completamento: 15-30 minuti.
Ecco cosa tratta questa guida:
1. Crea un agente AWS RCS e invia una registrazione di test
1. Aggiungi un dispositivo di test e accetta l'invito del tester
1. Invia il tuo primo messaggio RCS in uscita
1. Prova la messaggistica in entrata (bidirezionale) con parole chiave
Per informazioni sul funzionamento di RCS nella messaggistica con l'utente AWS finale, incluso il modello di identità a due livelli (AWS RCS Agent e RCS for Business IDs), consulta. [Che cos'è RCS?](rcs-overview.md)
## Configurazione e test di RCS
Questa sezione ti guida nella creazione di un agente AWS RCS, nella registrazione di un dispositivo di test, nell'invio del primo messaggio RCS e nella verifica della consegna. Dopo aver completato questi passaggi, puoi procedere al lancio di RCS nei paesi di produzione.
### Prerequisiti
Prima di iniziare, assicurati di disporre di:
+ **Un AWS account con accesso alla messaggistica con l'utente AWS finale**: è necessario un AWS account con le autorizzazioni per utilizzare la messaggistica con l'utente AWS finale. Se non disponi di un account, consulta la [guida alla configurazione AWS dell'account](https://docs.aws.amazon.com/accounts/latest/reference/welcome-first-time-user.html).
+ **Un telefono con RCS abilitato**: è necessario un telefono Android con la messaggistica RCS abilitata nell'app di messaggistica predefinita o un iPhone con iOS 18 o versioni successive. Questo telefono funge da dispositivo di prova per la ricezione di messaggi RCS.
+ **(Facoltativo) AWS CLI configurata**: se desideri eseguire il test utilizzando l'API anziché la console, installa e configura la AWS CLI o utilizza un AWS SDK come boto3 per Python.
### Fase 1: crea il tuo agente AWS RCS e invia una registrazione di test
Il primo passaggio consiste nel creare un agente AWS RCS e inviare una registrazione di test. La registrazione al test crea un RCS for Business ID (agente di test) che puoi utilizzare per inviare messaggi ai dispositivi di test registrati senza l'approvazione dell'operatore.
Per tutti i dettagli sulla gestione di AWS RCS Agent, incluso il ciclo di vita degli agenti e le operazioni delle API, consulta. [Gestione degli agenti RCS](rcs-agents.md)
#### Creazione di un agente AWS RCS (console)
**Per creare un agente AWS RCS e inviare una registrazione di test**
1. Apri la [console AWS End User Messaging](https://console.aws.amazon.com/sms-voice/home).
1. Nel riquadro di navigazione, in **Configurazioni, scegli Agenti** **RCS**.
1. Scegli **Crea agente RCS**. Questo crea un agente AWS RCS e poi ti guida immediatamente nella creazione di una registrazione di test in un unico flusso di lavoro.
1. La schermata successiva mostra un'introduzione a RCS e spiega il processo di configurazione. Controlla le informazioni e scegli **Avanti** per continuare.
1. Nella pagina dei **dettagli dell'agente**, imposta quanto segue:
+ **Nome descrittivo**: un'etichetta valida solo per console per il tuo agente AWS RCS. Si tratta di un nome interno di riferimento (memorizzato come tag) e non è il nome visualizzato sui telefoni dei destinatari. Il nome descrittivo non è disponibile tramite l'API.
+ **Protezione dall'eliminazione**: (Facoltativa) Abilita questa opzione per impedire l'eliminazione accidentale dell'agente.
+ **Tag**: (Facoltativo) Aggiungi tag per organizzare e identificare il tuo agente.
1. Nella sezione **Informazioni sul marchio** della stessa pagina, inserisci quanto segue:
+ **Nome visualizzato**: il nome del marchio che i destinatari vedono accanto ai messaggi RCS.
+ **Descrizione**: una breve descrizione del tuo marchio o della tua attività.
+ **Caso d'uso**: selezionate il caso d'uso principale per la messaggistica RCS (ad esempio, notifiche transazionali, marketing o assistenza clienti).
1. Nella sezione **Brand assets** della stessa pagina, carica quanto segue:
+ **Logo**: 224 × 224 pixel, PNG con trasparenza, meno di 50 KB.
+ **Immagine del banner**: 1440 × 448 pixel, PNG o JPEG, meno di 200 KB.
+ **Colore del marchio**: un codice colore esadecimale (ad esempio,`#1A73E8`) con un rapporto di contrasto minimo di 4. 5:1 su uno sfondo bianco.
**Importante**
Alcune risorse del marchio non possono essere modificate dopo che l'agente ha inviato la registrazione. Prepara le risorse finali del marchio prima di creare l'agente. Se desideri prima sperimentare, puoi creare rapidamente un agente di test utilizzando questo flusso, quindi creare un nuovo agente AWS RCS con risorse di marchio finalizzate in un secondo momento.
1. Nella pagina **Parole chiave di conformità**, configura le parole chiave e i messaggi di risposta automatica.
1. Nella pagina **Revisione**, verifica tutte le impostazioni.
1. Scegli **Convalida e invia** per creare l'agente AWS RCS e inviare la registrazione del test.
**Nota**
Hai creato con successo un agente AWS RCS e inviato una registrazione di test. Il tuo agente di test viene in genere approvato in pochi minuti. Ora abilitiamo la messaggistica di prova sul tuo dispositivo.
#### Creazione di un agente AWS RCS (CLI)
Puoi anche creare un agente AWS RCS utilizzando la AWS CLI. Innanzitutto, crea l'agente, quindi invia una registrazione di test.
Fase 1: Creare l'agente AWS RCS:
```
aws pinpoint-sms-voice-v2 create-rcs-agent \
--deletion-protection-enabled
```
Fase 2: invia una registrazione di test per l'agente. Utilizza l'`CreateRegistration`API con il tipo di registrazione per i test RCS. Puoi utilizzare l'`DescribeRegistrationFieldDefinitions`API per recuperare a livello di codice tutti i campi del modulo di registrazione disponibili prima dell'invio. Fornisci le risorse del marchio, la descrizione e i dettagli di contatto come parte dei campi del modulo di registrazione.
Per i dettagli sull'API di registrazione, consulta[Gestione degli agenti RCS](rcs-agents.md).
### Fase 2: Aggiungere un dispositivo di test
Dopo l'approvazione della registrazione al test, aggiungi il telefono come dispositivo di test in modo da poter ricevere messaggi RCS dal tuo agente addetto al test.
**Nota**
Dopo aver aggiunto un dispositivo di test, l'invito al tester non viene inviato immediatamente. Il sistema ritarda l'attivazione di almeno 120 secondi e l'arrivo dell'invito può richiedere fino a 20 minuti. La console mostra un tempo di attivazione approssimativo. Non è necessario attendere prima di aggiungere il dispositivo: il sistema gestisce il ritardo automaticamente.
------
#### [ Console ]
**Per aggiungere un dispositivo di prova**
1. Nella console AWS End User Messaging, accedi al tuo agente AWS RCS e scegli la scheda **Testing**.
1. Scegli **Aggiungi dispositivo di test.**
1. Inserisci il numero di telefono del dispositivo di test in formato E.164 (ad esempio,`+12065550100`).
1. Scegliere **Aggiungi**.
------
#### [ AWS CLI ]
Usa l'`CreateVerifiedDestinationNumber`API con il `--rcs-agent-id` parametro per registrare un dispositivo di test per il tuo agente AWS RCS:
```
aws pinpoint-sms-voice-v2 create-verified-destination-number \
--destination-phone-number +12065550100 \
--rcs-agent-id rcs-a1b2c3d4
```
------
Dopo aver aggiunto il dispositivo di test, AWS End User Messaging invia un invito al tester al numero di telefono. **L'invito proviene da un agente RCS chiamato **RBM Tester Management e contiene due pulsanti per accettarlo o rifiutarlo: **Make me** a tester** e Decline.** Il destinatario deve toccare **Fammi un tester per completare la** verifica.
**Nota**
Sui dispositivi iOS (iPhone con iOS 18 o versioni successive), l'invito al tester potrebbe apparire nella cartella **Mittenti sconosciuti** dell'app Messaggi anziché nella casella di posta principale. Se non vedi l'invito, controlla la cartella Mittenti sconosciuti.
Per maggiori dettagli sulla gestione dei dispositivi di test, incluso l'approccio API e la risoluzione dei problemi, consulta[Test dei messaggi RCS](rcs-testing.md).
### Fase 3: Inviare il primo messaggio RCS
Dopo che il dispositivo di test ha accettato l'invito del tester, puoi inviare il tuo primo messaggio RCS. È possibile utilizzare la console di messaggistica per l'utente AWS finale o l'API.
------
#### [ Console ]
**Per inviare un messaggio di prova utilizzando la console**
1. Nella console AWS End User Messaging, accedi al tuo agente AWS RCS e scegli la scheda **Testing**.
1. Scegli Messaggi **di test in uscita**. La console mostra un'anteprima di come verrà visualizzato il messaggio sul dispositivo del destinatario, insieme al corpo della richiesta JSON e al comando CLI.
1. Scegli un dispositivo di test verificato dall'elenco.
1. Inserisci il testo del messaggio.
1. Scegli **Invia messaggio di prova**.
**Nota**
Facoltativamente, puoi impostare un set di configurazione per gli eventi dei messaggi. I set di configurazione consentono di utilizzare ricevute di consegna granulari (DLRs) e altri eventi relativi ai messaggi nella destinazione dell'evento di propria scelta. Questo è facoltativo per i test ma consigliato per l'uso in produzione. Per informazioni dettagliate, vedi [CloudWatch Metriche e monitoraggio RCS](rcs-monitoring.md).
------
#### [ AWS CLI ]
Utilizzate il `send-text-message` comando per inviare un messaggio di prova. Specificare l'ARN dell'agente AWS RCS come identità di origine:
```
aws pinpoint-sms-voice-v2 send-text-message \
--destination-phone-number +12065550100 \
--origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \
--message-body "Hello from RCS! This is my first test message."
```
Il `send-text-message` comando è lo stesso che usi per gli SMS. Quando si specifica un ARN dell'agente AWS RCS come identità di origine AWS , End User Messaging invia il messaggio tramite RCS.
------
### Fase 4: Verifica la messaggistica in entrata (bidirezionale)
Puoi testare la messaggistica RCS in entrata configurando una parola chiave con una risposta automatica e quindi inviando un messaggio dal tuo dispositivo di test che corrisponda a quella parola chiave.
**Per testare la messaggistica in entrata con parole chiave di risposta automatica**
1. Nella console AWS End User Messaging, accedi al tuo agente AWS RCS e configura una parola chiave. Ad esempio, imposta la parola chiave `RCSINBOUNDTESTING` con un messaggio di risposta automatica come «Test in entrata riuscito\$1 Il tuo messaggio è stato ricevuto».
1. Nella scheda **Test**, scegli **Inbound deep link**.
1. Nel campo **Corpo del messaggio predefinito**, inserisci la parola chiave che hai configurato (ad esempio,`RCSINBOUNDTESTING`).
1. Scegli **Genera link**. La console genera un URL di collegamento diretto in entrata utilizzando lo schema URI standard `sms:` GSMA. Questo collegamento diretto è incorporato nel codice QR visualizzato sullo schermo.
1. Scansiona il codice QR con il tuo telefono tester verificato. Si apre l'app di messaggistica nativa con un messaggio precompilato indirizzato al tuo agente AWS RCS.
1. Invia il messaggio dal tuo dispositivo di test.
1. Verifica di ricevere il messaggio di risposta automatica sul dispositivo di test.
Il test delle parole chiave a risposta automatica non richiede la configurazione di una destinazione dell'evento o di un argomento Amazon SNS. La risposta automatica è gestita interamente da AWS End User Messaging in base alla configurazione delle parole chiave sul tuo agente AWS RCS.
Per ricevere ed elaborare messaggi in entrata arbitrari (non solo corrispondenze di parole chiave), devi configurare un argomento Amazon SNS per la messaggistica bidirezionale. Per informazioni dettagliate, vedi [Ricezione di messaggi RCS in entrata](rcs-inbound.md).
### Cosa hai realizzato
Completando i passaggi di questa guida, avrai:
+ Hai creato un agente AWS RCS con gli asset del tuo marchio e hai inviato una registrazione di test
+ Hai registrato un dispositivo di test e accettato l'invito del tester
+ Hai inviato il tuo primo messaggio RCS e hai verificato la consegna
+ Messaggistica in entrata testata utilizzando parole chiave di risposta automatica
Il tuo ambiente di test è ora pronto. Ecco alcuni modi per integrare la messaggistica RCS nella tua applicazione o ottimizzare il funzionamento della messaggistica RCS:
+ **Ricevi ed elabora messaggi in entrata**: configura un argomento Amazon SNS per ricevere messaggi RCS in entrata ed elaborarli con le funzioni Lambda. Per informazioni, consulta [Ricezione di messaggi RCS in entrata](rcs-inbound.md).
+ **Tieni traccia degli eventi di consegna**: configura i set di configurazione per utilizzare le ricevute di consegna granulari (DLRs) e altri eventi relativi ai messaggi nella destinazione dell'evento che preferisci. Per informazioni, consulta [CloudWatch Metriche e monitoraggio RCS](rcs-monitoring.md).
+ **Abilita il fallback degli SMS**: crea un pool di telefoni con il tuo agente AWS RCS e i numeri di telefono SMS per tornare automaticamente agli SMS quando la consegna RCS non è possibile. Per informazioni, consulta [Fallback da RCS a SMS utilizzando pool di telefoni](rcs-sms-fallback.md).
+ **Lancio nei paesi di produzione**: invia le registrazioni di lancio nazionali per inviare messaggi RCS a tutti i destinatari negli Stati Uniti d'America e in Canada. Per informazioni, consulta [Lancio di RCS nei paesi](rcs-country-launch.md).
## Richiesta dell'agente AI per la configurazione RCS
Se utilizzi un assistente di codifica AI generativo o un agente AI, puoi utilizzare il seguente prompt per ricevere assistenza nella creazione di un agente AWS RCS, nell'invio di una registrazione di test e nell'invio del primo messaggio di test utilizzando la CLI. AWS
**Nota**
Copia il seguente prompt e incollalo nel tuo agente AI o assistente di codifica:
```
## RCS Setup Assistant Prompt
Help me set up RCS messaging in AWS End User Messaging using the AWS CLI.
The service is `pinpoint-sms-voice-v2`. Walk me through each step with exact
CLI commands. Ask me for all required details before generating any commands.
**Important rules for generating commands:**
- All commands use the `pinpoint-sms-voice-v2` service.
- Use `create-rcs-agent` exactly as spelled — NOT `create-r-c-s-agent`.
- Use the term "testing" — NOT "sandbox".
- There is NO `describe-messages` API. Do not generate it.
- `create-rcs-agent` does NOT accept brand asset parameters (no display name,
no logo, no banner, no color). Brand assets are registration fields only.
- `create-verified-destination-number` uses `--rcs-agent-id`, NOT
`--origination-identity`.
### Step 1: Create an RCS Agent
Use `create-rcs-agent`. This creates the agent resource only.
Optional parameters: `--deletion-protection-enabled`, `--opt-out-list-name`,
`--tags`.
The response returns `RcsAgentId` and `RcsAgentArn` — save both.
### Step 2: Create and submit a testing registration
This configures brand assets and submits for approval. It requires multiple
API calls in sequence:
a. `create-registration --registration-type TEST_RCS_LAUNCH_REGISTRATION`
→ returns `RegistrationId`. Save it.
b. `create-registration-association --registration-id --resource-id `
→ links the registration to the agent.
c. Upload images as attachments (two calls):
`create-registration-attachment --attachment-body fileb://`
`create-registration-attachment --attachment-body fileb://`
→ each returns `RegistrationAttachmentId`. Save both.
d. Set ALL required registration fields using `put-registration-field-value`
with `--registration-id`, `--field-path`, and the appropriate value flag
(`--text-value`, `--select-choices`, or `--registration-attachment-id`).
Required fields (ALL must be set or registration will be DENIED):
- `agentDetails.brandName` (text, 2-65 chars)
- `agentDetails.serviceName` (text, 1-100 chars)
- `agentDetails.senderDisplayName` (text, 1-40 chars)
- `agentDetails.useCase` (select: OTP, TRANSACTIONAL, PROMOTIONAL, MULTI_USE)
- `agentDetails.agentDescription` (text, 1-100 chars)
- `agentDetails.logoImage` (attachment ID from step c, 224x224 PNG)
- `agentDetails.bannerImage` (attachment ID from step c, 1440x448 PNG/JPEG)
- `agentDetails.accentColor` (text, hex code e.g. #0066CC)
- `agentDetails.privacyPolicyUrl` (text, valid URL)
- `agentDetails.termsAndConditionsUrl` (text, valid URL)
- `agentDetails.averageMonthlyRcsFrequency` (select: 10, 100, 1000+)
- `agentDetails.monthlyRcsVolume` (text, 1-100000)
- At least ONE contact method WITH its label:
agentDetails.contactWebsite + agentDetails.contactWebsiteLabel, OR
agentDetails.contactPhoneNumber + agentDetails.contactPhoneLabel, OR
agentDetails.contactEmailAddress + agentDetails.contactEmailLabel
e. Verify all fields: `describe-registration-field-values --registration-id `
Any field showing `DeniedReason: MISSING_REQUIRED_FIELD` must be set.
f. Submit: `submit-registration-version --registration-id `
g. Poll status: `describe-registrations --registration-ids `
Wait for `RegistrationStatus: COMPLETE`.
**Error recovery:** If registration is DENIED, you must:
1. `create-registration-version --registration-id ` (creates new draft)
2. Re-populate ALL fields from scratch (new versions do NOT inherit values)
3. Fix the issue noted in `DeniedReasons`
4. Re-submit
### Step 3: Add a test device
**Prerequisite:** Step 2 must be COMPLETE and the agent's `TestingAgent.Status`
must be `ACTIVE` (check with `describe-rcs-agents`). Then wait at least 120
seconds after the agent becomes ACTIVE.
Use `create-verified-destination-number --destination-phone-number
--rcs-agent-id `.
The device status will be `PENDING`. The user must accept the RCS tester
invitation on their physical device. Check status with
`describe-verified-destination-numbers` — wait for `VERIFIED`.
### Step 4: Send a test RCS message
**Prerequisite:** Step 3 device must be `VERIFIED`.
Use `send-text-message --destination-phone-number
--origination-identity --message-body ""
--message-type TRANSACTIONAL`.
Returns `MessageId`.
### Step 5: Verify delivery
For testing: check the test device — the message appears from the branded
RCS agent.
For production monitoring: set up event destinations BEFORE sending messages
using `create-event-destination` (SNS, CloudWatch Logs, or Firehose). Event
destinations do not retroactively capture events for already-sent messages.
CloudWatch metrics in the `AWS/SMSVoice` namespace provide aggregate stats.
---
**Before generating commands, ask me for:**
- Brand name, service name, and sender display name
- Agent description (what the agent does, what messages users receive)
- Use case type: OTP, TRANSACTIONAL, PROMOTIONAL, or MULTI_USE
- Logo file path (224x224 PNG) and banner file path (1440x448 PNG/JPEG)
- Brand accent color hex code (e.g. #0066CC)
- Privacy policy URL and terms & conditions URL
- One contact method with label: website URL, phone number, or email
- Estimated monthly RCS volume and per-user message frequency
- Test device phone number in E.164 format (e.g. +12065550100)
```