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 with the following payload:

{
  "app_id": "{{APP_ID}}",
  "recipient": {
    "contact_id": "{{CONTACT_ID}}"
  },
  "message": {
    "media_message": {
      "url": "{{URL_TO_MEDIA}}"
    }
  }
}

The follow sections give examples of how media messages are rendered in each channel.

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
  • video: video/.mp4, video/.3gpp (Only H.264 video codec and AAC audio codec is supported with a single audio stream.)
  • document: any valid document MIME type
  • audio: audio/.aac, audio/.mp4, audio/.amr, audio/.mpeg, audio/.ogg + codecs=opus (base audio/.ogg not supported)
  • sticker: image/.webp

Any other media type will be sent as plaintext URL.

The following image gives an example of a media message.

Media Message with Image

SMS

SMS channel supports image-based media messages natively. The following image gives an example of media messages.

Media Message

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

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

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 if you use the MMS_STRICT_VALIDATION flag.

Note

You can also send vCards (Virtual Contact Files) with a URL that points to your .vcf file.

The following image gives an example of a media message.

Media Message

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 or video.

The following image gives an example of a media message.

Image Media Message

Viber Bot

Viber Bot channel natively supports media messages. The following image gives an example of media messages.

Media Message

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

The following image gives an example of a media message.

Image Media Message

Telegram

Telegram channel natively supports various type of media messages.

  • image: image/.jpeg, image/.jpg, image/.png
    png
  • Video: video/.mp4
    mp4
  • Audio: audio/.mp3, audio/.m4a, audio/.ogg, audio/.ocg
    ogg
  • File: application/.zip, application/.pdf
    zip pdf

Kakaotalk

Kakaotalk supports Media messages natively.

Note

Media messages on Kakaotalk only support .png and .jpg image media types.

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