> For the complete documentation index, see [llms.txt](https://help.pickyassist.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pickyassist.com/setting-up-guide/setting-up-flow-builder/steps/send-carousel-message.md).

# Send Carousel Message

About Session Carousel Message

## Overview

Carousel Messages allow you to showcase multiple products, services, or other content in a horizontally scrollable format within a WhatsApp conversation. Each carousel card can contain an image, title, description, and interactive buttons.

Carousel Messages can be used in both [**Chatbot**](https://help.pickyassist.com/setting-up-guide/setting-up-flow-builder/fundamentals-must-read) **flows** and [**Connector**](https://help.pickyassist.com/setting-up-guide/setting-up-connector/introduction) **Messaging** to provide customers with multiple options and allow them to take contextual actions directly from the conversation.

**Key Features**

* Display multiple cards in a single WhatsApp message.
* Each card can have its own image, title, and description.
* Add interactive buttons to each card.
* Supports **URL buttons** for opening external web pages.
* Supports up to **2 Quick Reply buttons per card**.
* Quick Reply buttons can trigger contextual actions in a [Chatbot](https://help.pickyassist.com/setting-up-guide/setting-up-flow-builder/fundamentals-must-read) flow.
* Different cards can have different Quick Reply actions.
* Available in both [**Chatbot**](https://help.pickyassist.com/setting-up-guide/setting-up-flow-builder/fundamentals-must-read) **flows** and [**Connector**](https://help.pickyassist.com/setting-up-guide/setting-up-connector/introduction) **Messaging**.

## Configuring the Carousel Message

The **Send Carousel Message** block supports two types of carousels:

* **Product Carousel**
* **Media Carousel**

#### Message Body

The Message Body is the main introductory text displayed above the horizontally scrollable carousel cards. It provides context or instructions for the content presented in the cards.

This is a mandatory field and should be used to provide a brief introduction or relevant information before the customer views the carousel cards.

**Example**:

> "Hi Akash 👋\
> We have some exciting holiday packages for you. Explore the options below and choose a package to learn more."

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2Fw9ee05BDsLGmf8uQ6YCp%2Fimage.png?alt=media&amp;token=99acecdc-b0ff-4197-8cef-44ceb1f3a878" alt=""><figcaption></figcaption></figure>

#### Select Message Type

The Select Message Type option allows you to choose the type of carousel message you want to send. It provides two options:

1. **Media Carousel** - Select this option to create custom carousel cards using your own images or videos, card body messages, and interactive buttons such as Quick Replies or URL buttons.
2. **Product Carousel** - Select this option to showcase products directly from your WhatsApp Catalog.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FYH2pKbGqVUhq613tfg1B%2Fimage.png?alt=media&amp;token=d09d9dcd-1154-4324-8362-20fe0516be85" alt=""><figcaption></figcaption></figure>

### Media Carousel

The **Media Carousel** allows you to create custom carousel cards using your own media, content, and interactive actions. It is mainly useful for showcasing marketing content with images or videos, along with custom text and buttons on each card

Using the Media Carousel, you can configure each card separately with the desired **media** (image or video)**, card body message, Quick Reply buttons, or URL buttons** with a configured URL.

Each card can be configured with the following details

* Card Media
* Card Body Message
* Button Name
* Button URL
* Quick Replies

Media carousel type has different fields to configure;

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FWwXD5Mc9T6s48tLlJqUc%2Fimage.png?alt=media&amp;token=cacfa407-9c54-4769-ace3-4f35e06905b0" alt=""><figcaption></figcaption></figure>

#### **Card Configuration Mode**&#x20;

The **Card Configuration Mode** determines how the carousel cards are configured. You can either configure the cards **manually** or generate them **dynamically by mapping attributes**.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FhdgBxZy0gvM2sAfIziC2%2Fimage.png?alt=media&amp;token=5bf22054-58d7-4ec0-b686-245049b7e67d" alt=""><figcaption></figcaption></figure>

* **Send Cards Manually** - Select **Send Cards Manually** when you want to configure each carousel card individually. You can define the **media, card body message, and button details** for each card. This option is useful when you have a fixed set of cards that you want to display every time the flow is triggered.
* **Send Cards Dynamically** - Select **Send Cards Dynamically** when you want to generate carousel cards using **dynamic attributes** from your chatbot flow, CRM data, or any data available in **array format**. This option is useful when the card content needs to be updated dynamically based on the data available when the flow is executed. The carousel cards and their respective details are generated based on the values provided in the mapped dynamic attributes. Here you need to map each field with the neccessary attributes.

#### Select Button Type

The **Select Button Type** determines the type of interactive button available on each Media Carousel card.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2F4zCwNQJp8ftwFE4puFwB%2Fimage.png?alt=media&amp;token=0d9bfdf8-feb4-4619-b9a3-a0df11f616fc" alt=""><figcaption></figcaption></figure>

There are two options:

* **URL -** Use this option when you want customers to open an external webpage by clicking a button on the carousel card. When the customer clicks the button, the configured URL will open.
* **Quick Reply -** Use this option when you want customers to take contextual actions directly within the WhatsApp conversation without leaving the chat. Each Quick Reply can trigger a different action in the chatbot flow. When the customer clicks a Quick Reply button, the flow will follow the path configured for that specific Quick Reply.

{% hint style="info" %}
The interactive fields displayed under each card vary based on the selected button type
{% endhint %}

{% hint style="warning" %}
This Carousel messages can be sent only to contacts with an **active 24-hour WhatsApp customer service window/session**. If the contact does not have an active 24-hour session, you can use [**Carousel Message Templates**](https://help.pickyassist.com/setting-up-guide/connecting-channels/whatsapp-templates/template-types/carousel-templates#overview) to initiate the conversation and send carousel content.
{% endhint %}

### Cards

The **Cards** section allows you to add and configure the individual cards that will be displayed in the carousel. By default, **2 cards** are available, these default cards cannot be deleted and you can add additional cards as required, up to a maximum of **10 cards** in a Media Carousel.&#x20;

Each card can contain the following:

#### **Card Media**

Add the **image or video** that you want to display on the carousel card. The media provides the visual representation of the product, service, property, destination, or other content being showcased. This is a mandatory field.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FuGT8uRPLt94cfiIichmL%2Fimage.png?alt=media&amp;token=9324c50e-f71b-451f-b0fe-273f6e27d9ec" alt=""><figcaption></figcaption></figure>

* The card media must be either an **image or a video**.
* All cards in the same carousel must use the **same media type**. For example, if one card uses an image, all other cards must also use images. If one card uses a video, all other cards must use videos.
* You can add media directly or provide a **public media URL** instead. The option to enter a public media URL is available when you **hover over the Card Media field**.

#### **Card Body Message**

The Card Body Message is the text displayed below the media on the individual carousel card. Use this field to provide information specific to that card.

The maximum character limit is 160 characters.

#### **URL Buttons**

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FnHVFyMspkA6cujsIfhei%2Fimage.png?alt=media&amp;token=443911cb-4d21-4d9c-98e5-dfb6db0d34e7" alt=""><figcaption></figcaption></figure>

Here, you can enter a **Button Name** and configure the **URL** that will open when a customer clicks the button. The URL button fields are available only when **URL** is selected under **Select Button Type**. By default, this option is selected when adding a Carousel Message block.

For Example;

> **Card:** Goa Holiday Package\
> **Button Name:** View Package\
> **Button URL:** Your configured package webpage<br>
>
> When the customer selects the button, the configured webpage opens.

**Suitable use cases**

URL buttons are useful for:

* Product pages
* Property details
* Booking websites
* Brochures
* Landing pages
* External forms

#### **Quick Reply**

**Quick Reply** buttons allow you to take contextual actions directly within the WhatsApp conversation without requiring the customer to leave the chat.

Each Quick Reply can be configured to trigger a different action in the Chatbot flow. When the customer clicks a Quick Reply button, the flow follows the path configured for that specific Quick Reply.

Quick Replies are useful for creating interactive carousel experiences where the next step in the conversation depends on the customer's selection. You can add a maximum of **2 Quick Reply buttons** per carousel card. If a **second** Quick Reply button is added to any card, the second Quick Reply button will be applied to **all cards in the carousel**.

When **Quick Reply** is selected under **Button Type**, the URL button fields are replaced with the **Quick Reply Button Name** and **Card Value** fields.

* **Quick Reply Button Name -** Enter the text that will be displayed on the Quick Reply button in the customer's WhatsApp conversation.
* **Card Value** - Set a value to identify the selected card. This value can be saved as a runtime variable and used in subsequent steps of the flow.

Please find the sample image of a configured Carousel Message with Quick Reply

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2F7Wj9QqfA5UPMz8XE8sYH%2Fimage.png?alt=media&amp;token=ceca27bf-f2f9-4f25-9e11-86c705bf9586" alt=""><figcaption></figcaption></figure>

**Suitable use cases**

Quick Reply buttons in Carousel Messages are useful for:

* **Product selection and purchase actions**
* **Property enquiries and visit scheduling**
* **Travel package selection and booking**
* **Car selection and test-drive requests**
* **Course selection and enrolment**

For Example;

> **Card:** 2BHK Apartment\
> **Quick Reply 1:** Schedule Visit\
> **Quick Reply 2:** Get Details<br>
>
> Here "Schedule Visit" button can be configured with appointment detail collections in the flow and "Get Details" button can be configured with a **Send Message** blocks with the property details

A sample Carousel Message in Whatsapp with quick reply button is shown below;

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FljZ4uDoJbMH0L0WsWCBT%2Fimage.png?alt=media&amp;token=dba80abe-6091-44d6-8c91-9d5ca2896489" alt=""><figcaption></figcaption></figure>

### Product Carousel

The **Product Carousel** allows you to showcase products available in your WhatsApp Catalog as a carousel message. Each selected product is displayed as an individual card in the customer's WhatsApp conversation, along with the Product Name, Price, and View button.

When the customer clicks the View button, they can view the product details directly in WhatsApp and add the product to their cart. This makes the Product Carousel especially useful for businesses using Picky Assist's WhatsApp Ecommerce feature.

**Adding Products**

* Click Select Product to open the list of products available in your WhatsApp Catalog.
* Select the products you want to include in the carousel.
* A minimum of 2 products must be selected.
* To add more products after the initial selection, click Select More Products.
* You can add up to 10 products in a single Product Carousel message.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FmNvT98gWOyRu09kzxfym%2Fimage.png?alt=media&amp;token=1d56b92c-9837-4115-b907-090a4806c26b" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note: Only products available in the connected WhatsApp Catalog can be added to the Product Carousel.
{% endhint %}

### Carousel Message API

Carousel messages can also be sent directly through an **API request**, allowing you to send Media or Product Carousel messages without using a Chatbot flow. This is useful for integrating carousel messaging into your own applications or sending messages through tools such as Postman.

For API request parameters, payload structure, and responses, refer to the [**Carousel Message API Documentation**](https://help.pickyassist.com/api-documentation-v2/push-api/sending-carousel-message)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.pickyassist.com/setting-up-guide/setting-up-flow-builder/steps/send-carousel-message.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.