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
mediaHeightof small, medium or tall. PDF and audio do not.
Send a media message in the Campaigns app
-
Create a new RCS campaign and choose the media message type.
-
Select the attachment type: Image, Video, Audio or Document.
-
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)
"richContent": {
"conversation": [{
"media": {
"mediaName": "contract",
"mediaUri": "https://example.com/contract.pdf",
"mimeType": "application/pdf"
}
}]
}
For images and videos, add mediaHeight.
Related
E-learning video
For a walkthrough, watch the e-learning video on sending media messages.