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à.
# Configurazione dei suggerimenti RCS
I suggerimenti sono chip interattivi che appaiono sotto o all'interno di un messaggio RCS. Guidano i destinatari durante una conversazione presentando risposte e azioni predefinite, come aprire un URL, chiamare un numero di telefono o condividere una posizione, senza richiedere al destinatario di digitare. I suggerimenti sono il modo in cui crei esperienze interattive e conversazionali con. `SendRcsMessage`
Puoi aggiungere suggerimenti a qualsiasi tipo di contenuto (testo, file, rich card e carosello) a due livelli:
+ **Message-level**. Fornito nell'`Suggestions`elenco di primo livello di`RcsMessageContent`, a fianco`Content`. Puoi includere fino a 11 suggerimenti per messaggio.
+ **Card-level**. Fornito nell'`Suggestions`elenco di una singola rich card o carousel card. Puoi includere fino a 4 suggerimenti per carta.
AWSLa messaggistica per l'utente finale supporta sei tipi di suggerimenti: `Reply``OpenUrl`,`DialPhone`,, `ShowLocation``RequestLocation`, e`CreateCalendarEvent`. Ogni suggerimento richiede un'`Text`etichetta (fino a 25 caratteri) e `PostbackData` (fino a 2.048 caratteri).
**Topics**
+ [Come funzionano i dati di postback](#rcs-suggestions-postback)
+ [Visualizzazione dei suggerimenti](#rcs-suggestions-display)
+ [Reply](#rcs-suggestions-reply)
+ [OpenUrl](#rcs-suggestions-openurl)
+ [DialPhone](#rcs-suggestions-dialphone)
+ [ShowLocation](#rcs-suggestions-showlocation)
+ [RequestLocation](#rcs-suggestions-requestlocation)
+ [CreateCalendarEvent](#rcs-suggestions-calendar)
+ [Ricezione di suggerimenti, tocchi](#rcs-suggestions-receiving)
+ [Limiti dei suggerimenti](#rcs-suggestions-limits)
+ [Best practice](#rcs-suggestions-best-practices)
+ [Argomenti correlati](#rcs-suggestions-related)
## Come funzionano i dati di postback
Ogni suggerimento include una `PostbackData` stringa di massimo 2.048 caratteri che AWS End User Messaging invia all'applicazione quando il destinatario sceglie il suggerimento. I dati di postback non sono visibili al destinatario. Utilizzateli per codificare le informazioni di routing, gli identificatori di intento, il contesto della sessione o qualsiasi metadato necessario al backend per elaborare la selezione.
Quando un destinatario sceglie un suggerimento, AWS End User Messaging invia un messaggio in entrata all'argomento Amazon SNS che configuri per la messaggistica bidirezionale. Indirizza la logica sul testo visualizzato `postbackData` anziché sul testo visualizzato. Per informazioni dettagliate sugli eventi in entrata, consulta[Eventi dei messaggi RCS](rcs-events.md).
## Visualizzazione dei suggerimenti
Suggerimenti transitori (impostazione predefinita)
I suggerimenti transitori vengono visualizzati all'esterno della bolla del messaggio, sotto il messaggio più recente. Scompaiono dopo che il destinatario ne ha scelto uno o ha inviato un messaggio.
Suggerimenti persistenti
I suggerimenti persistenti vengono visualizzati all'interno della bolla del messaggio e rimangono visibili dopo che il destinatario scorre o interagisce con i messaggi successivi. La visualizzazione persistente è determinata dalla posizione del suggerimento all'interno di una rich card. I suggerimenti allegati alle rich card autonome vengono visualizzati come persistenti sui client supportati.
## Reply
Un `Reply` suggerimento invia una risposta testuale predefinita al tuo agente. Il testo visualizzato viene visualizzato come messaggio inviato nella conversazione e `PostbackData` viene recapitato all'applicazione.
```
{ "Reply": { "Text": "Yes, confirm", "PostbackData": "confirm_order_12345" } }
```
| Campo | Richiesto | Vincolo |
| --- | --- | --- |
| Text | Sì | Fino a 25 caratteri |
| PostbackData | Sì | Fino a 2.048 caratteri |
## OpenUrl
Un `OpenUrl` suggerimento apre un URL. Per impostazione predefinita, l'URL si apre nel browser del dispositivo. Per aprire l'URL in una visualizzazione Web che mantiene il destinatario all'interno dell'app di messaggistica, imposta `WEBVIEW` e specifica `Application` a`WebviewViewMode`.
```
{
"OpenUrl": {
"Text": "Complete payment",
"PostbackData": "pay_12345",
"Url": "https://example.com/pay",
"Application": "WEBVIEW",
"WebviewViewMode": "TALL"
}
}
```
| Campo | Richiesto | Vincolo |
| --- | --- | --- |
| Text | Sì | Fino a 25 caratteri |
| PostbackData | Sì | Fino a 2.048 caratteri |
| Url | Sì | Deve iniziare con. https:// Fino a 2.048 caratteri |
| Application | No | WEBVIEWda aprire in una visualizzazione web in-app |
| WebviewViewMode | Condizionale | Richiesto quando Application èWEBVIEW:FULL, o HALF TALL |
**Nota**
È `Url` necessario utilizzare il `https://` protocollo. Un `s3://` URL viene rifiutato. A differenza di un browser standard aperto, una webview mantiene il destinatario all'interno della conversazione, il che è utile per flussi brevi come un pagamento o un modulo.
## DialPhone
Un `DialPhone` suggerimento avvia una telefonata al numero specificato.
```
{ "DialPhone": { "Text": "Call support", "PostbackData": "dial_support", "PhoneNumber": "+18005551234" } }
```
| Campo | Richiesto | Vincolo |
| --- | --- | --- |
| Text | Sì | Fino a 25 caratteri |
| PostbackData | Sì | Fino a 2.048 caratteri |
| PhoneNumber | Sì | E.164 formato, ad esempio \+18005551234 |
## ShowLocation
Un `ShowLocation` suggerimento apre una mappa alle coordinate specificate.
```
{
"ShowLocation": {
"Text": "View on map",
"PostbackData": "show_store_loc",
"Latitude": 47.6062,
"Longitude": -122.3321,
"Label": "Seattle store"
}
}
```
| Campo | Richiesto | Vincolo |
| --- | --- | --- |
| Text | Sì | Fino a 25 caratteri |
| PostbackData | Sì | Fino a 2.048 caratteri |
| Latitude | Sì | Da -90,0 a 90,0 |
| Longitude | Sì | da -180,0 a 180,0 |
| Label | No | Visualizza l'etichetta per il segnaposto della mappa |
## RequestLocation
Un `RequestLocation` suggerimento richiede al destinatario di condividere la sua posizione attuale. Le coordinate condivise arrivano come evento di ubicazione in entrata separato.
```
{ "RequestLocation": { "Text": "Share location", "PostbackData": "request_user_location" } }
```
| Campo | Richiesto | Vincolo |
| --- | --- | --- |
| Text | Sì | Fino a 25 caratteri |
| PostbackData | Sì | Fino a 2.048 caratteri |
## CreateCalendarEvent
Un `CreateCalendarEvent` suggerimento crea un evento del calendario sul dispositivo del destinatario con i dettagli specificati.
```
{
"CreateCalendarEvent": {
"Text": "Add to calendar",
"PostbackData": "calendar_appt_5678",
"Title": "Service appointment",
"StartTime": "2026-05-28T14:00:00Z",
"EndTime": "2026-05-28T15:00:00Z",
"Description": "Downtown location. Arrive 10 minutes early."
}
}
```
| Campo | Richiesto | Vincolo |
| --- | --- | --- |
| Text | Sì | Fino a 25 caratteri |
| PostbackData | Sì | Fino a 2.048 caratteri |
| Title | Sì | Fino a 100 caratteri |
| StartTime | Sì | Ora di inizio dell'evento |
| EndTime | Sì | Ora di fine dell'evento |
| Description | No | Fino a 500 caratteri |
## Ricezione di suggerimenti, tocchi
Quando un destinatario sceglie un suggerimento, AWS End User Messaging pubblica un messaggio in entrata sull'argomento SNS bidirezionale. `messageBody`Contiene un oggetto JSON con il tipo di suggerimento, il testo visualizzato e i parametri impostati. `postbackData` Attiva la tua logica. `postbackData`
```
{
"originationNumber": "+12065551234",
"destinationNumber": "rcs-a1b2c3d4",
"messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Yes, confirm\",\"postbackData\":\"confirm_order_12345\"}",
"inboundMessageId": "msg-abc123def456"
}
```
Con un `RequestLocation` tocco, le coordinate del destinatario arrivano in un altro luogo di arrivo. Per il riferimento completo all'evento in entrata, consulta. [Eventi dei messaggi RCS](rcs-events.md)
## Limiti dei suggerimenti
| Vincolo | Limite |
| --- | --- |
| Lunghezza del suggerimento Text | 25 caratteri |
| PostbackDatalunghezza | 2,048 caratteri |
| Suggerimenti per messaggio | 11 |
| Suggerimenti per scheda | 4 |
| CreateCalendarEventtitolo | 100 caratteri |
| CreateCalendarEventdescrizione | 500 caratteri |
## Best practice
+ Mantieni il testo orientato all'azione. *Usa verbi come *Traccia l'ordine*, *Chiama l'assistenza* o Visualizza il menu.*
+ Offri da 3 a 5 opzioni. Più di 5 possono sopraffare i destinatari.
+ Percorso attivo`PostbackData`, testo non visualizzato. Il testo è per le persone, i dati di postback sono per la tua applicazione.
+ Strutturate i dati di postback in modo coerente, ad esempio come `action:value` coppie o JSON.
+ Gestisci il caso in cui un destinatario digiti testo libero invece di toccare un suggerimento.
+ Combina i tipi di suggerimento in un unico messaggio, ad esempio a `Reply``OpenUrl`, an e a. `DialPhone`
Per una guida più approfondita, consulta[Le migliori pratiche RCS](rcs-best-practices.md).
## Argomenti correlati
+ [Invio di messaggi di testo RCS](rcs-text-messages.md)
+ [Invio di rich card RCS](rcs-rich-cards.md)
+ [Eventi dei messaggi RCS](rcs-events.md)