Menghubungkan ke WhatsApp
Buka di CMSTahap 2 dimulai di sini, karena WhatsApp adalah cara tercepat untuk mempertemukan agent Anda dengan orang sungguhan. Bagi Kirana Group, artinya site supervisor dan staf lapangan bisa mengirim pesan ke Atlas dari ponsel mereka di lokasi proyek, tanpa membuka browser. Dalam beberapa menit Anda bisa menautkan nomor WhatsApp ke agent dan membuatnya menjawab pesan, tanpa akun provider apa pun. Halaman ini menjelaskan pilihan koneksi yang ada agar Anda bisa memilih salah satunya, lalu mengarahkan Anda ke tutorial langkah demi langkahnya.
Sebelum memulai
- Agent Anda sudah menjawab dengan baik di Preview dan sudah di-publish setidaknya sekali. Lihat Preview dan Publish Perubahan. Tab Published Configuration hanya berfungsi untuk agent yang sudah di-publish.
- Anda punya akses Owner atau Contributor ke agent di CMS.
- Anda punya nomor WhatsApp yang akan dihubungkan. Untuk opsi Qlar, ini cukup ponsel yang terpasang WhatsApp; untuk provider resmi, ini nomor WhatsApp Business yang terdaftar di provider tersebut.
Pilihan koneksi Anda
Buka Channels → WhatsApp di CMS. Jika belum ada nomor yang terhubung, wizard Connect WhatsApp meminta Anda memilih Protocol.
Ada dua kelompok pilihan:
- Qlar (Self-hosted) menautkan nomor WhatsApp biasa ke agent Anda, sama seperti WhatsApp Web menautkan komputer: Anda memindai kode QR dengan ponsel. Tanpa akun provider, key, atau webhook. Setelah Anda klik Next, Anda memilih di mana koneksi itu berjalan:
- Public server — recommended: Qlar menjalankan koneksi untuk Anda. Tidak ada yang perlu diunduh.
- Private — your own machine: Anda menjalankan aplikasi kecil Qlar Connector di komputer atau server Anda sendiri, sehingga sesi WhatsApp memakai alamat IP Anda sendiri.
- Meta Cloud, Coster, dan Qontak menghubungkan nomor WhatsApp Business yang terdaftar di salah satu provider resmi ini. Anda menyalin kredensial dari dashboard provider ke CMS dan mendaftarkan webhook.
Bandingkan pilihannya
| Public server | Private server | Meta Cloud, Coster, Qontak | |
|---|---|---|---|
| Usaha | Paling ringan: pilih, lalu pindai kode QR. | Ringan: unduh dan jalankan aplikasi, masukkan pairing code, pindai kode QR. | Paling berat: registrasi di provider, kredensial, dan webhook. |
| Yang Anda perlukan | Ponsel dengan WhatsApp. | Ponsel dengan WhatsApp, ditambah mesin Windows, macOS, atau Linux yang tetap menyala. | Nomor WhatsApp Business di provider dan akses ke dashboard-nya. |
| Siapa yang menjalankan koneksi | Qlar. | Anda (aplikasi Qlar Connector di mesin Anda). | Provider. |
| Biaya dan batasan | Channel yang di-host bisa diputus setelah sejumlah hari tanpa pesan yang dikirim agent. Bila ini berlaku, console menampilkan pemberitahuan berisi jumlah harinya. | Berjalan selama Connector Anda berjalan; menutup aplikasinya memutus WhatsApp. Tidak terkena pemutusan karena tidak aktif. | Mengikuti harga dan aturan provider masing-masing. |
| Pilih ini bila | Anda ingin live hari ini, atau baru pertama kali mencoba WhatsApp. | Anda ingin sesi berjalan di IP atau infrastruktur Anda sendiri. | Anda sudah memakai salah satu provider ini, atau memerlukan akun WhatsApp Business API resmi. |
Mulailah dengan Public server. Ini cara tercepat melihat agent Anda bekerja di WhatsApp, dan Anda bisa beralih nanti: hapus channel-nya lalu hubungkan lagi dengan opsi lain.
Pilih tutorial Anda
| Halaman | Pakai saat |
|---|---|
| Mulai Cepat: Public Server | Anda menginginkan jalur termudah. Disarankan untuk nomor pertama Anda. |
| Private Server | Anda ingin menjalankan koneksi sendiri dengan aplikasi Qlar Connector. |
| Meta Cloud | Nomor Anda ada di WhatsApp Business Platform milik Meta secara langsung. |
| Coster | Nomor Anda dikelola lewat Coster. |
| Qontak | Nomor Anda dikelola lewat Qontak. |
Setiap konfigurasi memuat satu nomor dengan satu protokol, jadi untuk setiap nomor Anda cukup mengikuti salah satu halaman tersebut.
Setelah nomor terhubung, dengan opsi mana pun, Anda juga bisa mengalihkannya ke Redirect to web: setiap pesan WhatsApp dijawab dengan tautan masuk sekali pakai, dan percakapan berlanjut di web chat agent. Lihat Alihkan ke Web Chat.
Memahami Dual Configuration
Setiap agent di qlar mendukung dua nomor WhatsApp yang berdiri sendiri sekaligus, satu untuk masing-masing versi agent Anda.
| Tab | Fungsi |
|---|---|
| Published Configuration | Nomor yang dipakai user live Anda. Terikat ke versi agent yang sudah di-publish (production). |
| Draft Configuration (Optional) | Nomor terpisah untuk pengujian internal. Terikat ke versi draft agent Anda, sehingga Anda bisa menguji perubahan tanpa memengaruhi user live. |
Draft Configuration bersifat opsional. Anda boleh membiarkannya kosong jika tidak butuh nomor khusus untuk pengujian. Setiap tab punya wizard sendiri, jadi kedua nomor bahkan bisa memakai protokol yang berbeda.
Tip: Dengan nomor draft yang terpisah, Anda bisa terus menyempurnakan perilaku agent dan menguji integrasi API baru tanpa risiko merusak percakapan yang sedang berlangsung di nomor production.
Menyimpan perubahan
Di form Meta Cloud, Coster, dan Qontak, setiap kartu menyimpan dirinya sendiri. Tidak ada tombol Save atau Update untuk seluruh layar.
| Yang Anda ubah | Cara menyimpannya |
|---|---|
| Connection & Credentials | Hanya bisa dibaca sampai Anda mengklik Edit. Lalu Save di bagian bawah kartu, atau Cancel untuk membatalkan editan. |
| Session Management | Save di bagian bawah kartu, atau Discard untuk mengembalikan nilai yang tersimpan. |
| Redirect to Web | Save di bagian bawah panel. Di Qontak tombolnya berbunyi Save & submit for review bila penyimpanan akan mengajukan template ke WhatsApp. |
| Switch Active, Reply Mode | Langsung tersimpan begitu diklik. |
Kartu yang punya editan belum tersimpan menampilkan Unsaved changes di samping tombolnya. Menyimpan satu kartu tidak pernah ikut mengirim yang masih Anda edit di kartu lain. Di tab Published Configuration, setiap penyimpanan meminta konfirmasi, karena langsung berlaku untuk agent live.
Bagian atas layar berisi aksi untuk seluruh channel: tombol Notifications, yang membuka template notifikasi, integrasi API, dan riwayat, serta menu ⋯ berisi Delete channel….
Session Management
Setelan ini berlaku untuk form Meta Cloud, Coster, dan Qontak. Setelah nomor Anda terhubung, gulir ke bagian Session Management di form konfigurasi. Setelan ini mengatur kapan qlar menganggap sebuah sesi percakapan sudah berakhir.
Catatan untuk Qontak: Bagian Session Management baru muncul setelah Anda berhasil mengklik Set Endpoint. Selesaikan langkah itu dulu sebelum mengatur setelan sesi.
Catatan untuk Redirect to web: Jika Reply Mode diatur ke Redirect to web, kartu Session Management disembunyikan, karena tidak ada AI yang menjawab di WhatsApp. Nilainya tetap tersimpan dan muncul kembali saat Anda beralih lagi ke AI agent. Lihat Alihkan ke Web Chat.
| Setelan | Default | Keterangan |
|---|---|---|
| Ask User to End Session | Aktif | Jika aktif, qlar meminta konfirmasi user sebelum menutup sesi, alih-alih mengakhirinya secara otomatis. |
| Delay Before Ask More (seconds) | 300 | Berapa detik tanpa aktivitas sebelum qlar menanyakan apakah user masih butuh bantuan. |
| Delay Before End Session (seconds) | 600 | Berapa detik setelah bertanya sebelum sesi ditutup secara otomatis. |
Sesuaikan nilainya dengan kebutuhan Anda, lalu klik Save di bagian bawah kartu Session Management.
Channel Qlar (Public atau Private server) menampilkan console, bukan form ini. Setelannya dijelaskan di Mulai Cepat: Public Server.
Periksa hasilnya
- Dari ponsel lain, kirim pesan WhatsApp ke nomor yang Anda hubungkan (pakai nomor draft jika Anda hanya mengatur Draft Configuration).
- Agent seharusnya membalas dalam beberapa detik, dengan jawaban sejenis yang diberikannya di Preview.
Jika agent tidak membalas, ikuti bagian "Periksa hasilnya" di tutorial opsi yang Anda pakai.
Langkah berikutnya
- Mulai sekarang: Mulai Cepat: Public Server.
- Berikutnya dalam jalur ini: Embed Chat ke Website, agar pengunjung website juga bisa mengobrol dengan agent Anda.
- Referensi field: WhatsApp di Help mencantumkan setiap setelan di layar ini.