Carousel Card

POST

https://rest.qikberry.ai/v1/rcs/messages

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.

Request Example

Shell

JavaScript

Java

Swift

cURL

Carousel Rich CardCarousel Rich Card with variables

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

Response Example

200 - Success

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

Request

Header Params

Authorization

string

required

Example:

Bearer <ACCESS_TOKEN>

Content-Type

string

required

Example:

application/json

Body Params application/json

string

required

agentID

string

required

message

object

required

templateId

string

required

templateParams

object

required

Examples

Responses

🟢200Success

application/json

Body

message

string

required

data

array [object {3}]

required

messageId

string

optional

mobile

string

optional

charges

number

optional

🟠400Bad Request

🟠401Unauthorized

Stand Alone Card

Receiving Messages via Webhook