Qiscus WhatsApp Integration

Hubungkan akun Qiscus Multichannel Chat Anda dengan Konektor. Fitur ini memungkinkan setiap pesan WhatsApp dari pelanggan otomatis masuk sebagai Leads, lengkap dengan fitur auto-reply dan tracking status.

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

2. Hubungkan di Dashboard Konektor

1. Masuk ke menu Integrations > Partner Integrations.
2. Klik tombol + Add Integration.
3. Pilih Qiscus dari daftar partner.
4. Masukkan kredensial yang didapat di langkah 1:
   • App ID
   • Secret Key
   • Channel ID
5. Klik Save & Connect.

3. Verifikasi Status

Setelah terhubung, status integrasi akan berubah menjadi Active (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, semua pesan WhatsApp yang masuk akan otomatis tersinkronisasi sebagai Lead di Konektor. Anda kemudian bisa menggunakan fitur Automation Rules untuk mengotomatisasi berbagai 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.

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. Coba klik Re-connect di dashboard Konektor untuk memicu ulang registrasi webhook.

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
• Lihat Data Leads di Dashboard