Skip to content
Splashify Pro
Docs

Send Video Message

Send a video to a customer with an optional caption. The video must be reachable at a public HTTPS URL.

Endpoint

POST

https://api.splashifypro.com/api/v1/public/message

Headers

Request body

json
{
  "phoneNumber": "919876543210",
  "callbackData": "promo_drop",
  "type": "Video",
  "data": {
    "message": "This is a test",
    "mediaUrl": "https://your-cdn.example.com/promo.mp4",
    "fileName": "Test"
  }
}

Example

bash
curl -X POST https://api.splashifypro.com/api/v1/public/message \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "919876543210",
    "callbackData": "some_callback_data",
    "type": "Video",
    "data": {
      "message": "This is a test",
      "mediaUrl": "MEDIA_URL",
      "fileName": "Test"
    }
  }'

Successful response — 201 Created

json
{
  "result": true,
  "message": "Message queued for sending via Splashify Pro. Check webhook for delivery status",
  "id": "cc311ce6-4a31-4b50-b9e9-186357cd6fdf"
}

Error — 400 Bad Request

json
{
  "result": false,
  "message": "Please correct the following error - Customer has not messaged within last 24 hours"
}

Encoding tips

WhatsApp is strict about codecs. If a video that looks fine in your browser fails on WhatsApp:

bash
# Re-encode to H.264 baseline + AAC, faststart for streaming playback
ffmpeg -i input.mov \
  -vcodec libx264 -profile:v baseline -level 3.0 -pix_fmt yuv420p \
  -acodec aac -ac 2 -b:a 128k \
  -movflags +faststart \
  -r 30 -y output.mp4

Aspect ratios: prefer 9:16 (vertical) or 16:9 (horizontal) — odd aspect ratios get letterboxed.