Preskoči na sadržaj

RCS poruke

RCS (Rich Communication Services) je sljedeća generacija slanja poruka za Android uređaje, koja nudi bogate medije, interaktivnost i napredne značajke izvan tradicionalnog SMS-a.

Pregled

RCS pruža poboljšane mogućnosti slanja poruka:

  • Bogati mediji (slike, videozapisi, GIF-ovi)
  • Interaktivni gumbi i karuseli
  • Potvrde o čitanju i indikatori tipkanja
  • Veća ograničenja znakova (do 3072 znaka)
  • Bolje praćenje isporuke
  • Brendirana identifikacija pošiljatelja

Dostupnost

  • Platforma: samo Android uređaji
  • Mreža: Zahtijeva RCS podršku operatera
  • Rezervni: Automatski se vraća na SMS ako RCS nije dostupan

Osnovna RCS poruka

RCS primjer

Zahtjev

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

Parametri

Parametar Upišite Obavezno Opis
od niz Da Alfanumerički ID pošiljatelja
za niz Da Telefonski broj primatelja (E.164)
tip niz Da Postavite na "rcs"
tekst niz Da Sadržaj poruke (do 3072 znakova)
podaci poruke objekt Ne Bogati mediji i gumbi

Vrste poruka

Samo tekst

Jednostavna tekstualna poruka s produženim ograničenjem broja znakova:

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

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

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 + višestruki gumbi

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

Prikaži više stavki u vrtuljku koji se može pomicati:

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

Radnje gumba

Otvori URL

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

Birajte telefonski broj

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

Pošalji lokaciju

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

Kalendarski događaj

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

Specifikacije medija

Slike

  • Formati: JPEG, PNG, GIF
  • Maksimalna veličina: 2MB
  • Preporučena razlučivost: 800x600 ili 1200x800
  • Omjer slike: 16:9 ili 4:3

Videozapisi

  • Formati: MP4, 3GP
  • Maksimalna veličina: 10 MB
  • Maksimalno trajanje: 2 minute
  • Preporučena razlučivost: 1280x720

Audio

  • Formati: MP3, AAC
  • Maksimalna veličina: 5 MB
  • Maksimalno trajanje: 5 minuta

Povratak na SMS

RCS se automatski vraća na SMS kada:

  • Primatelj nema RCS
  • RCS je onemogućen na uređaju primatelja
  • Mreža ne podržava 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"
  }
}

Slučajevi upotrebe

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

Bankarstvo

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

Putujte

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

Najbolji primjeri iz prakse

Sadržaj

  • ✅ Koristite slike visoke kvalitete (minimalno 800x600)
  • ✅ Neka tekst gumba bude kratak (2-3 riječi)
  • ✅ Omogućite rezervni SMS za bogat sadržaj
  • ✅ Testirajte na različitim Android uređajima
  • ❌ Nemojte prekoračiti 4-5 gumba po poruci
  • ❌ Izbjegavajte velike video datoteke (>5 MB)

Mediji

  • Koristite HTTPS URL-ove za sve medije
  • Optimizirajte slike za mobitel
  • Uključite zamjenski tekst za pristupačnost
  • Testirajte URL-ove medija prije slanja

Gumbi

  • Najviše 4 gumba po poruci
  • Jasan tekst poziva na radnju
  • Testirajte sve radnje gumba
  • Razmislite o zamjeni za nedostupne radnje

Brendiranje

  • Koristite dosljedan ID pošiljatelja
  • Uključite logotip marke gdje je to prikladno
  • Održavajte glas i ton marke
  • Osigurajte vizualnu dosljednost

Status isporuke

RCS pruža poboljšano praćenje isporuke:

  • Poslano: Poruka poslana operateru
  • Isporučeno: Poruka je isporučena na uređaj
  • Pročitano: Poruku otvorio primatelj
  • Neuspješno: Isporuka nije uspjela, aktivirana rezervna opcija

Provjerite status pomoću status endpoint.

Sljedeći koraci