Webhook status koneksi perangkat

Webhook ini berfungsi untuk mengirimkan status koneksi perangkat yang terhubung ke aplikasi. Ada 3 kategori webhook yang akan dikirim :

• ready

• change_state

• disconnected

Ready

Event webhook dengan type ready artinya perangkat berhasil terhubung ke aplikasi dan siap digunakan mengkonsumsi API whatsapp.

{
  "type": "ready", // Tipe webhook yang dikirim
  "results": { // Kumpulan object dari event ready
    "apiKey": "xxxxx", // API Key yang mewakili device
    "message": "Device connected successfully" // Pesan koneksi berhasil
  }
}

Change State

Event webhook dengan type change_state akan dikirim ketika ada perubahan status koneksi pada aplikasi/device.

{
  "type": "change_state", // Tipe webhook yang dikirim
  "results": { // Kumpulan object dari event change_state
    "apiKey": "xxxxx", // API Key yang mewakili device
    "state": "SERVICE_SCAN" // Status perubahan koneksi
  }
}

Pada object state ada beberapa nilai :

State	Keterangan
SERVICE_SCAN	Aplikasi menunggu perangkat untuk di scan, buka aplikasi whatsapp pada perangkat hp/emulator Anda. Scan qrcode pada aplikasi.
SERVICE_OFF	Layanan mati
PAIRING	Perangkat sedang mencoba terhubung ke aplikasi
CONNECTED	Perangkat berhasil terhubung ke aplikasi

Disconnected

Event webhook dengan type disconnected akan dikirim ketika aplikasi dan perangkat terputus.

{
  "type": "disconnected", // Tipe webhook yang dikirim
  "results": { // Kumpulan object dari event disconnected
    "apiKey": "xxxxx", // API Key yang mewakili device
    "state": "SERVICE_OFF", // Status perubahan koneksi
    "reason": "connection_logout", // Penyebab perangkat terputus dengan aplikasi
    "reconnect": false // Boolean apakah aplikasi bisa reconnect lagi / tidak
  }
}

Pada object reason ada beberapa nilai :

Reason	Keterangan
bad_session	Sesi whatsapp telah kadaluarsa atau tidak valid
connection_closed	Koneksi ke whatsapp ke web tertutup
connection_lost	Koneksi whatsapp web hilang
connection_conflict	Koneksi aplikasi diganti
connection_logout	Koneksi ke whatsapp web logout, harus scan ulang
not_multidevice	Aplikasi whatsapp tidak mendukung multidevice
connection_reconnect	Whatsapp web sedang mencoba menghubungkan ulang
connection_timedout	Koneksi berakhir
connection_banned	Perangkat / no whatsapp dibanned
onnection_banned_temp	Whatsapp web sedang dibanned sementara

Untuk object reconnect, jika nilainya true, ketika Anda Service Start, akan langsung terhubung/connected, sebaliknya, jika false, Anda wajib scan ulang perangkat.