Kirim Pesan

Semua endpoint pengiriman berada di /api/whatsapp/send/*. Membutuhkan paket aktif dan minimal satu device yang sudah terhubung.

Field umum (berlaku untuk semua request pengiriman):

Field	Type	Required	Keterangan
`phone`	string	Ya	Nomor tujuan dengan kode negara, contoh: `628123456789`
`is_forwarded`	boolean	Tidak	Tandai pesan sebagai diteruskan
`duration`	number	Tidak	Durasi pesan hilang otomatis (detik)

Untuk kirim ke grup, gunakan Group JID sebagai nilai phone, contoh: 120363xxxxxxxx@g.us.

POST /api/whatsapp/send/message

Kirim pesan teks.

Request body (application/json atau multipart/form-data)

Field	Type	Required	Keterangan
`phone`	string	Ya	Nomor tujuan
`message`	string	Ya	Isi pesan
`reply_message_id`	string	Tidak	ID pesan yang ingin dibalas
`mentions`	string[]	Tidak	Nomor yang di-mention (ghost mention)

curl -X POST /api/whatsapp/send/message \
  -H "Content-Type: application/json" \
  -b "wa_token=<token>" \
  -d '{
    "phone": "628123456789",
    "message": "Halo! Terima kasih sudah menghubungi kami."
  }'

Response 200

{
  "code": 200,
  "results": {
    "message_id": "3EB0...",
    "status": "success"
  }
}

POST /api/whatsapp/send/image

Kirim gambar. Bisa dari file upload atau URL publik.

Request body (multipart/form-data)

Field	Type	Required	Keterangan
`phone`	string	Ya	Nomor tujuan
`caption`	string	Tidak	Keterangan gambar
`image`	file	*	File gambar (pilih salah satu dengan `image_url`)
`image_url`	string	*	URL gambar publik
`view_once`	boolean	Tidak	Kirim sebagai sekali lihat
`compress`	boolean	Tidak	Kompres sebelum kirim

curl -X POST /api/whatsapp/send/image \
  -b "wa_token=<token>" \
  -F "phone=628123456789" \
  -F "caption=Cek produk terbaru kami!" \
  -F "image=@/path/to/gambar.jpg"

POST /api/whatsapp/send/file

Kirim dokumen atau file (PDF, Excel, Word, dll).

Request body (multipart/form-data)

Field	Type	Required	Keterangan
`phone`	string	Ya	Nomor tujuan
`caption`	string	Tidak	Keterangan file
`file`	file	*	File yang dikirim
`file_url`	string	*	URL file publik

curl -X POST /api/whatsapp/send/file \
  -b "wa_token=<token>" \
  -F "phone=628123456789" \
  -F "file=@/path/to/invoice.pdf"

POST /api/whatsapp/send/video

Kirim video.

Request body (multipart/form-data)

Field	Type	Required	Keterangan
`phone`	string	Ya	Nomor tujuan
`caption`	string	Tidak	Keterangan video
`video`	file	*	File video
`video_url`	string	*	URL video publik
`view_once`	boolean	Tidak	Kirim sebagai sekali lihat
`compress`	boolean	Tidak	Kompres sebelum kirim

POST /api/whatsapp/send/audio

Kirim pesan suara atau file audio.

Request body (multipart/form-data)

Field	Type	Required	Keterangan
`phone`	string	Ya	Nomor tujuan
`audio`	file	*	File audio
`audio_url`	string	*	URL audio publik
`ptt`	boolean	Tidak	Kirim sebagai pesan suara (push-to-talk)

curl -X POST /api/whatsapp/send/audio \
  -b "wa_token=<token>" \
  -F "phone=628123456789" \
  -F "audio=@/path/to/suara.ogg" \
  -F "ptt=true"

POST /api/whatsapp/send/sticker

Kirim stiker.

Request body (multipart/form-data)

Field	Type	Required	Keterangan
`phone`	string	Ya	Nomor tujuan
`sticker`	file	*	File stiker (format WebP)
`sticker_url`	string	*	URL stiker publik