Qikberry API Docs
SMSWhatsapp Cloud API
RCS for BusinessVMNVerifyIntegrations
SMSWhatsapp Cloud API
RCS for BusinessVMNVerifyIntegrations
Qikberry.AI
App
  1. Interactive
  • Introduction
  • Catalog Messages
  • Payment Messages
  • Non-templates messages
    • Interactive
      • URL button
        POST
      • List buttons
        POST
      • Media carousel
        POST
      • Reply buttons
        POST
    • Address
      POST
    • Audio
      POST
    • Document
      POST
    • Contacts
      POST
    • Image
      POST
    • Location
      POST
    • Video
      POST
    • Text
      POST
  1. Interactive

Media carousel

POST
https://rest.qikberry.ai/v1/whatsapp/messages

Interactive Media Carousel Message#

An Interactive Media Carousel Message allows businesses to send multiple cards in a single WhatsApp message. Each card can contain media, text, and interactive buttons.
Common use cases:
Product catalogs
Offers and promotions
Service listings
carousel_url_btn_img.png
Carousel URL Button
carousel_quick_reply_btn_img.png
Carousel Quick Reply Button
Carousel Rules:
Supports 2 to 10 cards.
Each card requires an Image or Video header.
Card body text is optional.
Each card supports either one URL button or Quick Reply buttons.
All cards must use the same button type and count.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
The request was successfully accepted for processing. The response returns a confirmation message along with the unique message ID and the recipient's WhatsApp number.
Bodyapplication/json

đźź 401Unauthorized
đźź 400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://rest.qikberry.ai/v1/whatsapp/messages' \
--header 'x-phone-number: <WA_ID>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "to": "<USER_PHONE_NUMBER>",
    "type": "interactive",
    "interactive": {
        "type": "carousel",
        "body": {
            "text": "Of course! Here are three of our latest arrivals, each under $25:"
        },
        "action": {
            "cards": [
                {
                    "card_index": 0,
                    "type": "cta_url",
                    "header": {
                        "type": "image",
                        "image": {
                            "link": "<IMAGE_URL>"
                        }
                    },
                    "body": {
                        "text": "*Blue Echeveria*\n\nA rosette-shaped succulent with powdery blue leaves, perfect for brightening up any space."
                    },
                    "action": {
                        "buttons": [
                            {
                                "type": "quick_reply",
                                "quick_reply": {
                                    "id": "learn-blue-echeveria",
                                    "title": "Learn more"
                                }
                            },
                            {
                                "type": "quick_reply",
                                "quick_reply": {
                                    "id": "fav-blue-echeveria",
                                    "title": "Add to favorites"
                                }
                            }
                        ]
                    }
                },
                {
                    "card_index": 1,
                    "type": "cta_url",
                    "header": {
                        "type": "image",
                        "image": {
                            "link": "<IMAGE_URL>"
                        }
                    },
                    "body": {
                        "text": "*Zebra Haworthia*\n\nStriking white stripes on deep green leaves give this compact succulent a bold, modern look."
                    },
                    "action": {
                        "buttons": [
                            {
                                "type": "quick_reply",
                                "quick_reply": {
                                    "id": "learn-zebra-haworthia",
                                    "title": "Learn more"
                                }
                            },
                            {
                                "type": "quick_reply",
                                "quick_reply": {
                                    "id": "fav-zebra-haworthia",
                                    "title": "Add to favorites"
                                }
                            }
                        ]
                    }
                },
                {
                    "card_index": 2,
                    "type": "cta_url",
                    "header": {
                        "type": "image",
                        "image": {
                            "link": "<IMAGE_URL>"
                        }
                    },
                    "body": {
                        "text": "*Panda Plant*\n\nSoft, fuzzy leaves with chocolate-brown edges—adorable and easy to care for."
                    },
                    "action": {
                        "buttons": [
                            {
                                "type": "quick_reply",
                                "quick_reply": {
                                    "id": "learn-panda-plant",
                                    "title": "Learn more"
                                }
                            },
                            {
                                "type": "quick_reply",
                                "quick_reply": {
                                    "id": "fav-panda-plant",
                                    "title": "Add to favorites"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}'
Response Response Example
200 - SUCCESS
{
    "message": "1 numbers accepted",
    "data": [
        {
            "messageId": "<MESSAGE_ID>",
            "mobile": "<USER_PHONE_NUMBER>"
        }
    ]
}
Modified at 2026-07-29 10:59:08
Previous
List buttons
Next
Reply buttons
Built with