Qiscus WhatsApp Integration

Hubungkan akun Qiscus Multichannel Chat Anda dengan Konektor. Pesan WhatsApp pelanggan yang membawa kode pengunjung [K-...] atau data iklan Click-to-WhatsApp otomatis masuk sebagai Leads. Pesan dari lead yang sudah ada tercatat pada lead itu, dan Aturan Otomatisasi berjalan pada pesan Qiscus.

Mengapa Integrasi Qiscus?

• Zero-Config Webhook: Konektor otomatis mendaftarkan webhook URL ke Qiscus App Anda.
• Real-time Sync: Pesan masuk detik itu juga tercatat di dashboard Leads.
• Rich Media Support: Mendukung pesan Text, Gambar, Video, Dokumen, dan Lokasi.
• Secure: Validasi signature otomatis untuk keamanan data (HMAC-SHA256).

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Qiscus Multichannel: Dengan layanan WhatsApp Business API yang sudah aktif.
2. Akses Admin: Ke dashboard Qiscus untuk melihat App ID dan Secret Key.
3. Paket Konektor: masa coba 14 hari, atau paket Starter atau lebih tinggi.

Cara Integrasi

1. Dapatkan Kredensial Qiscus

Login ke dashboard Qiscus Multichannel Anda dan cari informasi berikut di menu Settings > App Information:

• App ID: Kode unik aplikasi (contoh: qiscus-app-123)
• Secret Key: Kunci rahasia untuk validasi webhook
• Channel ID: ID spesifik untuk channel WhatsApp Anda (biasanya angka)
• Server: alamat dashboard Qiscus di address bar browser. Alamat omnichannel.qiscus.com berarti akun Anda di Indonesia. Alamat omnichannel-my.qiscus.com berarti akun Anda di Malaysia.

2. Hubungkan di Dashboard Konektor

1. Buka Pengaturan > Integrasi.
2. Cari kartu Qiscus.
3. Klik kartu Qiscus di bagian Tersedia untuk dihubungkan.
4. Masukkan kredensial yang didapat di langkah 1:
   • App ID
   • Secret Key
   • Channel ID
   • Server (opsional): isi omnichannel-my.qiscus.com bila akun Anda di Malaysia. Kosongkan bila akun Anda di Indonesia.
5. Klik Hubungkan.

3. Verifikasi Status

Setelah terhubung, status integrasi berubah menjadi Terhubung (hijau).

Anda bisa melakukan tes sederhana:

1. Kirim pesan WhatsApp ke nomor bisnis Anda dari nomor pribadi.
2. Buka menu Leads di Konektor.
3. Pesan baru tersebut seharusnya muncul sebagai Lead baru (atau update lead lama) dalam hitungan detik.

Fitur Otomatisasi

Setelah integrasi Qiscus aktif, pesan yang membawa kode pengunjung [K-...] atau data iklan menjadi Lead di Konektor. Pesan lain dari lead yang sudah ada tercatat pada lead itu. Pesan tanpa kode dan tanpa data iklan dari nomor baru tidak membuat lead. Anda bisa memakai Aturan Otomatisasi untuk mengotomatisasi aksi berdasarkan kondisi tertentu.

Troubleshooting

Integrasi Gagal Terhubung

Error: "Invalid channelId: ... Qiscus API expects a valid positive integer." Solusi: Pastikan Channel ID yang Anda masukkan adalah angka murni (tanpa spasi atau huruf). Channel ID Qiscus biasanya berbentuk angka integer.

Akun Qiscus di Malaysia Tidak Terhubung

Gejala: Integrasi gagal terhubung, padahal App ID, Secret Key, dan Channel ID sudah benar. Solusi: Cek alamat dashboard Qiscus Anda. Bila alamatnya omnichannel-my.qiscus.com, isi kolom Server dengan alamat itu, lalu simpan lagi. Kolom Server hanya menerima omnichannel.qiscus.com atau omnichannel-my.qiscus.com.

Lead Tidak Muncul

Gejala: Pesan masuk di Qiscus tapi tidak tampil di Konektor. Solusi:

1. Pastikan subscription Qiscus Anda aktif.
2. Cek apakah App ID dan Secret Key sudah benar (kadang tertukar).
3. Jika status Menunggu atau Bermasalah, buka menu ⋮ pada integrasi Qiscus, lalu klik Verifikasi Koneksi untuk memicu ulang registrasi webhook. Jika status Terhubung, buka menu ⋮ > Edit dan periksa lagi kredensial Anda.

Webhook Error

Gejala: Log error "Signature mismatch". Solusi: Ini berarti Secret Key yang Anda masukkan di Konektor berbeda dengan yang ada di dashboard Qiscus. Mohon update Secret Key di Konektor.

Next Steps

• Pelajari WhatsApp Automation Rules
• Buka menu Leads di dashboard.