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://apis.splashifypro.com/api/v1/public/message

Headers

Header	Value
`Authorization`	`Basic YOUR_API_KEY`
`Content-Type`	`application/json`

Request body


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

Field	Required	Notes
`phoneNumber`	yes	Recipient phone
`type`	yes	Must be `"Video"`
`data.message`	optional	Caption rendered below the video
`data.mediaUrl`	yes	Public HTTPS URL. Allowed: `video/mp4` (H.264 + AAC). Max 16 MB
`data.fileName`	optional	Display name

Example


curl -X POST https://apis.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`


{
  "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`


{
  "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:


# 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.