Parametry RCS zpráv

RCS (Rich Communication Services) je nástupce SMS s bohatým obsahem přímo v nativní aplikaci pro zprávy na Androidu. Přes SmsManager odešlete RCS zprávu objektem rcs uvnitř pole flow — od prostého textu přes návrhy odpovědí a akční tlačítka až po rich card a carousel. Tato stránka je referenčním přehledem polí objektu rcs.

Základní pole

Pole	Typ	Popis
`sender`	string	ID vašeho RCS agenta (odesílatele). Pokud není uvedeno, použije se odesílatel z kořene požadavku.
`body`	string	Text zprávy. Pokud není uveden, použije se `body` z kořene požadavku.
`ttl`	integer	Doba života v minutách. Po jejím uplynutí se přejde na další krok `flow`.

Prostý text

{
  "to": [{ "phone_number": "420777123456" }],
  "flow": [
    {
      "rcs": {
        "sender": "muj_rcs_agent",
        "body": "Ahoj! Vaše objednávka je připravena k vyzvednutí."
      }
    }
  ]
}

RCS zpráva se odešle jen příjemcům s aktivním RCS. Vždy zařaďte za RCS krok SMS zálohu ve flow, aby zpráva dorazila i ostatním.

Tlačítka (`buttons`)

Pole buttons přidá pod zprávu návrhy odpovědí (chipy). Každé tlačítko má type — buď reply (rychlá odpověď), nebo url (otevře odkaz).

Pole tlačítka	Platí pro	Popis
`type`	oba	`reply` nebo `url`.
`text`	oba	Popisek tlačítka.
`postback`	oba	Data vrácená ve webhooku po klepnutí (`postbackData`).
`url`	`url`	Cílová URL.
`description`	`url`	Popis otevíraného odkazu.
`webview`	`url`	Režim zobrazení webview (`webviewViewMode`).

{
  "rcs": {
    "sender": "muj_rcs_agent",
    "body": "Jak vám můžeme pomoci?",
    "buttons": [
      { "type": "reply", "text": "Stav objednávky", "postback": "ORDER_STATUS" },
      { "type": "url", "text": "Otevřít e-shop", "postback": "OPEN_SHOP", "url": "https://example.com" }
    ]
  }
}

Samostatná rich card (`card`)

Pole card odešle jednu kartu s obrázkem/videem, nadpisem, popisem a volitelnými tlačítky.

Pole	Typ	Popis
`title`	string	Nadpis karty.
`description`	string	Popis karty.
`file`	string	URL media (obrázek/video).
`thumbnail`	string	URL náhledu.
`buttons`	array	Tlačítka karty (stejný tvar jako výše).

{
  "rcs": {
    "sender": "muj_rcs_agent",
    "card": {
      "title": "Letní sleva",
      "description": "Sleva 20 % na celý sortiment do konce měsíce.",
      "file": "https://example.com/promo.jpg",
      "thumbnail": "https://example.com/promo-thumb.jpg",
      "buttons": [
        { "type": "url", "text": "Nakoupit", "postback": "SHOP", "url": "https://example.com/sale" }
      ]
    }
  }
}

Carousel (`carousel`)

Pole carousel odešle vodorovně listovatelnou řadu karet. Každá položka přidává navíc pole type (typ media):

Pole	Typ	Popis
`title`	string	Nadpis karty.
`description`	string	Popis karty.
`type`	string	Typ media karty.
`file`	string	URL media.
`thumbnail`	string	URL náhledu.
`buttons`	array	Tlačítka karty.

{
  "rcs": {
    "sender": "muj_rcs_agent",
    "carousel": [
      {
        "title": "Produkt A",
        "description": "Skladem",
        "type": "image",
        "file": "https://example.com/a.jpg",
        "thumbnail": "https://example.com/a-thumb.jpg",
        "buttons": [{ "type": "url", "text": "Detail", "postback": "A", "url": "https://example.com/a" }]
      },
      {
        "title": "Produkt B",
        "description": "Novinka",
        "type": "image",
        "file": "https://example.com/b.jpg",
        "thumbnail": "https://example.com/b-thumb.jpg"
      }
    ]
  }
}

Raw průchozí zápis (`raw`)

Pro obsah, který toto rozhraní nepokrývá, předejte objekt raw — klíč suggestions pro vlastní návrhy nebo richCard pro vlastní kartu se odešle na RCS API beze změny.

{
  "rcs": {
    "sender": "muj_rcs_agent",
    "body": "…",
    "raw": { "suggestions": [ { "reply": { "text": "Ano", "postbackData": "YES" } } ] }
  }
}

Další kroky

Kanály

Přehled všech kanálů SmsManageru a jejich polí ve flow.

Životní cyklus zprávy

Jak zařadit RCS s SMS zálohou a jak funguje ttl_condition.

Webhooky

Příjem stavů doručení a klepnutí na tlačítka.

Odeslat SMS

Nakonfigurujte SMS zálohu pro vaše RCS zprávy.

JSON API v2

REST API

Verify API

WhatsApp Partner API

HTTP API

XML API

Referenční tabulky

Základní pole

Tlačítka (`buttons`)

Samostatná rich card (`card`)

Carousel (`carousel`)

Raw průchozí zápis (`raw`)

Další kroky

Kanály

Životní cyklus zprávy

Webhooky

Odeslat SMS

​Základní pole

​Tlačítka (buttons)

​Samostatná rich card (card)

​Carousel (carousel)

​Raw průchozí zápis (raw)

​Další kroky

Kanály

Životní cyklus zprávy

Webhooky

Odeslat SMS

Základní pole

Tlačítka (`buttons`)

Samostatná rich card (`card`)

Carousel (`carousel`)

Raw průchozí zápis (`raw`)

Další kroky