Langsung ke konten utama
POST
Kirim Video

Otorisasi

Authorization
string
header
wajib

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Header

X-Device-Id
string

Pengenal perangkat untuk dukungan multi-device. Wajib jika beberapa perangkat terdaftar. Jika hanya satu perangkat terdaftar, perangkat tersebut digunakan sebagai default. Dapat juga diberikan sebagai parameter kueri device_id.

Contoh:

"my-device-id"

Body

multipart/form-data

Field opsional untuk menjadwalkan pesan alih-alih mengirimnya sekarang. Tetapkan scheduled_at untuk menjadwalkan; tanpanya, pesan langsung dikirim. Worker latar belakang mengirimnya pada waktu yang dijadwalkan, dengan mencoba ulang selama perangkat offline atau belum login. Media yang diunggah disimpan di server hingga jadwal selesai. Dalam body multipart/form-data, kirim weekdays sebagai field berulang (weekdays=1, weekdays=3).

scheduled_at
string<date-time>

Waktu pengiriman pertama dalam format RFC3339. Harus di masa mendatang. Pengiriman pertama selalu terjadi pada waktu ini, meskipun berada di luar weekdays atau day_of_month; keduanya mengatur pengulangan berikutnya.

Contoh:

"2026-10-01T09:00:00+07:00"

timezone
string

Zona waktu IANA yang digunakan untuk menghitung eksekusi berulang. Wajib saat scheduled_at ditetapkan.

Contoh:

"Asia/Jakarta"

recurrence
enum<string>
default:once

Frekuensi pengulangan pengiriman

Opsi yang tersedia:
once,
daily,
weekly,
monthly
weekdays
integer[]

Hari pengiriman, 0=Minggu hingga 6=Sabtu. Wajib saat recurrence bernilai weekly.

Rentang yang diperlukan: 0 <= x <= 6
Contoh:
day_of_month
integer

Tanggal pengiriman dalam bulan, dibatasi hingga hari terakhir bulan tersebut. Wajib saat recurrence bernilai monthly.

Rentang yang diperlukan: 1 <= x <= 31
Contoh:

15

end_at
string<date-time>

Hanya untuk pengulangan. Tidak ada pengiriman setelah waktu ini; harus setelah scheduled_at.

Contoh:

"2026-12-31T23:59:59+07:00"

occurrence_limit
integer

Hanya untuk pengulangan. Berhenti setelah jumlah pengiriman ini.

Rentang yang diperlukan: x >= 1
Contoh:

10

phone
string

Nomor telepon dengan kode negara

Contoh:

"6289685028129@s.whatsapp.net"

caption
string

Keterangan yang akan dikirim

Contoh:

"ini contoh caption video"

mentions
string[]

Daftar nomor telepon yang akan disebut (ghost mention - tidak memerlukan @ dalam keterangan). @phone dalam keterangan juga akan disebut. Gunakan kata kunci khusus "@everyone" untuk menyebut semua peserta grup. Kirim satu field formulir mentions untuk setiap entri.

Contoh:
reply_message_id
string

ID pesan yang ingin Anda balas

Contoh:

"3EB089B9D6ADD58153C561"

view_once
boolean

Sekali lihat

Contoh:

false

video
file

Video yang akan dikirim

video_url
string

URL video yang akan dikirim

Contoh:

"https://example.com/sample.mp4"

compress
boolean

Kompres video

Contoh:

false

hd
boolean

Kirim video definisi tinggi H.264 8-bit YUV 4:2:0 pada CRF 23, dengan ukuran maksimal 1280x1280 sambil mempertahankan rasio aspek dan tanpa memperbesar resolusi. Mengesampingkan compress jika true.

Contoh:

true

gif_playback
boolean

Tampilkan video sebagai GIF (berulang, tanpa suara, diputar otomatis)

Contoh:

false

duration
integer

Durasi pesan sementara dalam detik. Nilai yang diizinkan: 0 (tanpa kedaluwarsa), 86400 (24h), 604800 (7d), 7776000 (90d).

Contoh:

86400

is_forwarded
boolean

Apakah ini pesan yang diteruskan

Contoh:

false

allow_reshare
boolean

Tampilkan tombol bagikan ulang kepada pemirsa status. Mengharuskan phone bernilai status@broadcast; GOWA menolak field ini untuk penerima lainnya.

Contoh:

false

Respons

OK

code
string
Contoh:

"SUCCESS"

message
string
Contoh:

"Success"

results
object