Carousel
The carousel feature allows you to display available bot options attractively to the user. Each option can include:
- Image: .jpg or .png format with dimensions of 955×500 px for rectangular images or 955×955 px for square images,
- Title,
- Description,
- URL,
- Button.
Additionally, you can place quick replies below the carousel to present additional options. More information about quick replies can be found here.
Limits
The character limits and the number of tiles in a carousel vary depending on the platform where the carousel is added.
Web widget:
- Up to 10 elements in the carousel,
- Title up to 80 characters,
- Description up to 80 characters,
- Up to 3 buttons per tile.
Messenger and Instagram:
- Up to 10 elements in the carousel,
- Title up to 20 characters,
- Description up to 80 characters,
- Up to 3 buttons per tile.
Each element should have at least a title and one of the following: image, description, URL, or button.
The carousel is not available on WhatsApp.
Managing carousels
Adding a carousel
To add a carousel, choose “Carousel” from the “Add element to block” section.
After click
You can add up to 3 buttons to each tile in the carousel. Each button can perform one of the following actions. Buttons can also be hidden, and actions and NLP can be added to them, similar to the buttons in messages with buttons (more information on button actions here).
Go to block
For this button, the user will be shown the block specified in the configuration. During configuration, you can use an existing block or create a new block from this view.
Call
The user will initiate a phone call to the phone number specified in the configuration or stored in a variable.
Remember to set the correct country code prefix for manually entered phone numbers.
URL
The user will be redirected to the specified webpage, which can be opened at 100%, 70%, or 40% of the screen height.
Remember to provide the full URL address, including https://.
Go to next item “Next”
The user will be shown the next element of the current block.
Go to Messenger Webview
The user will have a web page opened without leaving the Messenger conversation, with capabilities such as downloading user IDs, closing the page at a specified time, etc. (more information available here).
Go to block stored in the variable
The user is redirected to a block stored in a user variable, meaning different users may be directed to different blocks.
The most commonly used variables for this case are {{last_visited_block_id}} and {{last_shown_block_id}}.
Visibility of carousel tiles
Each tile in the carousel can be displayed to a specific group of users. To use this feature, hover over the selected tile – an icon will appear in the top left corner. Click on it to open the conditions window. You need to activate the “Show when condition is met” option and select the condition that must be met for the user to see the tile.
[gif]
Available options include:
- User Variable – tile will be shown only to users for whom the variables have the specified values.
- Active Contest – tile will be displayed only when there is an active contest for the bot.
- Time Range – tile will be visible only during the specified period.
- Recurring date – tile will be shown only on specified days of the week within the chosen time range.
A tile can also be hidden for all users, which is useful when you want to temporarily disable a part of the scenario without removing it from the bot structure.
When we have added 10 tiles to the carousel, but one of them is hidden or set with conditions that allow it to be displayed only to specific individuals, we have the option to add another tile. If a given user meets the conditions to view all tiles and there are more than 10, the system will automatically shorten the carousel to the first 10 tiles.
Deleting tiles
To delete an individual tile from the carousel, hover your mouse cursor over it – a trash can icon will appear above the tile. Click on it and confirm the action to delete the tile.