Mengelola Perangkat & API Key di WHAPI

Panduan mengganti perangkat yang terhubung dan memperbarui API Key, mencakup proses logout, penghapusan sesi, dan scan QR ulang.

Prasyarat

• Sudah login ke dashboard Whapi
• Memiliki akses ke menu Kelola Perangkat

Mengganti Perangkat yang Terhubung

Ada dua cara memutus koneksi perangkat lama sebelum menghubungkan perangkat baru.

Metode 1: Logout dari WhatsApp di Ponsel

1. Buka WhatsApp di ponsel lama
2. Masuk ke menu Perangkat Tertaut (Linked Devices)
3. Pilih koneksi ke Whapi dan klik Putuskan
4. Kembali ke dashboard Whapi jika ingin menghubungkan perangkat baru melalui scan QR

Metode 2: Logout via Dashboard Whapi

1. Masuk ke menu Kelola Perangkat di dashboard
2. Klik tombol Logout pada perangkat yang ingin diganti
3. Sesi perangkat lama terhapus secara otomatis
4. Hubungkan perangkat baru melalui scan QR atau kode manual

Gunakan metode ini jika ponsel lama sudah tidak dapat diakses, hilang, atau berpindah kepemilikan.

Menghapus Sesi Perangkat

Penghapusan sesi diperlukan jika koneksi perlu direset sepenuhnya tanpa logout dari WhatsApp di ponsel.

1. Masuk ke menu Kelola Perangkat
2. Nonaktifkan layanan terlebih dahulu jika masih aktif
3. Klik tombol Hapus Sesi Perangkat

4. Aktifkan kembali layanan dengan QR code atau kode manual baru yang akan muncul
5. Hubungkan perangkat baru melalui metode yang tersedia

Mengganti API Key

API Key perlu diganti jika diduga bocor atau sebagai bagian dari rotasi keamanan rutin.

1. Masuk ke menu Kelola Perangkat
2. Pilih perangkat yang API Key-nya ingin diganti
3. Klik Ganti API Key
4. Salin API Key baru yang dihasilkan
5. Perbarui nilai API Key di semua sistem atau aplikasi yang menggunakannya
6. Aktifkan kembali layanan jika berhenti secara otomatis setelah penggantian

Note: Saat API Key diganti ketika layanan sedang aktif, layanan akan berhenti secara otomatis. Aktifkan kembali setelah API Key baru diterapkan di sistem.

Simpan API Key di environment variable atau secrets manager, hindari menyimpan API Key langsung di kode aplikasi.

Error Umum dan Solusinya

Kondisi	Penyebab	Solusi
Tombol Logout tidak merespons	Perangkat sudah dalam status SERVICE_OFF	Aktifkan layanan terlebih dahulu, lalu coba logout
QR code tidak muncul setelah hapus sesi	Layanan belum diaktifkan kembali	Klik Mulai Layanan setelah sesi dihapus
Sistem tidak bisa mengirim pesan setelah ganti API Key	API Key lama masih digunakan di sistem	Perbarui API Key di semua titik integrasi yang menggunakannya
Layanan berhenti setelah ganti API Key	Perilaku normal saat API Key diganti saat layanan aktif	Aktifkan kembali layanan dari dashboard