Mengirim Pesan

Masukkan satu pesan ke antrean untuk dikirim ke satu atau banyak nomor tujuan.

POST/api/v1/client/send-message

Body permintaan

Field	Tipe	Wajib	Keterangan
`message`	string	Ya	Isi pesan teks.
`targets`	string[]	Ya	Daftar tujuan. Perangkat WhatsApp: nomor telepon (mis. "628123456789"). Perangkat Telegram: @username, tautan t.me, atau nomor telepon.
`country_code`	string	Tidak	Kode negara untuk nomor yang masih lokal — nomor yang diawali 0 diubah memakai kode ini (mis. "62" mengubah 0812… menjadi 62812…). Hanya berlaku untuk perangkat WhatsApp. Bila dikosongkan, nomor dikirim apa adanya.
`attachments`	string[]	Tidak	Daftar URL/berkas lampiran (opsional).
`spintax`	boolean	Tidak	true untuk mengaktifkan Spintax pada isi pesan (lihat di bawah).
`is_scheduled`	boolean	Tidak	true untuk menjadwalkan pengiriman berulang.
`schedule_date`	string (ISO-8601)	Tidak	Tanggal mulai bila is_scheduled true.
`schedule_time`	string (HH:MM)	Tidak	Jam kirim bila is_scheduled true.
`schedule_timezone`	string (IANA TZ)	Tidak	Zona waktu, mis. "Asia/Jakarta".

Field bot_id pada body diabaikan — perangkat ditentukan oleh API key. Watermark ditentukan oleh paket (bukan oleh body). Perangkat harus berstatus tersambung; bila tidak, permintaan ditolak dengan 409.

Format nomor

WhatsApp dijangkau lewat nomor internasional: 628123456789, tanpa "+" dan tanpa "0" di depan. Nomor yang masih lokal seperti 08123456789 tidak bisa dijangkau, dan pengirimannya gagal tanpa penjelasan.

Kirim country_code bila daftar tujuan Anda masih memakai nomor lokal — sama seperti pilihan "Format nomor" pada form Kirim Pesan di aplikasi. Nomor yang sudah internasional tidak diubah, sehingga daftar campuran tetap aman. Field ini sengaja tidak punya nilai bawaan: menebak kode negara untuk nomor yang bukan milik Indonesia tidak akan gagal, melainkan mengirim pesan ke orang lain.

{
  "message": "Halo dari QwikChat",
  "country_code": "62",
  "targets": ["08123456789", "628123456789"]
}

dua tujuan di atas menjadi SATU penerima: 628123456789

Spintax

Bila spintax bernilai true, grup pilihan pada isi pesan diganti dengan salah satu opsi secara acak — dipilih ulang untuk tiap penerima, sehingga tiap orang menerima variasi yang berbeda. Grup boleh bersarang. Bila false, tanda kurung dikirim apa adanya.

Halo {teman|kawan}, {selamat pagi|semoga harimu menyenangkan}!

contoh hasil untuk 2 penerima:
  Halo teman, selamat pagi!
  Halo kawan, semoga harimu menyenangkan!

Contoh permintaan

curl -X POST https://qwikchat.app/api/v1/client/send-message \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Halo dari QwikChat",
    "targets": ["628123456789"]
  }'

Contoh respons

{
  "code": 200,
  "message": "your message is successfully saved on queue to be processed",
  "data": null,
  "meta": null
}

← Daftar Grup Status Pesan →