Vai al contenuto

Messaggi RCS

RCS (Rich Communication Services) è la prossima generazione di messaggistica per dispositivi Android, che offre contenuti multimediali, interattività e funzionalità avanzate oltre ai tradizionali SMS.

Panoramica

RCS fornisce funzionalità di messaggistica avanzate:

  • Rich media (immagini, video, GIF)
  • Pulsanti interattivi e caroselli
  • Leggere ricevute e indicatori di digitazione
  • Limiti di caratteri più elevati (fino a 3072 caratteri)
  • Migliore tracciabilità della consegna
  • Identificazione del mittente con marchio

Disponibilità

  • Piattaforma: solo dispositivi Android
  • Rete: richiede il supporto RCS dell'operatore
  • Fallback: ritorna automaticamente agli SMS se RCS non è disponibile

Messaggio RCS di base

Esempio RCS

Richiesta

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your RCS message text with rich formatting"
}

Parametri

Parametro Digitare Obbligatorio Descrizione
"da" stringa Sì ID mittente alfanumerico
"a" stringa Sì Numero di telefono del destinatario (E.164)
"tipo" stringa Sì Impostato su "rcs"
"testo" stringa Sì Contenuto del messaggio (fino a 3072 caratteri)
messaggioData oggetto No Rich media e pulsanti

Tipi di messaggi

Solo testo

Messaggio di testo semplice con limite di caratteri esteso:

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Welcome to our service! RCS allows us to send much longer messages with rich formatting and interactive elements."
}

Testo + Immagine

CODICE_BLOCCO_2

Testo + Immagine + Pulsante

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Summer Sale - Up to 50% off!",
  "messageData": {
    "media": {
      "url": "https://example.com/sale-banner.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Shop Now",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/sale"
        }
      }
    ]
  }
}

Testo + video

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Watch our product demo",
  "messageData": {
    "media": {
      "url": "https://example.com/demo.mp4",
      "type": "video/mp4",
      "thumbnail": "https://example.com/thumbnail.jpg"
    }
  }
}

Testo + pulsanti multipli

CODICE_BLOCCO_5

Carosello RCS

Visualizza più elementi in un carosello scorrevole:

CODICE_BLOCCO_6

Azioni dei pulsanti

Apri l'URL

CODICE_BLOCCO_7

Comporre il numero di telefono

{
  "text": "Call Us",
  "action": {
    "type": "dial",
    "phoneNumber": "+380XXXXXXXXX"
  }
}

Invia posizione

{
  "text": "Share Location",
  "action": {
    "type": "shareLocation"
  }
}

Evento del calendario

{
  "text": "Add to Calendar",
  "action": {
    "type": "createCalendarEvent",
    "title": "Appointment",
    "startTime": "2025-01-25T14:00:00Z",
    "endTime": "2025-01-25T15:00:00Z"
  }
}

Specifiche dei supporti

Immagini

  • Formati: JPEG, PNG, GIF
  • Dimensione massima: 2MB
  • Risoluzione consigliata: 800x600 o 1200x800
  • Proporzioni: 16:9 o 4:3

Video

  • Formati: MP4, 3GP
  • Dimensione massima: 10 MB
  • Durata massima: 2 minuti
  • Risoluzione consigliata: 1280x720

Audio

  • Formati: MP3, AAC
  • Dimensione massima: 5 MB
  • Durata massima: 5 minuti

Fallback agli SMS

RCS ritorna automaticamente agli SMS quando:

  • Il destinatario non ha RCS
  • RCS è disabilitato sul dispositivo ricevente
  • La rete non supporta RCS
{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Check out our new product!",
  "messageData": {
    "media": {
      "url": "https://example.com/product.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Shop Now",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/shop"
        }
      }
    ]
  },
  "fallback": {
    "type": "sms",
    "text": "Check out our new product! Visit: https://example.com/shop"
  }
}

Casi d'uso

Commercio elettronico

CODICE_BLOCCO_12

Bancario

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Low balance alert: Your account balance is $50",
  "messageData": {
    "buttons": [
      {
        "text": "View Balance",
        "action": {
          "type": "openUrl",
          "url": "https://bank.example.com/balance"
        }
      },
      {
        "text": "Transfer Money",
        "action": {
          "type": "openUrl",
          "url": "https://bank.example.com/transfer"
        }
      }
    ]
  }
}

Viaggiare

CODICE_BLOCCO_14

Migliori pratiche

Contenuto

  • ✅ Utilizza immagini di alta qualità (minimo 800x600)
  • ✅ Mantieni il testo del pulsante breve (2-3 parole)
  • ✅ Fornire fallback SMS per contenuti ricchi
  • ✅ Prova su diversi dispositivi Android
  • ❌ Non superare i 4-5 pulsanti per messaggio
  • ❌ Evita file video di grandi dimensioni (>5 MB)

Multimedia

  • Utilizza URL HTTPS per tutti i media
  • Ottimizza le immagini per i dispositivi mobili
  • Includi testo alternativo per l'accessibilità
  • Testare gli URL dei media prima dell'invio

Pulsanti

  • Massimo 4 pulsanti per messaggio
  • Testo chiaro dell'invito all'azione
  • Testare tutte le azioni dei pulsanti
  • Considera il fallback per le azioni non disponibili

Marchio

  • Utilizza un ID mittente coerente
  • Includere il logo del marchio, ove appropriato
  • Mantenere la voce e il tono del marchio
  • Garantire la coerenza visiva

Stato di consegna

RCS fornisce un monitoraggio avanzato della consegna:

  • Inviato: messaggio inviato al corriere
  • Consegnato: messaggio consegnato al dispositivo
  • Leggi: messaggio aperto dal destinatario
  • Non riuscita: consegna non riuscita, fallback attivato

Controlla lo stato utilizzando l'endpoint stato.

Passaggi successivi