Meta Cloud

Buka di CMS

Tutorial ini memandu Anda menghubungkan agent qlar ke nomor WhatsApp Business menggunakan Meta Cloud (WhatsApp Business Platform milik Meta sendiri).

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 Meta Cloud sebagai provider WhatsApp Business. Jika Anda hanya ingin agent cepat hadir di WhatsApp, Mulai Cepat: Public Server tidak memerlukan akun provider.

Dari sisi Meta Cloud, pastikan Anda punya:

  • Akun Meta Business Suite dengan bisnis yang sudah terverifikasi.
  • Akun Meta Developer di developers.facebook.com.
  • Sebuah Meta App yang sudah ditambahi produk WhatsApp (use case WhatsApp Business).
  • Nomor WhatsApp Business yang sudah terdaftar dan disetujui di Meta App Anda.
  • Akses ke nilai-nilai berikut di Meta Developer Console:
    • Account ID
    • App Secret
    • WhatsApp Number ID (Meta menyebutnya Phone Number ID)
    • Access Token (token permanen atau berumur panjang)

Tip: CMS menunjukkan letak setiap nilai. Klik ikon info (ⓘ) di samping Account ID, App Secret, atau Access Token untuk melihat penjelasan singkat dan gambar panduan layar Meta.


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 Meta Cloud.
  2. Di field Phone Number, masukkan nomor WhatsApp Business Anda yang diawali kode negara, tanpa + atau spasi. Untuk Kirana nomornya 6281200000000.
  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, jadi lanjutkan ke langkah berikutnya.

Layar konfigurasi Meta Cloud setelah mengklik Next: label Meta Cloud, switch Active, tombol Notifications yang masih abu-abu, dan menu titik tiga di atas; kartu Connection & Credentials dengan tombol Edit, Phone Number 6281200000000, Webhook Secret yang disamarkan, blok teks berisi Phone Number dan URL Webhook Configuration https://api.qlar.ai/messenger/api/MetaCloud/Webhook/6281200000000 untuk dikirim ke provider, dan di bawah API Credentials field yang masih kosong, yaitu Account ID, App Secret, WhatsApp Number ID, dan Access Token; Reply Mode dengan AI agent terpilih dan Redirect to web; Session Management dengan Ask User to End Session aktif, Delay Before Ask More 300 detik, Delay Before End Session 600 detik, serta tombol Discard dan Save

Layar ini punya tiga kartu:

KartuIsinya
Connection & CredentialsPhone Number (hanya baca), Webhook Secret, blok teks berisi detail untuk mendaftarkan webhook, dan di bawah API Credentials ada Account ID, App Secret, WhatsApp Number ID, dan Access Token. Semuanya wajib dan disimpan terenkripsi. Kartu ini hanya bisa dibaca sampai Anda mengklik Edit.
Reply ModeAI agent (agent menjawab di WhatsApp) atau Redirect to web.
Session ManagementKapan percakapan yang tidak aktif diakhiri.

Jika nomor yang Anda masukkan salah, buka menu ⋯, pilih Delete channel…, lalu mulai wizard lagi. Nomor telepon tidak bisa diubah setelahnya.


Langkah 3: Isi API credentials

Klik Edit di kanan atas kartu Connection & Credentials. Field-nya bisa diisi, dan tombol Cancel serta Save muncul di bagian bawah kartu. Di bawah API Credentials, salin setiap nilai dari Meta Developer Console:

  1. Account ID: ID yang tampil di bagian Generate Access Token pada setelan use case WhatsApp Business milik app Anda.
  2. App Secret: di bagian pertama setelan use case WhatsApp Business yang sama. Field ini disamarkan; klik ikon mata untuk memeriksa yang Anda tempelkan.
  3. WhatsApp Number ID: Phone Number ID dari nomor WhatsApp Business Anda, di WhatsApp → API Setup.
  4. Access Token: token yang Anda buat di bagian Generate Access Token. Pakai token permanen atau berumur panjang, karena token sementara berhenti berfungsi setelah waktu singkat.
  5. 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.
  6. 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.


Langkah 4: Atur webhook di dashboard Meta App

qlar membutuhkan Meta untuk meneruskan pesan masuk ke server qlar. Ini dilakukan lewat webhook.

  1. Di kartu Connection & Credentials, Webhook Secret sudah terisi. Klik ikon mata untuk menampilkannya dan tombol copy untuk menyalinnya. Untuk membuat secret baru, klik Edit, lalu ikon refresh di samping label, lalu Save.
  2. Di bawah field, qlar menampilkan blok teks berisi Phone Number dan URL Webhook Configuration Anda, untuk Kirana https://api.qlar.ai/messenger/api/MetaCloud/Webhook/6281200000000. Pakai tombol copy di pojok blok untuk menyalin keduanya. Jika Meta App Anda dikelola orang lain, kirimkan blok ini kepadanya lewat email.
  3. Di dashboard Meta App, buka WhatsApp → Configuration → Webhook.
  4. Klik Edit dan isi field-nya:
    • Callback URL: tempelkan URL Webhook Configuration dari qlar.
    • Verify Token: tempelkan Webhook Secret dari qlar.
  5. Klik Verify and Save. Meta mengirim permintaan verifikasi ke qlar.
  6. Di Webhook Fields, subscribe setidaknya ke messages agar qlar menerima pesan masuk dari user.

Peringatan: Jangan bagikan Webhook Secret secara publik. Jika secret bocor, buat ulang di qlar dan klik Save, lalu segera perbarui Verify Token di Meta App Anda.


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. Lihat WhatsApp di Bantuan untuk 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 semua field wajib tersimpan, 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, semua field di bawah API Credentials sudah terisi dan tersimpan, Callback URL dan Verify Token persis sama antara qlar dan dashboard Meta App Anda, dan field webhook messages sudah di-subscribe.


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 nomor uji terpisah jika Anda ingin lingkungan yang aman untuk menguji perubahan.
  • Memakai opsi lain untuk nomor lain? Lihat Mulai Cepat: Public Server, Coster atau Qontak.
  • Session Management: lihat Menghubungkan ke WhatsApp untuk mengatur kapan sesi percakapan berakhir.