Mengirim Pesan
Masukkan satu pesan ke antrean untuk dikirim ke satu atau banyak nomor tujuan.
POST
/api/v1/client/send-messageBody 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. |
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.
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
}