Message types and samples

👍

Please see Messaging API for the full API reference.

Text Message

Content: Text only
Character Limit: Up to 3072 characters

Use Cases: OTP codes, simple alerts

Payload sample

{
    "user": {
        "msisdn": "+10000000000"
    },
    "type": "Text",
    "content": {
        "text": ":wave: Hi Sarah! Just a reminder—your appointment at Wellness Dental is scheduled for tomorrow at 10:30 AM"
    }
}

The corresponding message the user will receive:

Sending a Rich Media Message

• Media Types Supported: Images, videos, documents
• File formats: .ogx, .pdf, .aac, .mp3, .mpeg, .mp3, .mp4, .mp4, .3gp, .jpeg, .jpg, .gif, .png, .h263, .m4v, .mp4, .mp4, .mpeg, .webm
• Text Caption: Up to 2,000 UTF-8 characters
• File Size Limits: 100MB
• File URL limit: 2,048 characters
• 
  

Image & text

{
    "user": {
        "msisdn": "+10000000000" 
    },
    "type": "Image",
    "content": {
        "url": "https://www.example.com/image.jpg",
        "text": "Hi Suzie! Meet Bruno :feet:—one of the many pups looking for a loving home. Every small donation helps us feed, shelter, and care for dogs like him."
    }
}

The corresponding message the user will receive:

Video & text

{
    "user": {
        "msisdn": "+10000000000"
    },
    "type": "Video",
    "content": {
        "url": "https://www.example.com/video.mp4",
        "text": "Hi Suzie! Meet Bruno :feet:—one of the many pups looking for a loving home. Every small donation helps us feed, shelter, and care for dogs like him."
    }
}

The corresponding message the user will receive:

Audio & text

{
    "user": {
        "msisdn": "+10000000000" 
    },
    "type": "Audio",
    "content": {
        "url": "https://www.example.com/video.mp4",
        "text": "Hi There, this is a Sample RCS Audio Message"
    }
}

The corresponding message the user will receive:

File & text

{
    "user": {
        "msisdn": "+10000000000" 
    },
    "type": "Text",
    "content": {
        "url": "https://example.com/links/Invoice-october-2025.pdf",
        "text": "Hey John! Here’s your monthly invoice for October. Contact our team if you have any questions. Thank you"
    }
}

The corresponding message the user will receive: