View a markdown version of this page

Invio di rich card RCS - AWS SMS di messaggistica per l'utente finale

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 rich card RCS

Una rich card combina contenuti multimediali, testo e azioni suggerite in un unico messaggio strutturato. I destinatari vedono la scheda come un elemento nativo dell'interfaccia utente del loro client di messaggistica, che offre un'esperienza simile a quella di un'app. Utilizza le rich card per presentare informazioni che incoraggiano l'interazione, come dettagli sui prodotti, conferme di prenotazione o offerte promozionali.

Importante

Puoi utilizzare la messaggistica rich media RCS (incluse le rich card) in tutti i paesi in cui è supportato RCS. Per ulteriori informazioni, consulta Invio di messaggi RCS complessi.

Per raggruppare più carte in un set scorrevole, vedi. Invio di caroselli RCS

Quando usare una carta ricca

Le rich card sono ideali per i messaggi che beneficiano di un layout visivo con elementi interattivi. Casi di utilizzo comune comprendono:

  • Vetrine dei prodotti: visualizza un'immagine, il nome del prodotto, il prezzo e un pulsante di acquisto in un unico messaggio.

  • Conferme di prenotazione: mostra i dettagli della prenotazione con un link al calendario e un pulsante con le indicazioni stradali.

  • Dettagli dell'appuntamento: data, ora, luogo attuali e opzioni per confermare o riprogrammare.

  • Offerte promozionali: evidenzia un accordo con i media e un chiaro invito all'azione.

Se il tuo messaggio richiede solo testo con suggerimenti opzionali, usa Invio di messaggi di testo RCS invece un. Se devi inviare un file senza una struttura di schede aggiuntiva, vediInvio di messaggi di file RCS.

Componenti della scheda Rich

Una rich card autonoma è composta dai seguenti componenti. Almeno uno dei MediaTitle, o Description è richiesto inCardContent.

Componenti della scheda Rich
Componente Richiesto Description
Media No Un'immagine, una GIF o un video visualizzato all'interno della scheda. I formati supportati includono JPEG, PNG, GIF e MP4. Il file può avere una dimensione massima di 100 MB.
Title No Un breve titolo per il biglietto. Massimo 200 caratteri.
Description No Corpo del testo che fornisce dettagli aggiuntivi. Massimo 2.000 caratteri.
Suggestions No Fino a 4 azioni o risposte suggerite allegate alla scheda. Per informazioni, consulta Configurazione dei suggerimenti RCS.

Orientamento della carta

Il CardOrientation campo controlla la relazione di layout tra contenuti multimediali e testuali. Questo campo è obbligatorio.

VERTICAL

I file multimediali vengono visualizzati nella parte superiore della scheda con titolo, descrizione e suggerimenti di seguito. L'orientamento verticale è l'impostazione predefinita consigliata per la compatibilità multipiattaforma.

HORIZONTAL

I file multimediali vengono visualizzati sul lato sinistro o destro della scheda con il contenuto testuale accanto. L'area multimediale ha una larghezza fissa di 128 pixel indipendenti dalla densità (DP). Si usa ThumbnailImageAlignment per controllare se il file multimediale viene visualizzato a sinistra o a destra.

avvertimento

L'orientamento orizzontale causa il troncamento dell'immagine sui dispositivi iOS. Usa l'VERTICALorientamento per le implementazioni multipiattaforma.

Media e altezze

L'Mediaoggetto contiene un Height valore FileUrl (obbligatorio), uno opzionale ThumbnailUrl e uno facoltativo. FileUrlDeve corrispondere al modello ^(https://|s3://).+$ e può contenere un massimo di 2.000 caratteri. La dimensione massima del file multimediale è 100 MB.

Per dettagli sui formati multimediali supportati, sulle opzioni di consegna e sugli URL predefiniti S3, consulta. Invio di messaggi di file RCS

Valori di altezza dei supporti
Altezza Dimensione Description
SHORT 112 DP Display compatto Utilizzalo per le miniature o quando il contenuto del testo è l'obiettivo principale.
MEDIUM 168 DPI Display bilanciato. Impostazione predefinita consigliata per la maggior parte dei casi d'uso.
TALL 264 DP Area di visualizzazione massima. Da utilizzare quando il contenuto multimediale è il contenuto principale.
Nota

