Tutorial ini memandu Anda menghubungkan agent qlar ke nomor WhatsApp Business menggunakan Qontak sebagai provider WhatsApp Business API.

Contohnya menghubungkan Atlas, asisten operasional Kirana Group, ke nomor WhatsApp Business Kirana 6281200000000, agar site supervisor dan staf lapangan bisa bertanya kepada Atlas soal persetujuan dan keselamatan kerja dari ponsel mereka.


Sebelum memulai

  • Agent Anda sudah menjawab dengan baik di Preview dan sudah di-publish setidaknya sekali. Lihat Preview dan Publish Perubahan.
  • Anda sudah membaca Menghubungkan ke WhatsApp, yang menjelaskan konfigurasi Published dan Draft yang dipakai di bawah ini.
  • Anda memakai Qontak sebagai provider WhatsApp Business. Jika Anda hanya ingin agent cepat hadir di WhatsApp, Mulai Cepat: Public Server tidak memerlukan akun provider.

Dari sisi Qontak, pastikan Anda punya:

  • Akun Qontak yang aktif.
  • Nomor WhatsApp Business yang terdaftar melalui Qontak.
  • Channel Integration ID dan Access Token Anda. Qontak memberikan keduanya setelah Anda menyelesaikan pendaftaran channel di platform mereka. Channel Integration ID berupa GUID, misalnya 6d25a1e6-e7b3-4f3e-a6b2-6b530d881c25.

Catatan: Jika Qontak belum mengirimkan Channel Integration ID dan Access Token, Anda tetap bisa membuat konfigurasinya sekarang (Langkah 2) dan mengisinya nanti.


Langkah 1: Buka Setelan Channel

  1. Buka dashboard CMS dan pilih agent yang ingin Anda hubungkan.
  2. Di sidebar kiri, buka Channels โ†’ WhatsApp.
  3. Pilih konfigurasi yang akan diatur: Published Configuration (untuk user live) atau Draft Configuration (untuk pengujian). Klik tab yang sesuai.

Catatan: Kedua tab bisa diatur secara terpisah. Mulailah dengan Draft untuk menguji lebih dulu, lalu ulangi langkah-langkahnya untuk Published saat siap go live.


Langkah 2: Isi nomor telepon dan klik Next

Jika belum ada nomor WhatsApp yang terhubung, wizard Connect WhatsApp akan muncul.

  1. Di dropdown Protocol, pilih Qontak.
  2. Di field Phone Number, masukkan nomor yang terdaftar di Qontak, diawali kode negara. Untuk Kirana nomornya 6281200000000. Untuk Qontak field ini opsional, tetapi mengisinya membantu Anda mencocokkan konfigurasi dengan nomor yang benar.
  3. Klik Next.

Mengklik Next langsung membuat konfigurasinya. Tidak ada konfirmasi terpisah. Wizard tertutup dan layar konfigurasi terbuka. Bagian atasnya menampilkan switch Active, tombol Notifications, dan menu โ‹ฏ yang berisi Delete channel. Integrasinya baru benar-benar berjalan setelah semua field wajib terisi dan endpoint diatur, jadi lanjutkan ke langkah berikutnya.

Layar konfigurasi Qontak setelah mengklik Next: label Qontak, switch Active, tombol Notifications yang masih abu-abu, dan menu titik tiga di atas; kartu Connection & Credentials dengan tombol Edit, Phone Number (registered with Qontak) 6281200000000, kotak info yang meminta Anda menghubungi provider Qontak dengan nomor itu untuk mendapatkan Channel Integration ID dan Access Token, field Channel Integration ID yang masih kosong dengan contoh GUID, dan di bawah API Credentials field Access Token kosong serta tombol Set Endpoint yang nonaktif beserta petunjuk untuk menyimpan Channel Integration ID dan Access Token lebih dulu

Layar ini menampilkan satu kartu, Connection & Credentials. Isinya Phone Number (registered with Qontak), kotak info, field Channel Integration ID, lalu di bawah API Credentials ada field Access Token dan tombol Set Endpoint. Kartu ini hanya bisa dibaca sampai Anda mengklik Edit.

Berbeda dengan Meta Cloud dan Coster, di sini tidak ada Webhook Secret dan tidak ada URL webhook yang perlu dikirim. Webhook Qontak didaftarkan lewat tombol Set Endpoint. Reply Mode dan Session Management baru muncul setelah endpoint diatur.


Langkah 3: Isi Channel Integration ID dan Access Token

