🚫 Anda tidak terhubung ke internet
Dokumentasi Web

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:

FieldWajibKeterangan
Nama Device✅Nama bebas untuk membedakan device di dashboard
Auto-read personalOtomatis "read" pesan masuk dari chat personal
Auto-read groupOtomatis "read" pesan masuk dari group
Webhook URLURL penerima event real-time, lihat Webhook
Webhook TokenToken untuk signature verifikasi webhook
Webhook EventsDaftar 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.

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.

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):

EndpointFungsi
POST /v1/connect/{token}/loginBuat 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

AksiKapan dipakai
ReconnectKoneksi terputus tapi sesi login masih valid
LogoutMemutus sesi WhatsApp secara sengaja; device tetap ada, tinggal pairing ulang
HapusMenghapus 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:

StatusKeterangan
TerhubungSocket WhatsApp sedang aktif/tersambung
Sudah LoginNomor sudah pernah berhasil pairing
Nomor WhatsAppNomor 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.

On this page