Help Center RCS poruke

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

Viber poruke - Alternativno obogaćeno slanje poruka
SMS poruke - Rezervne poruke
Provjeri status - Prati dostavu
Zamjenske strategije - Konfigurirajte zamjenske strategije

Search Results