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à.
# Invio di messaggi di testo RCS
A `TextMessage` è il tipo di contenuto più semplice che puoi inviare con l'`SendRcsMessage`API. È costituito da un testo semplice (fino a 3.072 caratteri) con chip di suggerimento opzionali che appaiono come pulsanti interattivi sotto il messaggio.
## In che modo i messaggi di testo RCS differiscono dagli SMS
I messaggi di testo inviati tramite (SMS) `SendRcsMessage` differiscono da quelli inviati tramite `SendTextMessage` (SMS) in due modi:
+ **Chip di suggerimento**: puoi allegare fino a 11 chip di suggerimento a un messaggio di testo RCS. Con questi chip, i destinatari possono rispondere, aprire un URL, chiamare un numero di telefono, condividere una posizione o creare un evento sul calendario in un unico passaggio. Gli SMS non supportano i suggerimenti.
+ **Single-message consegna**: un messaggio di testo RCS arriva come messaggio singolo indipendentemente dalla lunghezza (fino a 3.072 caratteri). I corrieri suddividono i messaggi SMS più lunghi di 160 caratteri in più segmenti, che potrebbero arrivare fuori ordine o con ritardi tra i segmenti.
Per informazioni dettagliate su tutti i tipi di suggerimenti disponibili e sui relativi parametri, consulta. [Configurazione dei suggerimenti RCS](rcs-suggestions.md)
## RcsMessageContent struttura per i messaggi di testo
Quando si chiama`SendRcsMessage`, si passa il payload del messaggio come `RcsMessageContent` parametro. Per un messaggio di testo, impostate il `Content` campo su un `TextMessage` oggetto contenente una `Body` stringa. Per includere chip di suggerimento, aggiungi un `Suggestions` array come fratello di primo livello di. `Content`
Il seguente frammento di codice JSON mostra la struttura di un messaggio di `RcsMessageContent` testo con suggerimenti:
```
{
"Content": {
"TextMessage": {
"Body": "What would you like to do?"
}
},
"Suggestions": [
{
"Reply": {
"Text": "Check order status",
"PostbackData": "action=check_order"
}
},
{
"OpenUrl": {
"Text": "View details",
"PostbackData": "action=view",
"Url": "https://example.com/orders/1234"
}
}
]
}
```
In questo esempio:
+ `Content.TextMessage.Body`contiene il testo del messaggio (obbligatorio, da 1 a 3.072 caratteri).
+ `Suggestions`è un array di primo livello (opzionale, fino a 11 elementi). Ogni suggerimento richiede un `Text` campo (fino a 25 caratteri) e un `PostbackData` campo (fino a 2.048 caratteri).
L'`Suggestions`array supporta sei tipi di azioni:`Reply`,,`OpenUrl`, `DialPhone``ShowLocation`, `RequestLocation` e. `CreateCalendarEvent` È possibile combinare diversi tipi di suggerimenti in un unico messaggio. Per i dettagli completi su ciascun tipo, vedere[Configurazione dei suggerimenti RCS](rcs-suggestions.md).
## Invio di un messaggio di testo
Per inviare un messaggio di testo RCS, chiamate `SendRcsMessage` con i seguenti parametri obbligatori:
+ `DestinationPhoneNumber`: il numero di telefono del destinatario in E.164 formato.
+ `OriginationIdentity`: l'ID del pool o l'agente AWS RCS che invia il messaggio.
+ `RcsMessageContent`: La stringa JSON `Content` contenente un `TextMessage` oggetto.
Puoi chiamare l'API utilizzando l'AWS CLI (`aws pinpoint-sms-voice-v2 send-rcs-message`) o un SDK AWS come il client boto3. `pinpoint-sms-voice-v2`
## Fallback tramite SMS o MMS
Se il dispositivo del destinatario non supporta RCS o è temporaneamente irraggiungibile sul canale RCS, puoi configurare il messaggio in modo che ritorni a SMS o MMS. Per abilitare il fallback, includi un oggetto nella richiesta. `FallbackConfiguration` `SendRcsMessage` `FallbackConfiguration`specifica il canale di fallback (`SMS`o`MMS`), il corpo del messaggio di fallback e l'identità di origine (un numero di telefono o un ID mittente) da utilizzare per il messaggio di fallback.
Il fallback è facoltativo. Se si omette `FallbackConfiguration` e il destinatario non può ricevere RCS, il messaggio non viene recapitato.
Per ulteriori informazioni sulla configurazione del comportamento di fallback, consulta. [Invio di messaggi RCS complessi](rcs-rich-messaging.md)
## Limiti per i messaggi di testo
| Risorsa | Limite | Note |
| --- | --- | --- |
| Corpo del messaggio (Body) | 3.072 caratteri () UTF-8 | Obbligatorio. Deve contenere almeno 1 carattere. |
| Suggerimenti per messaggio | 11 | Totale combinato di risposte e azioni. |
| Testo di visualizzazione del suggerimento () Text | 25 caratteri | Si applica a tutti i tipi di suggerimenti. |
| Dati di postback () PostbackData | 2,048 caratteri | Obbligatorio per tutti i tipi di suggerimenti. |
## Quando usare i messaggi di testo
Utilizzare `TextMessage` per:
+ Notifiche come conferme d'ordine, aggiornamenti sulla spedizione e promemoria degli appuntamenti.
+ One-time password e codici di verifica.
+ Prompt conversazionali che offrono opzioni di risposta come chip di suggerimento, che consentono interazioni guidate senza immissione di testo libero.
+ Brevi aggiornamenti di stato in cui il contenuto non richiede immagini o layout strutturati.
Per i messaggi che richiedono immagini, video o layout strutturati con titoli e descrizioni, utilizza invece rich card o caroselli. Per informazioni, consulta [Invio di messaggi RCS complessi](rcs-rich-messaging.md).