Skip to main content

Channel Features

Each channel has its own characteristics, features and limitations. When responding, you can either use the common set of features supported across all channels, or tailor your response based on the specific channel of the current request.

1. Channels and Message Types​

Depending on the channel used, some message types may not be supported by the Conversation API. The table below shows which message types are compatible with which channel.

Message Type / ChannelSMSWhatsAppRCSTelegramFacebookInstagramEmailWeb Push
Text Message✓✓✓✓✓✓--
Picture-✓✓✓✓✓--
Audio-✓✓✓✓✓ *--
Video-✓✓✓✓✓ *--
File-✓✓ *✓✓✓ *--
Card-✓✓✓ *✓✓--
Carousel--✓✓ *✓✓--
Contact-✓✓ *✓✓ *✓ *--
Location-✓✓ *✓✓ *✓ *--
Template-✓------

* This message type is not natively supported by the channel, but it's rather emulated using other message types.

2. Channels and Button Types​

Depending on the channel used, some button types may not be supported. The table below shows which button types are compatible with which channel.

Button Type / ChannelSMSWhatsAppRCSTelegramFacebookInstagramEmailWeb Push
Reply-✓✓✓ [2]✓✓--
URL-✓ [1]✓✓ [3]✓✓--
Dial--✓-✓---
Compose--------
Location--✓✓ [4]✓ [4]✓ [4]--
Calendar--✓-----

[1] only for templates, 2 buttons max.
[2] not possible in carousel.
[3] emulated in carousel.
[4] emulated as URL.

3. Channels Features Limitation​

The table below shows the channels features limitation regarding maximum text length, maximum file size, supported file types, etc.

Feature / ChannelSMSWhatsAppRCSTelegramFacebookInstagramEmailWeb Push
Max Text Length918 (GSM characters) or 402 (UCS characters)
  • 4096
  • only 1024 if buttons are present
30724096
  • 2000
  • only 640 if buttons are present
1000--
Max Image Size (bytes)-2621440010485760052428802621440026214400--
Max Thumb Image Size (bytes)--102400204800----
Max Video Size (bytes)-16777216104857600209715202621440026214400--
Max Audio Size (bytes)-16777216104857600209715202621440026214400--
Max File Size (bytes)-104857600104857600209715202621440026214400--
Max Card File (img) Size (bytes)-524288010485760052428802621440026214400--
Max Buttons in a Card-34-33--
Max Card Title Length-60200-8080--
Max Card Description Length-102420001024 title+desc+btn txt8080--
Max Cards in Carousel--11101010--
Max Button Caption Length-2025-2020--
Supported Image File Types-
  • png (image/png)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • png (image/png)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • gif (image/gif)
  • png (image/png)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • png (image/png)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • gif (image/gif)
  • png (image/png)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • gif (image/gif)
--
Supported Video File Types-
  • mp4 (video/mp4)
  • 3gp (video/3gp)
  • mp4 (video/mp4)
  • mp4 (video/mp4)
  • mp4 (video/mp4)
  • mp4 (video/mp4)
--
Supported Audio File Types-
  • mp3 (audio/mpeg)
  • ogg (audio/ogg)
  • mp3 (audio/mpeg, audio/mpeg3, audio/x‑mpeg‑3, audio/mp3)
  • mp3 (audio/mpeg, audio/mpeg3, audio/x‑mpeg‑3, audio/mp3)
  • mp3 (audio/mpeg, audio/mpeg3, audio/x‑mpeg‑3, audio/mp3)
  • mp3 (audio/mpeg, audio/mpeg3, audio/x‑mpeg‑3, audio/mp3)
--
Supported File (document) Types-
  • txt (text/plain)
  • pdf (application/pdf)
  • doc (application/msword)
  • docx (application/vnd.openxmlformats‑officedocument.wordprocessingml.document)
  • xls (application/vnd.ms‑excel)
  • xlsx (application/vnd.openxmlformats‑officedocument.spreadsheetml.sheet)
  • zip (application/zip)
  • pdf (application/pdf)
  • zip (application/zip)
  • pdf (application/pdf)
  • gif (image/gif)
  • pdf (application/pdf)
  • doc (application/msword)
  • docx (application/vnd.openxmlformats‑officedocument.wordprocessingml.document)
  • xls (application/vnd.ms‑excel)
  • xlsx (application/vnd.openxmlformats‑officedocument.spreadsheetml.sheet)
  • csv (text/csv)
  • txt (text/plain)
  • pdf (application/pdf)
  • doc (application/msword)
  • docx (application/vnd.openxmlformats‑officedocument.wordprocessingml.document)
  • xls (application/vnd.ms‑excel)
  • xlsx (application/vnd.openxmlformats‑officedocument.spreadsheetml.sheet)
  • csv (text/csv)
  • txt (text/plain)
--
Supported Card File Types-
  • png (image/png)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • mp3 (audio/mpeg)
  • ogg (audio/ogg)
  • mp4 (audio/mp4, video/mp4)
  • 3gp (video/3gp)
  • txt (text/plain)
  • pdf (application/pdf)
  • doc (application/msword)
  • docx (application/vnd.openxmlformats‑officedocument.wordprocessingml.document)
  • xls (application/vnd.ms‑excel)
  • xlsx (application/vnd.openxmlformats‑officedocument.spreadsheetml.sheet)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • png (image/png)
  • mp4 (video/mp4)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • png (image/png)
  • mp4 (video/mp4)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • png (image/png)
  • jpg (image/jpg)
  • jpeg (image/jpeg)
  • png (image/png)
--