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 caroselli RCS

Un messaggio carosello in AWS End User Messaging mostra da 2 a 10 rich card in una striscia scorrevole orizzontalmente. I destinatari possono scorrere le schede e scegliere suggerimenti sulle singole schede per agire. Con i caroselli, puoi creare esperienze conversazionali e interattive come cataloghi di prodotti, menu di servizi, confronti di piani ed elenchi di sedi.

I caroselli condividono lo stesso modello di contenuto cartaceo delle rich card autonome (vediInvio di rich card RCS), ma le carte carosello utilizzano sempre un layout verticale e non supportano l'altezza dei file multimediali. TALL

Quando usare una giostra

Usa un carosello quando desideri che i destinatari sfogliino e confrontino più elementi dello stesso tipo. Casi di utilizzo comune comprendono:

Se devi visualizzare un singolo elemento con contenuti avanzati, utilizza invece una rich card autonoma. Per informazioni dettagliate, vedi Invio di rich card RCS.

Struttura a carosello

Si definisce un carosello nell'Content.Carouseloggetto all'interno del RcsMessageContent parametro di una richiesta. SendRcsMessage L'oggetto carousel contiene due campi obbligatori:

Valori di larghezza della carta

Campi relativi al contenuto della scheda

Ogni oggetto della scheda nell'CardContentsarray supporta i seguenti campi:

Suggerimenti relativi alle carte e suggerimenti esterni

I messaggi Carousel supportano due livelli di suggerimenti:

Usa i suggerimenti esterni per le azioni di navigazione che si applicano al messaggio generale, come «Torna al menu», «Aiuto» o «Navigazione completata». Evita di duplicare le azioni a livello di scheda nell'elenco dei chip esterni.

Altezza e troncamento della carta

Tutte le carte in un carosello vengono ridimensionate in base all'altezza della carta più alta. Se il contenuto di una scheda supera l'altezza massima di visualizzazione, il client di messaggistica tronca il contenuto nel seguente ordine:

Quando viene applicato il troncamento, viene visualizzato un indicatore «Altro» in modo che il destinatario possa espandere la scheda alla visualizzazione a schermo intero.

Proporzioni multimediali

Le proporzioni dei supporti cartacei dipendono dalla combinazione di larghezza e altezza della scheda.

Struttura JSON a carousel

Il seguente codice JSON mostra la struttura del RcsMessageContent parametro per un messaggio carosello:

{
  "Content": {
    "Carousel": {
      "CardWidth": "SMALL | MEDIUM",
      "CardContents": [
        {
          "Title": "Card title (max 200 chars)",
          "Description": "Card description (max 2000 chars)",
          "Media": {
            "FileUrl": "https://example.com/image.jpg",
            "ThumbnailUrl": "https://example.com/thumb.jpg",
            "Height": "SHORT | MEDIUM"
          },
          "Suggestions": [
            {
              "Reply": {
                "Text": "Button label (max 25 chars)",
                "PostbackData": "callback_data"
              }
            }
          ]
        }
      ]
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Outer chip label",
        "PostbackData": "outer_callback"
      }
    }
  ]
}

Questo valore viene passato come stringa JSON nel --rcs-message-content parametro (CLI) o nel parametro (RcsMessageContentSDK). Nella richiesta è inoltre necessario specificare --destination-phone-number and --origination-identity (un pool o un agente RCS). send-rcs-message

Limiti del carosello

Per i dettagli relativi al formato multimediale e alla consegna, vedereInvio di messaggi di file RCS.