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
Argomenti
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.
| 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.
VERTICALI 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.
HORIZONTALI 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
ThumbnailImageAlignmentper 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
| 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 accettaVERTICALoHORIZONTAL.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:
| 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
| 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 |