Keri sisuni

RCS-sõnumid

RCS (Rich Communication Services) on järgmise põlvkonna sõnumside Android-seadmetele, mis pakub rikasmeediat, interaktiivsust ja täiustatud funktsioone peale traditsiooniliste SMS-ide.

Ülevaade

RCS pakub täiustatud sõnumsidevõimalusi:

  • Rikasmeedia (pildid, videod, GIF-id)
  • Interaktiivsed nupud ja karussellid
  • Lugege kviitungeid ja tippimisnäitajaid
  • Kõrgemad tähemärgipiirangud (kuni 3072 tähemärki)
  • Parem kohaletoimetamise jälgimine
  • kaubamärgiga saatja tuvastamine

Saadavus

  • Platvorm: ainult Android-seadmed
  • Võrk: nõuab operaatori RCS-i tuge
  • Tagasimaks: naaseb automaatselt SMS-i, kui RCS pole saadaval

RCS-i põhiteade

RCS näide

Taotlus

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

Parameetrid

Parameeter Tüüp Nõutav Kirjeldus
"alates" string Jah Tähtnumbriline saatja ID
kuni string Jah Saaja telefoninumber (E.164)
"tüüp" string Jah Määrake "rcs"
tekst string Jah Sõnumi sisu (kuni 3072 tähemärki)
messageData objekt Ei Rikasmeedia ja nupud

Sõnumitüübid

Ainult tekst

Lihtne tekstsõnum pikendatud tähemärgipiiranguga:

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

Tekst + pilt

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

Tekst + pilt + nupp

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

Tekst + 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"
    }
  }
}

Tekst + mitu nuppu

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

Mitme üksuse kuvamine keritavas karussellis:

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

Nuputoimingud

Ava URL

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

Vali telefoninumber

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

Saada asukoht

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

Kalendri sündmus

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

Meediumispetsifikatsioonid

Pildid

  • Vormingud: JPEG, PNG, GIF
  • Maksimaalne suurus: 2 MB
  • Soovitatav eraldusvõime: 800x600 või 1200x800
  • Kuvasuhe: 16:9 või 4:3

Videod

  • Vormingud: MP4, 3GP
  • Maksimaalne suurus: 10 MB
  • Maksimaalne kestus: 2 minutit
  • Soovitatav eraldusvõime: 1280 x 720

Heli

  • Vormingud: MP3, AAC
  • Maksimaalne suurus: 5 MB
  • Maksimaalne kestus: 5 minutit

Tagasi SMS-i juurde

RCS naaseb automaatselt SMS-i, kui:

  • Saajal pole RCS-i
  • RCS on vastuvõtjaseadmes keelatud
  • Võrk ei toeta RCS-i
{
  "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"
  }
}

Kasutusjuhtumid

E-kaubandus

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

Pangandus

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

Reisimine

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

Parimad tavad

Sisu

  • ✅ Kasutage kvaliteetseid pilte (minimaalselt 800x600)
  • ✅ Hoidke nupu tekst lühike (2-3 sõna)
  • ✅ Pakkuge rikkaliku sisu jaoks SMS-i varu
  • ✅ Testige erinevates Android-seadmetes
  • ❌ Ärge ületage 4-5 nuppu sõnumi kohta
  • ❌ Vältige suuri videofaile (>5 MB)

Meedia

  • Kasutage kogu meedia jaoks HTTPS-i URL-e
  • Optimeerige pilte mobiili jaoks
  • Lisage juurdepääsetavuse tagamiseks alternatiivtekst
  • Enne saatmist testige meediumi URL-e

Nupud

  • Maksimaalselt 4 nuppu sõnumi kohta
  • Selge tegevusele kutsuv tekst
  • Testige kõiki nuppude toiminguid
  • Kaaluge varuvõimalust mittesaadavate toimingute puhul

Bränding

  • Kasutage ühtset saatja ID-d
  • Vajadusel lisage kaubamärgi logo
  • Säilitage kaubamärgi hääl ja toon
  • Tagada visuaalne järjepidevus

Kohaletoimetamise olek

RCS pakub täiustatud kohaletoimetamise jälgimist:

  • Saadetud: sõnum saadeti operaatorile
  • Edastatud: teade edastatakse seadmesse
  • Loe: saaja avas sõnumi
  • Ebaõnnestus: kohaletoimetamine ebaõnnestus, varundus käivitati

Kontrollige olekut oleku lõpp-punkti abil.

Järgmised sammud