RCS Payload Specification
The following table describes the RCS API payload specifications for messaging APIs:
| Properties | Description | US Region | IN Region | Validated Data by Kaleyra |
|---|---|---|---|---|
| MAX_DEVICE_ADDRESSES | Device lookup limit per API call. | 500 | NA | 500 |
| MAX_SIZE_TEXT | Text character length. | 3072 | 2500 | 3072 |
| MAX_SIZE_REFERENCE_KEYS | Maximum number of characters allowed for the Ref1, Ref2, and Ref3 optional parameters passed in Mobile Terminated (MT) messages for reporting purpose. | 255 for each parameter. | 255 for each parameter. | 255 for each parameter. |
| MAX_SIZE_CHIP_LIST | Maximum number of chips allowed per standalone message. | 11 | 11 | 11 |
| MAX_SIZE_POSTBACK_DATA | The maximum permitted size for the postbackData field. The limit is 400 characters for API requests and 120 characters for UI inputs. | 1800 (Recommendation to use from Carrier is <=500 Characters). | 120 | 2048 |
| MAX_SIZE_RICHCARD_TITLE | Title field for Rich card. A maximum of 200 characters is supported for Rich card and Carousel. | 200 | 200 | 200 |
| MAX_SIZE_RICHCARD_DESCRIPTION | Description field for Rich Card. A maximum of 2000 characters is supported for Rich card and Carousel. | 2000 | 2000 | 2000 |
| MAX_SIZE_EVENT_TITLE | Maximum number of characters allowed for Calendar field. | 200 | 2048 | 200/2048 |
| MAX_SIZE_EVENT_DESCRIPTION | Maximum number of characters allowed for Event description field. | 2000 | 2048 | 2000/2048 |
| MAX_SIZE_LOCATION_LABEL | Maximum number of characters allowed for Display text, that is available in locationAction > label. | 200 | 200 | 200 |
| MAX_SIZE_LOCATION_QUERY | Maximum number of characters allowed for Description text, that is available in locationAction > query. | 2000 | 2000 | 2000 |
| MIN_SIZE_CAROUSEL_CARDS | Minimum required carousel cards in a carousel message. | 2 | 2 | 2 |
| MAX_SIZE_CAROUSEL_CARDS | Maximum number of allowed carousel cards in a carousel message. | 10 | 10 | 10 |
| MAX_SIZE_URL | Maximum length in characters of a Clickable links in RCS payload. | 4000 | 2048 | 4000 |
| MAX_SIZE_CHIP_LIST_IN_CARD | Maximum allowed number of Carousel message per rich card. | 4 | 4 | 4 |
| MAX_SIZE_CHIP | Chip title. A maximum of 25 characters is supported for the Chip title. | 25 | 25 | 25 |