Help Center RCS-sõnumid

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

ParameeterTüüpNõutavKirjeldus
”alates”stringJahTähtnumbriline saatja ID
kunistringJahSaaja telefoninumber (E.164)
“tüüp”stringJahMäärake “rcs”
tekststringJahSõnumi sisu (kuni 3072 tähemärki)
messageDataobjektEiRikasmeedia 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