# Media message A media message is a message that features some kind of media other than text, such as images, documents, or video. You can send a media message by making a `POST` request to the `/messages:send` Conversation API [endpoint](/docs/conversation/api-reference/conversation/messages/) with the following payload: ```json { "app_id": "{APP_ID}", "recipient": { "identified_by": { "channel_identities": [ { "channel": "{CHANNEL}", "identity": "{IDENTITY}" } ] } }, "message": { "media_message": { "url": "{URL_TO_MEDIA}" } } } ``` ## Media message schema A media message can take the following parameters and properties. Required parameters are marked. Note: Not all channels support every parameter. The following sections give examples of how card messages are rendered in each channel and specific parameter support: - [WhatsApp](#whatsapp) - [SMS](#sms) - [Facebook Messenger](#facebook-messenger) - [Instagram](#instagram) - [MMS](#mms) - [RCS](#rcs) - [Viber Business Messages](#viber-business-messages) - [Telegram](#telegram) - [KakaoTalk](#kakaotalk) - [LINE](#line) - [WeChat](#wechat) ## WhatsApp WhatsApp channel natively supports media messages and will automatically detect what type of WhatsApp message to use. **Supported Media Types** In MediaMessage you can send the following media types: - image: image/.jpeg, image/.png (post-processing size limit of 5 MB) - video: video/.mp4, video/.3gpp (Only H.264 video codec and AAC audio codec is supported with a single audio stream, post-processing size limit of 16 MB) - document: any valid document MIME type (post-processing size limit of 100 MB) - audio: audio/.aac, audio/.mp4, audio/.amr, audio/.mpeg, audio/.ogg + codecs=opus (post-processing size limit of 16 MB, base audio/.ogg not supported) - sticker: image/.webp (post-processing size limit of 100 KB) Note that document media types support the `filename_override` parameter, which allows you to replace the original file name of the media with a new one. It will also indicate the file format to be displayed in WhatsApp. For example, you may want a PDF file to be displayed as a PDF attachment for the user, not as a generic document. The following image gives an example of a media message. ![Media Message with Image](/assets/whatsapp_media_message.3fe1b24019fe67804b1f3cf81ba0d4e25230fcf9d65028634b0e1f89674c7f5c.3a8dbadf.png) ## SMS SMS channel supports image-based media messages natively. The following image gives an example of media messages. ![Media Message](/assets/sms_media_message.bbf884d4386e64dbd82489bee87f789d6050dd99dadd3f2feedd225010064909.22f24fc4.png) ## Facebook Messenger Facebook Messenger supports media messages natively for the following media types: - image - video - audio - document The following image gives an example of a media message. ![Media Message with Image](/assets/messenger_media_message.f85a7fad4eb23cf863581a71187e23862eaaa1b8d002787debf864269f8a789e.46a24e6c.png) ## Instagram Instagram only supports image-based media messages natively. Supported formats are: `jpg`, `png`, `ico`, `bmp`. The image size should be than 8 MB. Note Until Instagram enables sending other types of media beyond images, we will transcode your "Media Message" as a “Text Message” with a plain text URL that points to the document/video file. The following image gives an example of a media message. ![Media Message](/assets/instagram_media.b617f0d12886a9055df5e17f3c0ac1aea233ce25c003f36f8853a8dbea6d8079.01afcbcc.png) ## MMS MMS supports media messages natively. The content of the media message will be validated when sending messages, and checked against the recommendations for MMS messages listed in the [MMS documentation](/docs/mms/bestpractices) if you use the [MMS_STRICT_VALIDATION](/docs/conversation/channel-support/mms/properties) flag. In this message you can send the following media types on MMS channel: - image: .jpg, .png (please observe that .jpg files have wider support on mobile devices than .png files) - video: .mp4, .gif, .mov - vCard (Virtual Contact File): .vcf - PDF files: .pdf We recommend you to keep media file sizes under 1MB as MMS providers usually use this limit. The following image gives an example of a media message. ![Media Message](/assets/mms_media_message.0eaabbdbec6faaa934ec59192e37f12d521733c729f04b472ac7df2d02ee1ee9.88839cbf.png) ## RCS RCS channel natively supports Media Messages. Send a media message by specifying the URL to the media. Conversation API will automatically detect what type of RCS message to use (image, video, audio, or PDF). Note the following: - When a mobile terminated (MT) media message is sent on the RCS channel of the Conversation API, the media located at the corresponding URL may be cached for up to 28 days. If you change the media stored at the URL, the new media may not be reflected in MT messages referencing that URL that are sent within that 28-day period. To force an update of the media cache, rename the file referenced by the URL. - [Specifying `filename_override`](/docs/conversation/api-reference/conversation/messages/messages_sendmessage#messages/messages_sendmessage/t=request&path=message&oneof=4/media_message/filename_override) is not supported for RCS media messages. - The maximum size of a media file that can be sent is 100MB. The following image gives an example of a media message. ![Image Media Message](/assets/rcs_media_message.bb3aa2f6f3674c234db19bd189d3df78d5218a3346cd41668b76cc442cefb235.94cf44a2.png) ## Viber Business Messages Viber Business Messages supports media messages natively. Supported image types: - .jpg - .jpeg - .png Supported document types: - .doc - .docx - .rtf - .dot - .dotx - .odt - .odf - .fodt - .txt - .info - .pdf - .xps - .pdax - .eps - .xls - .xlsx - .ods - .fods - .csv - .xlsm - .xltx Documents and media sent using media messages must be less than 200MB in size. When sending a video media message, the following additional requirements apply: - The thumbnail_url must be set. See the [media message schema](/docs/conversation/message-types/media-message#media-message-schema) for more information. - The thumbnail URL can be a maximum of 1000 characters. - The HTTP server that provides the video needs to set `Content-Length` in the HEAD response. - The video duration must be less than 600 seconds. The following image gives an example of a media message. ![Image Media Message](/assets/viberbm_media_message.ae152221fe44635cba83658f7ebcceef99706af3ffbfaedd3a37027a099ddc47.c734a361.png) ## Telegram Telegram Bot channel natively supports various type of media messages. - image: image/.jpeg, image/.jpg, image/.png ![png](/assets/telegram_android_photomessage.2b307031b6ad11ccdcbac573d209139cf6ced8a00ad11545002b0fc0f3bbc9c8.22cfd7e9.png) - Video: video/.mp4 ![mp4](/assets/telegram_android_videomessage.4ba3d65e4c88798f6d8df12ef45ddf7bfa4417f85b8f79ad0c00c8b36a53aa05.22cfd7e9.png) - Audio: audio/.mp3, audio/.m4a, audio/.ogg, audio/.ocg ![ogg](/assets/telegram_android_audiomessage.66e2c015eb636646093816e203240e63d31c50d098a3588fd959785553866aac.22cfd7e9.png) - File: application/.zip, application/.pdf ![zip](/assets/telegram_android_zipfilemessage.5297c2c353c16ea197d6c17553234e0e23432b4b08d80a90b4fe33611fe04ab3.22cfd7e9.png) ![pdf](/assets/telegram_android_pdffilemessage.0fd3418397582b9e4b142c045c3f6abe94602f482dd498b87a619bb83b8cf906.22cfd7e9.png) ## KakaoTalk The `KAKAOTALK` and `KAKAOTALKCHAT` channels support Media messages natively. When sending Media messages as AlimTalk Template messages or FriendTalk messages on the `KAKAOTALK` channel, the supported image media types are .png and .jpg. Media included in the Media message will be rejected by the channel if: - the width is below 500px, or if the 'width:length' ratio is below 2:1, or above 3:4 or if the image dimension is not equal to [800px * 600px] - image file format is different than JPG or PNG - file size is bigger than 500KB or for image with dimension [800px * 600px] is bigger than 2MB When sending Media messages as ConsultationTalk messages on the `KAKAOTALKCHAT` channel, the supported image media types are .gif, .png, and .jpg. Media included in the Media message will be rejected by the channel if: - file size is larger than 5MB ## LINE LINE channel natively supports various type of media messages. Media file URL must be HTTPS over TLS 1.2 or later. - Image formats: jpeg, jpg, png Max image file size: 10MB ![png](/assets/line_picture.5420b421b9433563b0a64c245b89ed4556e608bbfb0c845b9753053fbef030f6.7a4a72d5.jpg) - Video formats: mp4 Video thumbnail image is ***required*** (Tip: use a 1-pixel transparent image as the universal thumbnail) Max video file size: 200MB Max thumbnail image size: 1MB ![mp4](/assets/line_video.a1acdecd32aca85b9de15dddfa7698945645686a75fd987f778165f9b1df7d1e.7a4a72d5.jpg) - Audio formats: m4a Max audio file size: 200MB ![m4a](/assets/line_audio.65faf81e6208ec38b0f36c076122dbbecfc36a0e56a94aa651cc1a7c4d9847c3.7a4a72d5.jpg) ## WeChat WeChat channel natively supports various types of media messages. - Image formats: jpeg, jpg, png, gif Max image file size: 10MB ![png](/assets/wechat_image.dda61836b724b6aba193bb49050f53de30ba1bd9eb75f9dcc03b3a7a821c41cd.5b7624f8.png) - Video formats: mp4 Max video file size: 10MB ![mp4](/assets/wechat_video.e920e2f0a79e3efd3944af5e5bf3a4ae5e3626f1f9d5a6a3b84ff00776a001ce.5b7624f8.png) - Audio formats: mp3/amr Max audio file size: 2MB Max audio duration: 60s ![m4a](/assets/wechat_audio.07eab8f22f44dd0a831f848c393012b58d716fbe9184a8dcb61a46e31227f3f6.5b7624f8.png)