iOS esegue il rendering di tutti i valori di altezza dei file multimediali in modo identico, ignorando l'impostazione di altezza specificata. TALLUtilizzalo per massimizzare l'area di visualizzazione sui dispositivi Android mantenendo un rendering accettabile su iOS.

Card-level suggerimenti

Puoi allegare fino a 4 suggerimenti a una rich card includendoli nell'CardContent.Suggestionsarray. Card-level i suggerimenti vengono visualizzati direttamente sotto il contenuto della scheda.

Oltre ai suggerimenti a livello di scheda, puoi includere fino a 11 suggerimenti a livello di messaggio nell'array di primo livello Suggestions della struttura. RcsMessageContent Message-level i suggerimenti vengono visualizzati come chip permanenti sotto l'intero messaggio.

Per l'elenco completo dei tipi di suggerimenti (inclusiReply,OpenUrl,DialPhone, ShowLocationRequestLocation, eCreateCalendarEvent), vediConfigurazione dei suggerimenti RCS.

RcsMessageContent struttura

Il codice JSON seguente mostra la struttura del RcsMessageContent parametro per una rich card autonoma. Passa questo JSON come stringa al --rcs-message-content parametro nella AWS CLI o come parametro RcsMessageContent nell'SDK.

{ "Content": { "RichCard": { "StandaloneCard": { "CardOrientation": "VERTICAL", "CardContent": { "Title": "Your card title", "Description": "Additional details about the card content.", "Media": { "FileUrl": "https://example.com/image.jpg", "ThumbnailUrl": "https://example.com/thumb.jpg", "Height": "MEDIUM" }, "Suggestions": [ { "Reply": { "Text": "Confirm", "PostbackData": "confirm_action" } }, { "OpenUrl": { "Text": "View details", "PostbackData": "view_details", "Url": "https://www.example.com/details" } } ] } } } }, "Suggestions": [ { "Reply": { "Text": "Help", "PostbackData": "help_menu" } } ] }

In questa struttura:

  • Content.RichCard.StandaloneCardcontiene la definizione della carta.

  • CardOrientationè obbligatorio e accetta VERTICAL oHORIZONTAL.

  • ThumbnailImageAlignmentè facoltativo e si applica solo alle carte orizzontali.

  • CardContent.Suggestionscontiene suggerimenti a livello di scheda (massimo 4).

  • L'Suggestionsarray di primo livello contiene suggerimenti a livello di messaggio (massimo 11).

Invio di una carta ricca

Utilizza l'azione SendRcsMessage API per inviare una rich card. Specificate il vostro pool o l'agente AWS RCS come --origination-identity parametro e passate la struttura JSON della rich card. --rcs-message-content

Cross-platform rendering

Il rendering delle Rich Card varia tra i dispositivi Android e iOS. Segui questi consigli per ottenere risultati coerenti:

Cross-platform raccomandazioni
Raccomandazione Motivo
Usa l'VERTICALorientamento L'orientamento orizzontale causa il troncamento dell'immagine su iOS.
Usa l'altezza del supporto TALL iOS ignora il valore dell'altezza. TALLmassimizza l'area di visualizzazione su Android.
Mantieni il titolo su un massimo di 3 righe Impedisce il ritaglio dei file multimediali su iOS con le impostazioni di accessibilità abilitate.
Usa i suggerimenti per i link OpenUrl Gli URL nel testo della descrizione non sono cliccabili su nessuna delle due piattaforme.
Prova i file multimediali GIF su iOS Verifica che il rendering statico del primo fotogramma sia accettabile.

Limiti delle Rich Card

Limiti delle Rich Card
Risorsa Limite
Lunghezza del titolo 200 caratteri
Lunghezza della descrizione 2.000 caratteri
Card-level suggerimenti 4 per carta
Message-level suggerimenti 11 per messaggio
Carico utile totale dei messaggi 250 KB
Dimensione del file multimediale 100 MB
FileUrllunghezza 2.000 caratteri