Messaġġi RCS

RCS (Rich Communication Services) hija l-ġenerazzjoni li jmiss ta’ messaġġi għal tagħmir Android, li toffri midja rikka, interattività, u karatteristiċi avvanzati lil hinn mill-SMS tradizzjonali.

Ħarsa ġenerali

RCS jipprovdi kapaċitajiet ta' messaġġi mtejba:

Rich media (immaġini, vidjows, GIFs)
Buttuni u karużelli interattivi
Aqra l-irċevuti u l-indikaturi tat-tajpjar
Limiti ogħla ta' karattri (sa 3072 karattru)
Traċċar aħjar tal-kunsinna
Identifikazzjoni tal-mittent tad-ditta

Disponibbiltà

Pjattaforma: Apparat Android biss
Netwerk: Jeħtieġ appoġġ tat-trasportatur RCS
Fallback: Awtomatikament taqa' lura għall-SMS jekk RCS ma jkunx disponibbli

Messaġġ RCS bażiku

RCS Eżempju

Talba

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

Parametri

Parametru	Tip	Meħtieġa	Deskrizzjoni
"minn"	spag	Iva	ID alfanumeriku tal-mittent
"għal"	spag	Iva	Numru tat-telefon tar-riċevitur (E.164)
"tip"	spag	Iva	Issettja għal `"rcs"`
"test"	spag	Iva	Kontenut tal-messaġġ (sa 3072 chars)
`MessageData`	oġġett	Le	Rich media u buttuni

Tipi ta' Messaġġi

Test Biss

Messaġġ sempliċi b'limitu ta' karattri estiż:

{
  "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."
}

Test + Immaġni

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Check out our new product!",
  "messageData": {
    "media": {
      "url": "https://example.com/product.jpg",
      "type": "image/jpeg",
      "height": 600,
      "width": 800
    }
  }
}

Test + Immaġni + Buttuna

{
  "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"
        }
      }
    ]
  }
}

Test + Vidjo

{
  "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"
    }
  }
}

Test + Buttuni Multipli

{
  "from": "YourService",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your order #12345 is ready for pickup",
  "messageData": {
    "buttons": [
      {
        "text": "Track Order",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/track/12345"
        }
      },
      {
        "text": "Contact Support",
        "action": {
          "type": "dial",
          "phoneNumber": "+380XXXXXXXXX"
        }
      },
      {
        "text": "Cancel Order",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/cancel/12345"
        }
      }
    ]
  }
}

RCS Carousel

Uri oġġetti multipli f'karużell li jista' jiskrollja:

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Featured Products",
  "messageData": {
    "carousel": {
      "cards": [
        {
          "title": "Product A",
          "description": "Premium quality product",
          "media": {
            "url": "https://example.com/product-a.jpg",
            "type": "image/jpeg"
          },
          "buttons": [
            {
              "text": "Buy Now",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-a"
              }
            },
            {
              "text": "Details",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-a/details"
              }
            }
          ]
        },
        {
          "title": "Product B",
          "description": "Best seller",
          "media": {
            "url": "https://example.com/product-b.jpg",
            "type": "image/jpeg"
          },
          "buttons": [
            {
              "text": "Buy Now",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-b"
              }
            }
          ]
        }
      ]
    }
  }
}

Azzjonijiet tal-Buttuni

Iftaħ il-URL

{
  "text": "Visit Website",
  "action": {
    "type": "openUrl",
    "url": "https://example.com"
  }
}

Ċempel in-Numru tat-Telefon

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

Ibgħat Post

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

Avveniment tal-Kalendarju

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

Speċifikazzjonijiet tal-Midja

Stampi

Formati: JPEG, PNG, GIF
Daqs massimu: 2MB
Riżoluzzjoni rakkomandata: 800x600 jew 1200x800
Proporzjon tal-aspett: 16:9 jew 4:3

Vidjows

Formati: MP4, 3GP
Daqs massimu: 10MB
Tul massimu: 2 minuti
Riżoluzzjoni rakkomandata: 1280x720

Awdjo

Formati: MP3, AAC
Daqs massimu: 5MB
Tul massimu: 5 minuti

Fallback għall-SMS

RCS awtomatikament jaqa' lura għall-SMS meta:

Ir-riċevitur m'għandux RCS
RCS huwa diżattivat fuq it-tagħmir riċevitur
Netwerk ma jappoġġjax 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"
  }
}

Każijiet ta' Użu

Kummerċ elettroniku

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your order has been shipped!",
  "messageData": {
    "media": {
      "url": "https://example.com/package.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Track Package",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/track/ABC123"
        }
      },
      {
        "text": "Contact Support",
        "action": {
          "type": "dial",
          "phoneNumber": "+380XXXXXXXXX"
        }
      }
    ]
  }
}

Bankarja

{
  "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"
        }
      }
    ]
  }
}

Ivvjaġġar

{
  "from": "YourAirline",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your flight is departing in 3 hours",
  "messageData": {
    "media": {
      "url": "https://example.com/boarding-pass.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Check-in",
        "action": {
          "type": "openUrl",
          "url": "https://airline.example.com/checkin"
        }
      },
      {
        "text": "Add to Calendar",
        "action": {
          "type": "createCalendarEvent",
          "title": "Flight Departure",
          "startTime": "2025-01-25T10:00:00Z"
        }
      }
    ]
  }
}

L-Aħjar Prattiċi

Kontenut

✅ Uża immaġini ta 'kwalità għolja (minimu 800x600)
✅ Żomm it-test tal-buttuna qasir (2-3 kelmiet)
✅ Ipprovdi lura SMS għal kontenut għani
✅ Test fuq apparati Android differenti
❌ Taqbiżx 4-5 buttuni għal kull messaġġ
❌ Evita fajls tal-vidjo kbar (>5MB)

Midja

Uża URLs HTTPS għall-midja kollha
Ottimizza l-immaġini għall-mowbajl
Inkludi test alternattiv għall-aċċessibbiltà
Ittestja l-URLs tal-midja qabel ma tibgħat

Buttuni

Massimu 4 buttuni għal kull messaġġ
Test ċar ta' sejħa għall-azzjoni
Ittestja l-azzjonijiet kollha tal-buttuna
Ikkunsidra r-riżerva għal azzjonijiet mhux disponibbli

Branding

Uża ID konsistenti tal-mittent
Inkludi l-logo tal-marka fejn xieraq
Żomm il-vuċi u t-ton tal-marka
Tiżgura konsistenza viżwali

Status ta' Kunsinna

RCS jipprovdi traċċar imtejjeb tal-kunsinna:

Mibgħut: Messaġġ mibgħut lit-trasportatur
Konsenjat: Messaġġ ikkonsenjat lill-apparat
Aqra: Messaġġ miftuħ mir-riċevitur
Failless: Il-kunsinna falliet, infetħet il-backup

Iċċekkja l-istatus billi tuża l-endpoint tal-istatus.

Il-passi li jmiss

Messaġġi Viber - Messaġġi sinjuri alternattivi
Messaġġi SMS - Messaġġi ta' riżerva
Iċċekkja l-Istatus - Il-konsenja tal-binarji
Istrateġiji Fallback - Ikkonfigura r-riżervi