Skip to content

Send messages

Send video

Send a video by passing a public HTTPS URL in video.link. WhatsApp fetches the asset server-side; you don’t upload anything through Kirim.

cURL
TypeScript SDK

curl -X POST \
  https://api.kirim.chat/v1/$PHONE_ID/messages \
  -H "Authorization: Bearer $KIRIM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "+628123456789",
    "type": "video",
    "video": {
      "link": "https://cdn.example.com/demo.mp4",
      "caption": "Demo singkat fitur baru"
    }
  }'

import { Kirim } from '@kirimdev/sdk'

const kirim = new Kirim({ apiKey: process.env.KIRIM_KEY! })
const phone = kirim.phoneNumbers(process.env.PHONE_ID!)

await phone.messages.send({
  messaging_product: 'whatsapp',
  to: '+628123456789',
  type: 'video',
  video: {
    link: 'https://cdn.example.com/demo.mp4',
    caption: 'Demo singkat fitur baru',
  },
})

Requirements

Field	Constraint
`video.link`	Public HTTPS URL; either `link` or `id` (not both)
`video.caption`	Optional, ≤ 1024 chars
Format	MP4 (H.264 + AAC), 3GPP
Max size	16 MB
Audio	Mandatory — silent videos may fail validation at Meta

See also