Carousel Card

A Rich card carousels are ideal for showcasing multiple items such as data plans or devices, allowing users to easily browse and compare different options within a single message.

Carousels combine multiple rich cards into a scrollable format, enabling users to compare items and engage with each card individually.

Carousel specifications

Element	Best Practice
Title	Catchy, under 100 characters, may include emojis for style
Description	Up to 500 characters, but best kept concise (~150–200 for UI fit)
Media	Use HTTPS, optimized image (JPG, PNG)
Suggestions	1–2 per card; include actionable text with a URL or postback

To avoid truncation, keep titles and descriptions as short as possible.

Just like with a standalone rich card, you can include suggestion chips below a carousel to guide the conversation forward.

curl --location --request POST 'https://rest.qikberry.ai/v1/rcs/messages' \ --header 'Authorization: Bearer <ACCESS_TOKEN>' \ --header 'Content-Type: application/json' \ --data-raw '{ "to": "<MOBILE>", "agentID": "<AGENT_ID>", "message": { "templateId": "<TEMPLATE_ID>", "templateParams": { "carouselParams": [ { "media": { "contentInfo": { "fileUrl": "<FILE_URL>", "fileName": "<FILE_TYPE>", "mimeType": "<MIME_TYPE>" } } }, { "media": { "contentInfo": { "fileUrl": "<FILE_URL>", "fileName": "<FILE_TYPE>", "mimeType": "<MIME_TYPE>" } } } ] } } }'

{ "message": "1 numbers accepted", "data": [ { "messageId": "a8XXXXXX-1bXX-4XXd-b5XX-5dXXXXXX:1", "mobile": "+9198XXXXXXXXX", "charges": 0.05 } ] }

Request

Responses