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.mp4Aspect ratios: prefer 9:16 (vertical) or 16:9 (horizontal) — odd aspect ratios get letterboxed.