RCS media messages

A media message sends a standalone attachment: an image, video, audio file or PDF. Unlike a rich card, it has no structured layout and no built-in buttons. Use it for contracts, invoices, tickets, personal voice messages, audio guides and demo videos.

Supported formats

Type

MIME types (extensions)

Image

image/jpeg (.jpeg, .jpg), image/gif (.gif), image/png (.png)

Video

video/mp4, video/mpeg, video/mpeg4, video/m4v, video/h263, video/webm

Audio

audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp

Document

application/pdf

Other

application/ogg (.ogx)

Limits

  • Maximum 100 MiB per file.

  • All media and PDF attachments in one message together may not exceed 100 MiB.

  • Images and videos need a mediaHeight of small, medium or tall. PDF and audio do not.

Send a media message in the Campaigns app

  1. Create a new RCS campaign and choose the media message type.

  2. Select the attachment type: Image, Video, Audio or Document.

  3. Click Upload and choose your file.

Audio plays directly inside the messaging app. The customer does not need a separate player.

Combine with other message types

Media messages do not have buttons, but you can send them together with other messages in one customer journey. For example, send a PDF followed by a rich card with a Questions? Call us button, or a product demo video followed by a carousel with purchase options.

API example (PDF)

JSON
"richContent": {
  "conversation": [{
    "media": {
      "mediaName": "contract",
      "mediaUri": "https://example.com/contract.pdf",
      "mimeType": "application/pdf"
    }
  }]
}

For images and videos, add mediaHeight.

E-learning video

For a walkthrough, watch the e-learning video on sending media messages.