Menu

Expand
Rate this page:

Guidance on WhatsApp Media Messages

With the Twilio API for WhatsApp, you can send images, video, text, and PDF files to create rich contextual conversations with your WhatsApp Users. This guide covers guidelines to follow when sending and receiving media messages through WhatsApp to ensure a smooth experience with your customers.

Media Content Types

To send a WhatsApp media message, you must specify the MediaUrl parameter when making a request to the Twilio API for WhatsApp. Twilio checks the content-type header at the provided MediaUrl to validate the content type of the media file. If the content-type header does not match that of the media file, Twilio rejects the request.

Message Size Limits

When you send an outbound WhatsApp message, the total message size must be under the maximum size limit for the channel. An API request with media or a collection of media larger than the size limit will fail with an error.

For a WhatsApp message, the maximum size limit is 16MB.

Supported MIME Types

The Twilio API for WhatsApp supports sending and receiving images, audio, PDF files, and video. The following formats are currently supported:

  • Images: JPG, JPEG, PNG
  • Audio: MP3, OGG, AMR
  • Documents: PDF
  • Video: MP4
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

        
        
        

        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more