Dokumentasi · Hubungkan WhatsApp

Hubungkan WhatsApp

Nomor WhatsApp biasa atau WhatsApp Business tersambung ke inbox tim lewat scan QR, sekitar satu menit.

Kelola → Channel: nomor WhatsApp, email, livechat, dan channel API beserta statusnya.
Kelola → Channel: nomor WhatsApp, email, livechat, dan channel API beserta statusnya.

Cara menghubungkan

  1. Buka Kelola → Channel, klik Tambah channel, lalu pilih WhatsApp (butuh akses Hubungkan & atur nomor WhatsApp).
  2. Beri nama channel supaya tim mudah membedakan nomor, mis. "CS Toko" atau "Sales", lalu klik Lanjut ke QR.
  3. Di HP yang memegang nomor itu, buka WhatsApp → Menu ⋮ (Android) atau Setelan (iPhone) → Perangkat tertaut → Tautkan perangkat, lalu arahkan kamera ke QR di layar.
  4. Onix mendeteksi otomatis begitu nomor tersambung. QR diperbarui sendiri sebelum kedaluwarsa.

Tidak bisa scan (mis. HP dan layar komputer sama)? Pilih tab Kode pairing, masukkan nomor WhatsApp, lalu di HP pilih Tautkan dengan nomor telepon dan ketik kode 8 karakter yang muncul di Onix.

Kuota channel mengikuti paket dan dipakai bersama semua jenis channel (WhatsApp, email, livechat, channel API): Free 1, Pro 4 channel. Nomor yang masih menunggu scan atau terputus tetap menempati slot sampai dihapus. Email pelanggan, chat dari situs web, dan pesan dari aplikasi Anda juga bisa masuk ke inbox yang sama — lihat Hubungkan email, Livechat, dan Channel API.

Impor riwayat chat

Setelah tersambung, WhatsApp mengirim riwayat chat ke perangkat tertaut. Klik Impor riwayat di kartu channel (atau langsung setelah scan) lalu pilih 7 hari, 30 hari, 90 hari terakhir. Impor berjalan di latar, beberapa chat per menit; progresnya tampil di kartu channel.

  • Chat yang aktivitas terakhirnya maksimal 3 hari lalu masuk sebagai Open; yang lebih lama masuk sebagai Solved supaya tidak menumpuk di Belum dibalas.
  • Pesan riwayat tidak menambah penanda belum dibaca dan tidak memakai kuota balasan. Media diunduh belakangan dan disimpan privat di Onix.
  • Butuh chat yang lebih lama untuk satu pelanggan? Buka percakapannya lalu klik Ambil riwayat lama dari HP di atas pesan pertama.

Status nomor

StatusArtinyaYang perlu dilakukan
Menunggu scanChannel sudah dibuat, nomor belum ditautkan.Klik Scan QR di kartu channel.
TerhubungPesan masuk dan keluar berjalan normal.—
Koneksi terputusMasih login, tapi koneksi ke WhatsApp putus sementara (HP lama offline, gangguan jaringan).Pastikan HP online, lalu klik Sambung ulang.
LogoutPerangkat dilepas dari HP atau di-logout dari Onix. Pesan baru tidak masuk.Scan QR lagi. Riwayat tetap tersimpan.
DijedaPaket turun ke Free dan nomor ini melebihi kuota.Upgrade ke Pro atau pilih nomor ini di Paket & Tagihan.

Saat nomor terputus, pemegang akses Channel mendapat notifikasi dan email (bisa dimatikan di Pengaturan → General). Status diperiksa otomatis setiap menit.

