Dilztify Public API
Kelola device WhatsApp dan kirim berbagai jenis pesan melalui REST API. Semua endpoint memakai API key sebagai Bearer token. Alurnya: buat device, login lewat QR, lalu kirim pesan dengan header X-Device-Id.
Quickstart
Kirim pesan pertama kamu dalam hitungan detik.
# 1. Ambil device yang tersedia beserta status loginnya
curl -X GET "https://api.dilztify.my.id/v1/devices" \
-H "Authorization: Bearer $TOKEN"
# 2. Pakai id device dari langkah 1 sebagai X-Device-Id saat mengirim pesan
curl -X POST "https://api.dilztify.my.id/v1/wa/send/message" \
-H "Authorization: Bearer $TOKEN" \
-H "X-Device-Id: $DEVICE_ID" \
-H "Content-Type: application/json" \
-d '{
"phone": "6289685028129",
"message": "Halo dari Dilztify!"
}'Authentication
Setiap request harus menyertakan header Authorization: Bearer <token>. Gunakan API key Dilztify sebagai token.
Header X-Device-Id wajib disertakan di semua endpoint send/*. Nilainya adalah id device yang didapat dari endpoint Devices. Endpoint /v1/devices/* sendiri tidak memakai header ini.
Format nomor tujuan
Field phone cukup berisi nomor dengan kode negara. Tidak perlu + dan tidak perlu akhiran @s.whatsapp.net (JID).
- Nomor pribadi:
6289685028129. Format lokal089685028129,+62…, atau yang memakai spasi dan tanda hubung otomatis dirapikan. Nomor negara lain wajib diawali kode negara. - Grup: wajib ID grup lengkap dengan akhiran
@g.us, karena ID grup bukan nomor telepon. Hanya grup (serta channel@newsletterdan@broadcast) yang butuh akhiran. - Beberapa tujuan dipisah koma (broadcast):
6289685028129,628123456789. Tiap tujuan diproses sebagai task sendiri.
# Kirim ke grup: wajib pakai ID grup lengkap dengan akhiran @g.us
curl -X POST "https://api.dilztify.my.id/v1/wa/send/message" \
-H "Authorization: Bearer $TOKEN" \
-H "X-Device-Id: $DEVICE_ID" \
-H "Content-Type: application/json" \
-d '{
"phone": "[email protected]",
"message": "Halo semua!"
}'Async Queue
Berlaku untuk endpoint pengiriman pesan (kecuali presence dan chat-presence). Request bisa dijawab 200 (langsung terkirim) atau 202 Accepted beserta task_id dan delay_seconds saat masuk antrean. Tangani keduanya. Kirim beruntun (burst) tidak ditolak dengan 429: request tetap diterima dan pengirimannya diatur otomatis oleh Dilztify Ban Guard System sebagai kontrol risiko tambahan, bukan jaminan nomor bebas dari pembatasan WhatsApp. Isi process_at (RFC3339) untuk menjadwalkan pengiriman; request dikirim tepat pada waktu itu tanpa pengaturan Ban Guard System, jadi risikonya ada di sisi kamu.
Format response & error
data, meta, pagination, dan details hanya muncul bila relevan. Andalkan kode HTTP dan struktur data/details; teks message bersifat informasi dan bisa berubah.
// Sukses
{ "success": true, "message": "...", "data": { }, "meta": { }, "pagination": { } }
// Gagal
{ "success": false, "message": "...", "details": { } }400header wajib hilang atau body tidak valid.401API key tidak ada atau salah.402saldo tidak cukup.404device tidak ditemukan di akun ini.422field wajib kosong,process_atsudah lewat, device belum login, atau nomor tujuan tidak terdaftar di WhatsApp.429hanya untuk dua kasus: (1) batas request API, lebih dari 100 request per menit per akun; atau (2) kuota pesan harian/bulanan paket habis. Teksmessagemenjelaskan penyebabnya, tetapi bersifat informasi. Frekuensi kirim yang tinggi tidak memicu 429 karena diatur lewat antrean, dan saldo kurang dijawab 402.