RASL
RASL | DashboardContact
RASL | DashboardContact
Instagram
  1. Messages
RASL
  • Introduction
  • Messages
    • Overview
    • Message Bot Management
      • List Message Bots
      • Get Message Bots Details
    • Send Simple Message
      POST
    • Send Media Message
      POST
  • Templates
    • Overview
    • Template Management
      • Template Bot
        • List Template Bots
        • Get Template Bots Details
      • List Templates
      • Get Template Details
    • Send Authentication Template
      POST
    • Send Template Message
      POST
  • Contacts
    • Overview
    • Create a New Contact
      POST
    • List Contacts
      GET
    • Get Contact Details
      GET
    • Update Contact Information
      PUT
    • Delete Contact
      DELETE
  • Groups
    • Overview
    • Create Group
      POST
    • List Groups
      GET
    • Get Group Details
      GET
    • Update Group
      PUT
    • Delete Group
      DELETE
  • Statuses
    • Overview
    • Create Status
      POST
    • List Statuses
      GET
    • Get Status Details
      GET
    • Update Status
      PUT
    • Delete Status
      DELETE
  • Sources
    • Overview
    • Create Source
    • List Sources
    • Get Source Details
    • Update Source
    • Delete Source
  • Integrations
    • N8N Webhook Integration
    • Webhook Format Reference
    • eCommerce Webhook Integration
      • Webhook Listener
      • WooCommerce Webhook Setup
RASL | DashboardContact
RASL | DashboardContact
Instagram
  1. Messages

Send Media Message

POST
https://getrasl.io/api/v1/{tenant-name}/messages/media
Send a media message (image, document, video, audio) with optional text to a specific phone number via WhatsApp
Optionally creates a contact if it doesn't exist
📌
Important | 24-Hour Customer (Service Window)
Media messages are subject to Meta's customer service window policy, similar to text messages. You can only send media messages within 24 hours of the customer's last message to your business. This window starts or refreshes whenever the customer messages or calls you. After this 24-hour window expires, the media message will not be delivered. Use approved template messages instead for communication beyond the 24-hour window.

File Size Limits:#

Images: Max 5MB (JPEG, PNG, WebP)
Videos: Max 16MB (MP4, 3GPP)
Audio: Max 16MB (MP3, AAC, AMR, OGG)
Documents: Max 100MB (PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT)

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Header Params

Body Params multipart/form-dataRequired

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://getrasl.io/api/v1//messages/media' \
--header 'Authorization: Bearer <token>' \
--form 'phone_number=""' \
--form 'media_type=""' \
--form 'media_url=""' \
--form 'media_file=@""' \
--form 'caption=""' \
--form 'filename=""' \
--form 'contact=""'

Responses

🟢200Success
application/json
Body

Example
{
  "status": "success",
  "message": "Media message sent successfully",
  "data": {
    "message_id": "wamid.HBgMOTE5ODEwNjAwMDAwFQIAERgSNUU1RjE4MUM0QjY5MjFFNzYzAA==",
    "contact_id": 15,
    "phone": "+201XXXXXXXXX",
    "media_type": "image",
    "media_url": "https://cdn.pixabay.com/photo/2015/01/07/15/51/woman-591576_1280.jpg",
    "caption": "Check out our latest product catalog! 📱",
    "filename": null,
    "status": "sent",
    "sent_at": "2024-02-08 14:30:25",
    "chat_id": 8,
    "contact_created": true,
    "file_size_mb": 2.3
  }
}
🟠400Bad Request
🟠401Unauthenticated
🟠403Conversation Limit Reached
🟠422Validation Errors
🔴500Whatsapp Api Error (Meta)
Previous
Send Simple Message
Next
Overview
Built with