Supported Media Sending - WhatsApp Cloud

Nádia Dias Updated by Nádia Dias

Supported Media Sending - WhatsApp Cloud

Below, you will find the supported limits on WhatsApp Cloud for each media type.

Supported Media Types:

Tipo de mídia

Extensão

Tipos de mídia compatíveis (MIME Type)

Tamanho

audio

.aac

.amr

.mp3

.m4a

.ogg

audio/aac

audio/amr

audio/mpeg

audio/mp4

audio/ogg (OPUS codecs only; base audio/ogg not supported.)

16 MB

document

.txt

.xls

.xlsx

.doc

.docx

.ppt

.pptx

.pdf

text/plain

application/vnd.ms-excel

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

application/msword

application/vnd.openxmlformats-officedocument.wordprocessingml.document

application/vnd.ms-powerpoint

application/vnd.openxmlformats-officedocument.presentationml.presentation

application/pdf

100 MB

image

.jpeg

.png

image/jpeg

image/png

5 MB

Animated sticker

Static sticker

.webp

.webp

image/webp

image/webp

500 KB

100 KB

video

.3gp

.mp4

video/3gp

video/mp4

Observações:

  • Apenas o codec de vídeo H.264 e o codec de áudio AAC são compatíveis.
  • Aceitamos vídeos com stream de áudio único ou sem stream de áudio.

16 MB

Media sent through messages is stored on WhatsApp's servers for 14 days. If a user requests to download the media after this period, WhatsApp servers will request the same media file from the local WhatsApp Business client. If the media has been removed, the user will be notified that it is unavailable.

It is not safe to assume that the download was completed solely based on delivery and read receipts. In general, media sent can be removed after 30 days, but it is important to adopt the strategy that best suits your company.

​

Restrictions

If you use the media upload process instead of a link to the media URL, the file must be uploaded to the media volume. Once the upload is complete, send a message using the media ID.

The application processes the uploaded media before it is sent to the server. The maximum media size that can be uploaded to the media node is 100 MB. However, there are post-processing limits for various media types, as described in the "Media size after processing" table mentioned earlier.

Media storage must be managed by the company. If the media volume reaches its limit, message sending will start to fail.

The following actions are not supported:

  • Sending media via byte streams.
  • Sending messages with animated stickers.

​

How to upload

Make a POSTrequest to /v1/media to upload the media. The body of the local request should contain the binary media data, and the Content-Type header must be set according to the type of media uploaded. Check the supported content types for accepted options.

Sending binary data in an POST HTTP request is the standard method for uploading binary data. For example, if you want to upload an image, send a POST request with the actual image bytes in the payload. Another option is to use --data-binary if you want cURL to read and use the file provided in binary exactly as it is.

Example

Media Upload:

POST /v1/media
Content-Type:

Media Upload with cURL:

curl -X POST \
https://:/v1/media \
-H 'Authorization: Bearer ' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @

In both cases, a successful response returns the id field

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

If you receive an error message, refer to Error Messages and Status for more details.

As you can see, videos and audio files have a maximum size limit of 16 MB. For example, if you upload a 20 MB video to the Weni Platform, the video will be saved on the platform, but at runtime, WhatsApp will not be able to send it. For documents, the maximum limit is 100 MB, but this does not work on the Weni Platform, as it only supports up to 32 MB.

You can find more about this information on the official META page

How did we do?

WhatsApp Template Messages: Impediments and Configurations

Contact