Hubungkan Nomor WhatsApp
Cara menambah, scan QR, dan mengelola banyak nomor WhatsApp (device) di WhatsApp Gateway Dilztify untuk dipakai lewat API.
Device adalah representasi satu nomor WhatsApp yang terhubung ke akunmu. Satu akun bisa punya banyak device sekaligus (misalnya untuk beberapa tim/CS berbeda), masing-masing dengan ID unik yang dipakai sebagai header X-Device-Id saat mengirim pesan lewat API.
Semua pengelolaan device dilakukan lewat dashboard di menu Devices.
Menambah Device
Klik Tambah Device dan isi form:
| Field | Wajib | Keterangan |
|---|---|---|
| Nama Device | ✅ | Nama bebas untuk membedakan device di dashboard |
| Auto-read personal | Otomatis "read" pesan masuk dari chat personal | |
| Auto-read group | Otomatis "read" pesan masuk dari group | |
| Webhook URL | URL penerima event real-time, lihat Webhook | |
| Webhook Token | Token untuk signature verifikasi webhook | |
| Webhook Events | Daftar event yang ingin disubscribe |
Device yang baru dibuat berstatus belum terhubung sampai proses pairing selesai. Nomor WhatsApp tidak perlu diisi saat membuat device, nomor terisi otomatis setelah device berhasil terhubung.
Menghubungkan Device (Pairing)
Klik Connect pada device, lalu pilih salah satu metode:
Dashboard menampilkan QR code. Buka WhatsApp di HP → Linked Devices → Link a Device, lalu scan QR tersebut.
Kalau device belum punya nomor, isi dulu nomor WhatsApp yang akan dihubungkan (boleh 08… maupun 628…), lalu klik Generate Ulang Code. Dashboard menampilkan kode 8 karakter. Buka WhatsApp di HP → Linked Devices → Link a Device → Link with phone number instead, lalu masukkan kode tersebut. Nomor yang login di HP harus sesuai dengan nomor yang dipakai untuk generate kode.
Klik Connect with Link untuk membuat link publik ke halaman pairing QR, berguna kalau yang akan scan QR bukan kamu sendiri (misalnya klien atau tim lain), jadi tidak perlu foto/screenshot QR lagi.
- Klik Connect with Link, salin link yang muncul (atau buka langsung lewat tombol di sampingnya).
- Kirim link tersebut ke orang yang perlu menyambungkan device.
- Siapa pun yang membuka link akan melihat halaman QR yang sama, lengkap dengan panduan langkah-langkah scan, dan QR di dalamnya ikut memperbarui diri otomatis.
Link berlaku 30 menit, bersifat rahasia
Link ini tidak memerlukan login, siapa pun yang memegangnya bisa menyambungkan device tersebut. Bagikan hanya ke pihak yang memang berwenang. Link kedaluwarsa 30 menit setelah dibuat, dan membuat link baru untuk device yang sama otomatis menonaktifkan link lama.
QR/kode berlaku 30 detik
Baik QR maupun pairing code kedaluwarsa dalam waktu singkat. Jika habis sebelum sempat scan/input, klik Generate Ulang untuk mendapatkan QR/kode baru (halaman link publik melakukan ini secara otomatis).
Dashboard maupun halaman link publik otomatis memantau status pairing, begitu QR/kode berhasil dipakai, status device berubah menjadi terhubung dalam beberapa detik tanpa perlu refresh manual.
Connect with Link via API
Link koneksi juga bisa dibuat lewat API, misalnya kalau kamu membangun halaman pairing sendiri untuk klien.
1. Buat link (butuh Authorization: Bearer):
curl -X POST https://api.dilztify.my.id/v1/devices/{id}/share-link -H "Authorization: Bearer <token>"{
"success": true,
"message": "Link koneksi berhasil dibuat",
"data": { "token": "3f9c1e7a5b2d4c8e9a0b6d1f2e3c4b5a", "expires_at": "2026-10-01T10:30:00Z" }
}token hanya tampil sekali. Link untuk dibagikan: https://dilztify.my.id/connect/{token}.
2. Endpoint publik (tanpa Authorization, token di path adalah kredensialnya, maks. 30 request/menit):
| Endpoint | Fungsi |
|---|---|
POST /v1/connect/{token}/login | Buat QR baru (berlaku 30 detik), already_logged_in: true jika sudah terhubung |
GET /v1/connect/{token} | Poll status is_connected / is_logged_in sampai pairing selesai |
Token tidak dikenal, kedaluwarsa, atau sudah dinonaktifkan semuanya mengembalikan 404 dengan pesan yang sama ("Link koneksi tidak ditemukan atau sudah kedaluwarsa"). Detail lengkap ada di API Reference.
Reconnect & Logout
| Aksi | Kapan dipakai |
|---|---|
| Reconnect | Koneksi terputus tapi sesi login masih valid |
| Logout | Memutus sesi WhatsApp secara sengaja; device tetap ada, tinggal pairing ulang |
| Hapus | Menghapus device beserta sesi WhatsApp-nya secara permanen |
Semua aksi ini tersedia lewat menu aksi (â‹®) pada tiap baris device di dashboard.
Memantau Status Device
Halaman detail device menampilkan:
| Status | Keterangan |
|---|---|
| Terhubung | Socket WhatsApp sedang aktif/tersambung |
| Sudah Login | Nomor sudah pernah berhasil pairing |
| Nomor WhatsApp | Nomor yang terdaftar pada device |
Konfigurasi Webhook
Device bisa dikonfigurasi untuk mengirim event real-time (pesan masuk, status pengiriman, dll) ke server milikmu lewat webhook. Atur Webhook URL, Webhook Token, dan Webhook Events di halaman edit device. Detail lengkap ada di Webhook, termasuk cara verifikasi signature dan contoh payload event.
Riwayat pengiriman webhook per device (untuk debugging) bisa dilihat di tab Webhook Logs pada halaman detail device.
Cara Integrasi WhatsApp API
Langkah awal integrasi WhatsApp API Dilztify: daftar akun, hubungkan nomor WhatsApp, lalu kirim pesan WhatsApp pertama lewat REST API.
Kirim Pesan WhatsApp via API
Endpoint WhatsApp API untuk kirim pesan teks, gambar, dokumen, lokasi, kontak, dan polling otomatis dari aplikasi atau server kamu.