​
Overview

Here’s a breakdown of how WhatsApp treats data it receives from Botpress:
Botpress TypeWhatsApp Type
textText Object
text with MarkdownText Object
imageMedia Image Object
audioMedia Audio Object
videoMedia Video Object
fileMedia File Object
locationLocation Object
Some data types have restrictions in WhatsApp:

​
Choices

Choices in Botpress are mapped to Interactive Objects of the type list in WhatsApp. WhatsApp renders choices differently depending on how many choices you specify in Botpress:
Amount of Choices in BotpressHow They’re Rendered in WhatsApp
1-3Buttons
4-10Dropdown
11 or MoreMultiple dropdowns (up to 10 choices each)

​
Labels

In WhatsApp, choices require a label. Since Botpress Studio doesn’t currently support labels for choice Cards, WhatsApp uses “Choose…” by default.

​
Character Limit

In WhatsApp:
  • Button titles are limited to 19 characters
  • Dropdown choice titles are limited to 23 characters
If a title exceeds the limit, WhatsApp will automatically shorten it:
Title in BotpressWhatsApp ButtonWhatsApp Dropdown
”This is a title in Botpress""This is a title in …""This is a title in Botp…”

​
Cards

Cards in Botpress are mapped to Interactive Objects of the type list in WhatsApp. WhatsApp only supports one link (label and URL) on a Card. If your Botpress Card has multiple links, WhatsApp will split them into multiple empty Cards.

​
Reply Button

WhatsApp only supports 3 “reply” action buttons on a Card. If your Botpress Card has more than three of these buttons, WhatsApp will split them into multiple Cards.

​
Stickers

WhatsApp will treat an image as a Sticker if it meets the following conditions:
  • The image is in WebP format
  • The image is exactly 512x512 in size
  • The image is less than 512kb
If the image doesn’t meet these conditions, the message won’t be sent and a warning will be emitted.

​
Files

When sending a file to WhatsApp, the file’s name will be changed to whatever is specific in the Title field of the Send Message Card. If you leave Title field blank, the file will be renamed with a generic name (“file”) before being sent to WhatsApp. The WhatsApp message will still display the original file’s name below the file itself.
You can also set a custom file name by sending the file using an Execute Code Card and specifying a value for the filename attribute.

​
Carousels

WhatsApp doesn’t natively support Carousels. If the bot sends a Carousel, WhatsApp will display each of its Cards in separate messages.