Kotak info berbunyi: hubungi provider Qontak dengan nomor telepon di atas, dan provider akan memberikan Channel Integration ID dan Access Token.

  1. Klik Edit di kanan atas kartu Connection & Credentials. Field-nya bisa diisi, dan tombol Cancel serta Save muncul di bagian bawah kartu.
  2. Channel Integration ID: masukkan GUID dari Qontak, misalnya 6d25a1e6-e7b3-4f3e-a6b2-6b530d881c25.
  3. Access Token: masukkan access token dari Qontak.
  4. Klik Save di bagian bawah kartu. CMS bertanya Save these changes? Di tab Published Configuration, CMS justru memperingatkan bahwa perubahan langsung berlaku untuk agent live. Klik Yes.
  5. Sebuah pesan mengonfirmasi Connection and credentials saved. Kartu kembali hanya bisa dibaca.

Cancel membuang yang Anda ketik dan menutup mode edit. Selama mengedit, kartu menampilkan Unsaved changes di samping tombolnya.

Set Endpoint tetap nonaktif sampai kedua nilai tersimpan, dan selama kartu sedang diedit. Di sampingnya tertulis petunjuk "Save the Channel Integration ID and Access Token first, then click Set Endpoint."


Langkah 4: Daftarkan webhook (Set Endpoint)

Set Endpoint mendaftarkan alamat webhook qlar langsung ke platform Qontak.

  1. Klik Set Endpoint.
  2. CMS memperingatkan bahwa tindakan ini mengubah tujuan webhook di server Qontak, sehingga semua pesan WhatsApp yang masuk diteruskan ke qlar. Klik Yes.
  3. Tunggu pesan konfirmasi. Tombolnya berubah menjadi โœ“ Endpoint Configured dan petunjuknya berbunyi "Webhook registered. WhatsApp messages are forwarded to Qlar.ai."

Sekarang kartu Reply Mode dan Session Management muncul.

Peringatan: Set Endpoint menghubungi API Qontak atas nama Anda. Pastikan akun Qontak Anda aktif dan Channel Integration ID sudah benar sebelum mengkliknya. ID yang salah membuat pendaftaran gagal.


Langkah 5: Pilih reply mode dan setelan sesi

  1. Di Reply Mode, biarkan AI agent agar Atlas menjawab langsung di WhatsApp. Redirect to web justru mengirimkan link masuk sekali pakai ke web chat agent untuk setiap pesan pribadi, dan tidak ada AI yang berjalan di WhatsApp. Untuk mengaturnya, termasuk template tombol yang khusus Qontak, ikuti Alihkan ke Web Chat; WhatsApp di Bantuan mencantumkan setelannya.
  2. Di Session Management, biarkan nilai default kecuali Anda punya alasan untuk mengubahnya: Ask User to End Session aktif, Delay Before Ask More 300 detik, Delay Before End Session 600 detik. Lihat Session Management.
  3. Jika Anda mengubah sesuatu di Session Management, klik Save di bagian bawah kartu itu lalu konfirmasi. Tombol Discard-nya mengembalikan nilai yang tersimpan.

Setiap kartu hanya menyimpan field-nya sendiri, jadi menyimpan Session Management tidak pernah ikut mengirim editan yang belum selesai di kartu lain.


Langkah 6: Publish

Penyimpanan menandai agent Anda punya perubahan yang belum di-publish, sehingga tombol Publish muncul di bagian atas CMS. Klik Publish agar koneksi disinkronkan ke versi live agent Anda.

Tombol Notifications di bagian atas layar membuka setelan notifikasi untuk nomor ini. Tombol ini tetap abu-abu sampai Channel Integration ID dan Access Token tersimpan dan endpoint sudah diatur, dan juga selama Connection & Credentials sedang diedit. Arahkan kursor ke tombol itu untuk melihat apa yang masih kurang.


Periksa hasilnya

Untuk memastikan koneksi berjalan:

  1. Dari akun WhatsApp pribadi, kirim pesan uji ke nomor WhatsApp Business Anda, misalnya Who has to approve a project worth $2.5 million?
  2. Pesan tersebut seharusnya muncul di riwayat percakapan agent Anda di dashboard CMS.
  3. Agent Anda seharusnya membalas otomatis, dengan jawaban yang sama seperti di Preview.

Tip: Jika pesan tidak masuk, periksa bahwa switch Active menyala dan tombolnya menampilkan โœ“ Endpoint Configured. Pastikan Channel Integration ID adalah GUID yang valid dari Qontak dan akun Qontak Anda punya izin yang benar untuk konfigurasi webhook.


Langkah berikutnya

  • Berikutnya dalam jalur ini: Embed Chat ke Website, agar pengunjung website juga bisa mengobrol dengan agent Anda.
  • Ulangi langkah-langkah ini untuk tab Draft Configuration dengan channel uji Qontak terpisah jika Anda ingin lingkungan yang aman untuk menguji perubahan.
  • Memakai opsi lain untuk nomor lain? Lihat Mulai Cepat: Public Server, Meta Cloud atau Coster.
  • Session Management: lihat Menghubungkan ke WhatsApp untuk mengatur kapan sesi percakapan berakhir.