Limiti delle rich card RCS
Il riferimento dell'API RCS Business Messaging (RBM) di Google stabilisce i limiti che una rich card deve rispettare. I messaggi che li violano vengono respinti dall'API, quindi questo creatore li controlla mentre digitate.
Fonte: Google, riferimento RBM per phones.agentMessages, https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages, e la guida all'invio dei messaggi, https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send (verificate a ottobre 2026).
- Titolo della card: fino a 200 caratteri. Descrizione: fino a 2.000 caratteri.
- Suggerimenti su una card: fino a 4 risposte o azioni, ciascuna fino a 25 caratteri.
- Chip di suggerimento sotto il messaggio: fino a 11.
- Carosello: da 2 a 10 card, con larghezza della card SMALL (120 DP) o MEDIUM (232 DP).
- Altezza del contenuto multimediale: SHORT (112 DP), MEDIUM (168 DP) o TALL (264 DP). File multimediali fino a 100 MB; miniature fino a 100 kB.
- Dati postback e URL di fallback: fino a 2.048 caratteri. Messaggi di solo testo: fino a 3.072 caratteri.
Card singola o carosello?
Usate una card singola quando c'è una sola cosa su cui agire: una prenotazione da confermare, un pacco da tracciare, un pagamento da completare. Una card verticale mette il contenuto multimediale in alto e funziona meglio con un'immagine forte. Una card orizzontale colloca una miniatura accanto al testo, adatta a ricevute e aggiornamenti di stato; richiede un titolo, una descrizione o un suggerimento accanto al contenuto multimediale.
Usate un carosello quando il cliente deve scegliere: prodotti, voli, piani, fasce orarie per appuntamenti. Mantenete le card coerenti, tutte con contenuti multimediali o tutte senza, e date a titoli e descrizioni una lunghezza simile, perché le card del carosello sono mostrate a un'altezza uniforme. Mettete per prima la scelta più probabile.
Risposte e azioni suggerite
Le risposte suggerite rimandano al vostro agente un testo fisso insieme ai dati postback, così il vostro bot sa esattamente quale opzione è stata toccata. Le azioni suggerite aprono le app del telefono: il tastierino, il browser o una webview, le mappe, il calendario o il selettore di posizione per condividere una posizione.
I suggerimenti delle card restano associati alla card. I chip compaiono in una riga scorrevole sotto l'ultimo messaggio e scompaiono quando il cliente ne tocca uno o risponde, quindi usateli per i passi successivi come “Parla con un operatore” o “Interrompi i messaggi”. Da novembre 2025 le azioni di apertura URL devono usare link http:// o https://.
Mittente verificato e fallback SMS
Ogni agente aziendale RCS viene verificato prima del lancio: Google e gli operatori controllano brand, logo e caso d'uso, e la conversazione mostra il nome del brand con un badge di verifica. Questo segnale di fiducia è gran parte del motivo per cui i messaggi RCS ottengono un coinvolgimento più alto dei semplici SMS.
Non tutti i telefoni o le reti supportano l'RCS, quindi il traffico in produzione richiede un fallback. La versione SMS deve contenere l'essenziale e un link. Un SMS contiene 160 caratteri GSM-7 o 70 caratteri UCS-2; i testi più lunghi vengono divisi in parti da 153 o 67 caratteri, ciascuna fatturata come un messaggio. Testo arabo, emoji e persino gli apostrofi tipografici forzano UCS-2, quindi il creatore conta le parti e può sostituire i caratteri tipografici con quelli semplici.
Il JSON esportato
L'esportazione segue la forma di un contentMessage di AgentMessage RBM, con una standaloneCard o carouselCard, suggerimenti delle card e suggerimenti a livello di messaggio. Gli URL dei contenuti multimediali sono segnaposto e i dati postback sono generati dal testo del pulsante. È illustrativo: usatelo per istruire gli sviluppatori o per confrontarlo con l'API del vostro fornitore.
Con OmniChannels.ai inviate la stessa card, lo stesso carosello e gli stessi suggerimenti tramite un'unica API REST o una campagna, con fallback SMS automatico e rapporti di consegna per entrambi i canali.