Pengaturan per nomor

  • Terima percakapan grup: pesan dari grup WhatsApp tempat nomor ini bergabung masuk ke tab Group. Matikan bila nomor hanya untuk chat pribadi.
  • Tolak panggilan masuk: panggilan suara/video ditolak otomatis dan dicatat di percakapan. Isi balasan otomatis supaya penelepon diarahkan ke chat; balasan ini tidak dihitung sebagai balasan agen.
  • Tambahkan inisial agen di akhir balasan: balasan agen lewat nomor ini diakhiri baris inisial, mis. ^BS, supaya pelanggan tahu siapa yang membalas. Inisial tiap anggota diatur admin di Pengaturan → Anggota (ikon pena di baris anggota); kosong = otomatis ^ + huruf depan nama. Tidak berlaku untuk catatan internal, balasan otomatis, dan kiriman API. Kolom balasan menampilkan petunjuk "Diakhiri ^BS".
  • Boleh dipakai broadcast (bawaan mati): nomor ini bisa dipilih sebagai pengirim di menu Broadcast (Pro & Custom). Sebaiknya nomor khusus broadcast, terpisah dari nomor CS.
  • Jam kerja & balasan otomatis: ikuti jam kerja workspace atau jam kerja sendiri nomor ini, lalu nyalakan salam awal (sekali per percakapan baru di jam kerja) dan/atau pesan di luar jam kerja (paling sering sekali per 12 jam per percakapan). Dikirim sebagai pesan WhatsApp biasa, tidak untuk grup, panggilan, riwayat, atau pesan yang Anda kirim dari HP. Lihat Livechat → Jam kerja & balasan otomatis.
  • Ikon channel: bawaan logo WhatsApp; bisa diganti gambar sendiri (PNG/JPG/WebP persegi, maks 512 KB) supaya beberapa nomor mudah dibedakan di Interaction.

Label WhatsApp Business

Label yang dibuat dan dipasang di aplikasi WhatsApp Business (mis. "Pelanggan baru", "Sudah bayar") disalin otomatis ke Onix beberapa detik setelah diubah di HP: tampil di daftar inbox, kepala percakapan, dan panel detail, dan bisa dipakai sebagai filter. Sinkronnya satu arah — label tidak bisa dibuat atau dipasang dari Onix. WhatsApp biasa tidak punya label.

Aturan otomatis (Pro)

Di Kelola → Label & field kustom → Aturan label WhatsApp, buat aturan yang berjalan saat label tertentu dipasang pada chat di HP:

  • Pasang label kontak — mis. label WhatsApp "VIP" → label kontak "Pelanggan VIP".
  • Tugaskan ke tim Frontline — hanya untuk percakapan terbuka yang belum ditugaskan ke tim atau orang.
  • Tandai Solved — percakapan yang masih terbuka.

Nama label dicocokkan tanpa membedakan huruf besar/kecil; aturan bisa untuk semua nomor atau satu nomor. Melepas label tidak menjalankan apa pun. Setiap perubahan tercatat sebagai pesan sistem "Aturan label WhatsApp …". Di paket Free aturan tidak dijalankan.

Batasan & praktik aman

Onix memakai WhatsApp Web (perangkat tertaut), bukan API resmi WhatsApp. WhatsApp bisa membatasi atau memblokir nomor yang dipakai untuk spam, blast, atau promosi massal. Pakai nomor CS untuk membalas pelanggan; untuk mengirim ke banyak kontak gunakan menu Broadcast dengan nomor khusus broadcast — pengiriman bertahap dengan pengaman, dan risiko pemblokiran tetap ditanggung pemilik nomor.

  • Kecepatan kirim dibatasi 30 pesan per menit per nomor supaya nomor tidak dianggap spam.
  • HP harus online minimal sekali setiap 14 hari, kalau tidak WhatsApp melepas perangkat tertaut. Satu nomor maksimal 4 perangkat tertaut.
  • Belum tersedia: template resmi WhatsApp (API Meta), tombol & daftar interaktif, membuka pesan sekali lihat, katalog dan pembayaran WhatsApp.
  • Jangan menambahkan nomor pelanggan ke grup tanpa izin, dan hormati pelanggan yang minta tidak dihubungi lagi.

Menghapus channel

Hapus channel melepas nomor dari Onix. Bila channel sudah punya percakapan, riwayatnya diarsipkan (tetap bisa dibuka di inbox) dan percakapan yang masih terbuka ditutup. Slot kuota langsung bebas.

Nomor demo

Workspace yang diisi data contoh (atas permintaan pemilik akun) punya nomor berlabel Demo di menu Channel. Nomor ini tidak terhubung ke WhatsApp: balasan dari inbox hanya disimulasikan (langsung berstatus terkirim, tidak sampai ke siapa pun), dan tidak ada tombol Scan QR, Impor riwayat, atau Logout. Nomor demo memakai slot kuota nomor seperti biasa — Hapus channel bila tidak dipakai lagi; percakapannya diarsipkan.