Media messages

One of the rich features that RCS Business Messaging provides is the media message. You can send a message with an image, PDF, audio, or video of your choice. For image and video, you also need to add the media height. This can be "small", "medium", or "tall".

File Size Limits

Individual file maximum: 100 MiB
Total message maximum: The combined size of all media and PDF attachments within a single message must not exceed 100 MiB

Supported Media Types

RCS for Business supports the following media types:

Media type	Extension
application/ogg	.ogx
application/pdf	.pdf
audio/aac	.aac
audio/mp3	.mp3
audio/mpeg	.mpeg
audio/mpg	.mp3
audio/mp4	.mp4
audio/mp4-latm	.mp4
audio/3gpp	.3gp
image/jpeg	.jpeg, .jpg
image/gif	.gif
image/png	.png
video/h263	.h263
video/m4v	.m4v
video/mp4	.mp4
video/mpeg4	.mp4, .m4p
video/mpeg	.mpeg
video/webm	.webm

Image message example

{
   "messages":{
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":""
            },
            "to":[
               {
                  "number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "media":{
                        "mediaHeight": "small",
                        "mediaName":"your-image",
                        "mediaUri":"https://www.your-image.jpg",
                        "mimeType":"image/jpeg"
                     }
                  }
               ]
            }
         }
      ]
   }
}

Video message example

{
   "messages":{
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":""
            },
            "to":[
               {
                  "number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "media":{
                        "mediaHeight": "small",
                        "mediaName":"your-video",
                        "mediaUri":"https://www.your-video.mp4",
                        "mimeType":"video/mp4"
                     }
                  }
               ]
            }
         }
      ]
   }
}

Document (PDF) message example

{
   "messages":{
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":""
            },
            "to":[
               {
                  "number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "media":{
                        "mediaName":"your-document",
                        "mediaUri":"https://www.your-document.pdf",
                        "mimeType":"application/pdf"
                     }
                  }
               ]
            }
         }
      ]
   }
}

Audio message example

{
   "messages":{
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":""
            },
            "to":[
               {
                  "number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "media":{
                        "mediaName":"your-audio",
                        "mediaUri":"https://www.your-audio.mp3",
                        "mimeType":"audio/mp3"
                     }
                  }
               ]
            }
         }
      ]
   }
}