🚫 Anda tidak terhubung ke internet
Docs Navigation
API Reference

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.

25Endpoints
v1.0.0Version
RESTProtocol

Quickstart

Kirim pesan pertama kamu dalam hitungan detik.

terminal
# 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

🔑
Bearer Token

Setiap request harus menyertakan header Authorization: Bearer <token>. Gunakan API key Dilztify sebagai token.

📱
Device ID

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 lokal 089685028129, +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 @newsletter dan @broadcast) yang butuh akhiran.
  • Beberapa tujuan dipisah koma (broadcast): 6289685028129,628123456789. Tiap tujuan diproses sebagai task sendiri.
kirim ke grup
# 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

202 AcceptedMode async aktif

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.

POST request
202 + task_id
Queue processing
Delivered

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.

envelope
// Sukses
{ "success": true, "message": "...", "data": { }, "meta": { }, "pagination": { } }

// Gagal
{ "success": false, "message": "...", "details": { } }
  • 400 header wajib hilang atau body tidak valid.
  • 401 API key tidak ada atau salah.
  • 402 saldo tidak cukup.
  • 404 device tidak ditemukan di akun ini.
  • 422 field wajib kosong, process_at sudah lewat, device belum login, atau nomor tujuan tidak terdaftar di WhatsApp.
  • 429 hanya untuk dua kasus: (1) batas request API, lebih dari 100 request per menit per akun; atau (2) kuota pesan harian/bulanan paket habis. Teks message menjelaskan penyebabnya, tetapi bersifat informasi. Frekuensi kirim yang tinggi tidak memicu 429 karena diatur lewat antrean, dan saldo kurang dijawab 402.