WhatsApp - Rich Media Limitations

<< Click to Display Table of Contents >>

Navigation:  Soprano Campaign Tools > WhatsApp Business Messaging Channel >

WhatsApp - Rich Media Limitations

Previous pageReturn to chapter overviewNext page

Based on the HTML builder option in WhatsApp Orders, various Rich Media content is available to be attached and sent to recipients.

However, there are certain restrictions that Users need to be aware of while attaching various media.

 

Below is a summary table, highlighting the same:

 

1. Any media content source URL MUST end with the correct extensions (.pdf,.jpg, .mp3 etc) as it is being picked up (as opposed to adding the extensions manually later). If not the messages will bounce.

 

For Example:

 

Right - https://123.audio

Wrong - https://123/audio

 

2. Uploading files can slow down the process of editing captions. It is advised to edit captions before selecting the file to  upload in some browsers like Chrome and IE.

 

3. Any order with .jpg/.png/.jpeg images with size > 2MB will bounce when sent via URL method (Awaiting comments from tyntec for their feedback).

 

4. .3gp/.ogg files when sent via Video/Audio template will fail (waiting for tyntec's feedback), but .3gp/.ogg files as document template are sent success.

 

5.  Max character limit on caption is 200 character, for more than 200 character BE alarms gets generated with InvalidSqlParameterExpecption.

 

6. Only H.264 encoded videos are compatible across all supported devices and browsers. MP3 is the only common audio format across supported devices/browsers : https://www.encoding.com/html5-video-codec/

 

7. Observe below table for whatsApp mail merge and multiple destination limitation:

 

Scenario

Template API-SMS(CGP)

Whatsapp API- text

Whatsapp API-Rich Media

Multiple Destination

Supported

Not supported : 400 bad request

Not supported : 400 bad request

Mail Merge

Supported

Supported with single destination

Not implemented

 

 

 

 

 

 

 

Media Type

File Formats

Browse-and-Upload Style Media

 

 

IE (as browser of choice)

Chrome (as browser of choice)

Comments

 

Using IE on an Android Device

Using IE on an iOS Device

Using IE on an Android Device

Using IE on an iOS Device

 

Image

.jpeg

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.png

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

Audio

.aac

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.mp4

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.amr

Considered an invalid source while using IE on an Android device

Considered an invalid source while using IE on an iOS device

Not supported while using Chrome on an Android device

Not supported while using Chrome on an iOS device

The HTML5 audio tag in the content builder doesn't support the format due to which the user wont be able to upload .amr file formats

.mpeg

Considered an invalid source while using IE on an Android device

Considered an invalid source while using IE on an iOS device

Not supported while using Chrome on an Android device

Not supported while using Chrome on an iOS device

 

.mp3

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.opus

Considered an invalid source while using IE on an Android device

Considered an invalid source while using IE on an iOS device

Not supported while using Chrome on an Android device

Not supported while using Chrome on an iOS device

 

.ogg

Considered an invalid source while using IE on an Android device

Considered an invalid source while using IE on an iOS device

File with sizes 1MB or higher, lag for 1 or 2 sec

File format is received but could not be played (no built in support for this codec)


Video

 

*For Videos, anything which is HTTP is not supported.

.mp4

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.3gp

Considered an invalid source while using IE on an Android device (Message is in a "bounced" state)

Considered an invalid source while using IE on an iOS device (Message is in a "bounced" state)

Not supported while using Chrome on an Android device

Not supported while using Chrome on an iOS device

 

Document

.txt

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.xls

.xls files uploaded successfully

.xls files uploaded successfully

.xls files uploaded successfully

.xls files uploaded successfully

 

.xlsx

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.pdf

.pdf files uploaded successfully

.pdf files uploaded successfully

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.csv

.csv files are uploaded successfully

.csv files are uploaded successfully

.csv files are uploaded successfully

.csv files are uploaded successfully

 

.ppt

.ppt files are uploaded successfully

.ppt files are uploaded successfully

.ppt files are uploaded successfully

.ppt files are uploaded successfully

 

.pptx

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.doc

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

.docx

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

File with sizes 1MB or higher, lag for 1 or 2 sec

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Media Codecs

File Formats

URL Based Attachment

 

 

IE (as browser of choice)

Chrome (as browser of choice)

Comments

 

Using IE on an Android Device

Using IE on an iOS Device

Using IE on an Android Device

Using IE on an iOS Device

 

Image

.jpeg

upto 2MB for .jpg/jpeg- passed via URL

 

.jpg/.jpeg files >2 MB via URL- fail

   upto 2MB for .jpg/jpeg- passed via URL

 

.jpg/.jpeg files >2 MB via URL- fail

Upto 2MB for .jpg/jpeg- passed via URL

 

.jpg/.jpeg files >2 MB via URL- fail

    upto 2MB for .jpg/jpeg- passed via URL

 

.jpg/.jpeg files >2 MB via URL- fail


.png

upto 2MB for .png passed via URL

 

.png files >2 MB via URL- fail

 upto 2MB for .png passed via URL

 

.png files >2 MB via URL- fail

 upto 2MB for .png passed via URL

 

.png files >2 MB via URL- fail

 upto 2MB for .png passed via URL

 

.png files >2 MB via URL- fail


Audio

.aac

.aac files uploaded successfully

.aac files uploaded successfully

.aac files uploaded successfully

.aac files uploaded successfully

 

.mp4

.mp4 files uploaded successfully

.mp4 files uploaded successfully

.mp4 files uploaded successfully

.mp4 files uploaded successfully

 

.amr

Not supported while using IE on an Android device

Not supported while using IE on an iOS device

Not supported while using Chrome on an Android device

Not supported while using Chrome on an iOS device

 

.mpeg

 

 

 

 

 

.mp3

 

 

 

 

.mp3 files with a file size of upto 5MB uploaded successfully via URL

.opus

 

 

 

 

 

.ogg

 

 

 

 

 

Video

 

*For Videos, anything which is HTTP is not supported.

.mp4

Uploaded successfully - Max limit of 10MB for .mp4 Files

Uploaded successfully - Max limit of 10MB for .mp4 Files

Uploaded successfully - Max limit of 10MB for .mp4 Files

Uploaded successfully - Max limit of 10MB for .mp4 Files


.3gp

To be consulted with Tyntec

To be consulted with Tyntec

To be consulted with Tyntec

To be consulted with Tyntec

Currently failing. Need to contact Tyntec support. I will ask @Jason Zhu

Document

.txt

.txt files uploaded successfully via URL

.txt files uploaded successfully via URL

.txt files uploaded successfully via URL

.txt files uploaded successfully via URL

 

.xls

.xls files uploaded successfully via URL

.xls files uploaded successfully via URL

.xls files uploaded successfully via URL

.xls files uploaded successfully via URL

 

.xlsx

.xlsx files uploaded successfully via URL

.xlsx files uploaded successfully via URL

.xlsx files uploaded successfully via URL

.xlsx files uploaded successfully via URL

 

.pdf

Uploaded successfully - Max limit of 32MB for PDF Files

Uploaded successfully - Max limit of 32MB for PDF Files

Uploaded successfully - Max limit of 32MB for PDF Files

Uploaded successfully - Max limit of 32MB for PDF Files

32MB for .pdf- passed via URL

.csv

 

 

Successfully sent via URL

Successfully sent via URL

 

.ppt

.ppt files successfully sent via URL

.ppt files successfully sent via URL

.ppt files successfully sent via URL

.ppt files successfully sent via URL

 

.pptx

.pptx files successfully sent via URL

.pptx files successfully sent via URL

.pptx files successfully sent via URL

.pptx files successfully sent via URL

 

.doc

.doc files successfully sent via URL

.doc files successfully sent via URL

.doc files successfully sent via URL

.doc files successfully sent via URL

 

.docx

.docx files successfully sent via URL

.docx files successfully sent via URL

.docx files successfully sent via URL

.docx files successfully sent via URL

 

 

 

WhatsApp - Template

 

WhatsApp - Preferences