Sporočila RCS

RCS (Rich Communication Services) je naslednja generacija sporočanja za naprave Android, ki ponuja bogato predstavnost, interaktivnost in napredne funkcije, ki presegajo običajna sporočila SMS.

Pregled

RCS ponuja izboljšane zmožnosti sporočanja:

Obogatena predstavnost (slike, videi, GIF-i)
Interaktivni gumbi in vrtiljaki
Preberite potrdila in indikatorje tipkanja
Višje omejitve znakov (do 3072 znakov)
Boljše sledenje dostavi
Identifikacija pošiljatelja z blagovno znamko

Razpoložljivost

Platforma: samo naprave Android
Omrežje: Zahteva podporo operaterja RCS
Nadomestni: samodejno se vrne na SMS, če RCS ni na voljo

Osnovno sporočilo RCS

Primer RCS

Zahteva

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

Parametri

Parameter	Vrsta	Zahtevano	Opis
`od`	niz	Da	Alfanumerični ID pošiljatelja
`do`	niz	Da	Telefonska številka prejemnika (E.164)
`tip`	niz	Da	Nastavite na `"rcs"`
`besedilo`	niz	Da	Vsebina sporočila (do 3072 znakov)
`podatki sporočila`	predmet	Ne	Obogatena predstavnost in gumbi

Vrste sporočil

Samo besedilo

Preprosto besedilno sporočilo z razširjeno omejitvijo znakov:

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

Besedilo + slika

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

Besedilo + slika + gumb

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

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

Besedilo + več gumbov

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

Vrtiljak RCS

Prikažite več elementov v vrtiljaku, po katerem se lahko pomikate:

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

Dejanja gumbov

Odpri URL

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

Pokličite telefonsko številko

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

Pošlji lokacijo

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

Koledarski dogodek

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

Specifikacije medijev

Slike

Formati: JPEG, PNG, GIF
Največja velikost: 2 MB
Priporočena ločljivost: 800x600 ali 1200x800
Razmerje stranic: 16:9 ali 4:3

Videoposnetki

Formati: MP4, 3GP
Največja velikost: 10 MB
Največje trajanje: 2 minuti
Priporočena ločljivost: 1280x720

Avdio

Formati: MP3, AAC
Največja velikost: 5 MB
Največje trajanje: 5 minut

Nazaj na SMS

RCS se samodejno vrne na SMS, ko:

Prejemnik nima RCS
RCS je onemogočen na prejemni napravi
Omrežje ne podpira 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"
  }
}

Primeri uporabe

E-trgovina

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

Bančništvo

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

Potovanje

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

Najboljše prakse

Vsebina

✅ Uporabite visokokakovostne slike (najmanj 800x600)
✅ Besedilo gumba naj bo kratko (2-3 besede)
✅ Zagotovite nadomestni SMS za bogato vsebino
✅ Preizkusite na različnih napravah Android
❌ Ne prekoračite 4-5 gumbov na sporočilo
❌ Izogibajte se velikim video datotekam (>5 MB)

Mediji

Uporabite URL-je HTTPS za vse medije
Optimizirajte slike za mobilne naprave
Vključite nadomestno besedilo za dostopnost
Pred pošiljanjem preizkusite URL-je medijev

Gumbi

Največ 4 gumbi na sporočilo
Jasno besedilo poziva k dejanju
Preizkusite vsa dejanja gumbov
Razmislite o nadomestni možnosti za nerazpoložljiva dejanja

Blagovna znamka

Uporabite dosleden ID pošiljatelja
Vključite logotip blagovne znamke, kjer je to primerno
Ohranite glas in ton blagovne znamke
Zagotovite vizualno doslednost

Status dostave

RCS zagotavlja izboljšano sledenje dostavi:

Poslano: Sporočilo je bilo poslano operaterju
Dostavljeno: sporočilo je bilo dostavljeno v napravo
Prebrano: sporočilo, ki ga je odprl prejemnik
Neuspešno: dostava ni uspela, sprožena nadomestna rešitev

Preverite stanje z uporabo status endpoint.

Naslednji koraki

– Sporočila Viber – Alternativno obogateno sporočanje – Sporočila SMS – Nadomestna sporočila - Preveri stanje - Sledite dostavi – Nadomestne strategije – Konfigurirajte nadomestne možnosti