Hubungkan Halo AI ke Konektor

Webhook adalah URL khusus yang dipakai Halo AI untuk mengirim data pesan dan rujukan iklan ke Konektor. Data tersebut membuat kontak baru dapat dicatat sebagai lead. Jika Anda juga ingin mengirim konversi Click-to-WhatsApp (CTWA) ke Meta, selesaikan pengaturan Meta secara terpisah setelah webhook aktif.

Sebelum mulai

Siapkan hal berikut:

• akses owner atau admin di workspace Konektor;
• akses ke pengaturan webhook di Halo AI;
• satu nomor WhatsApp untuk mengirim pesan uji.

Untuk pelacakan konversi CTWA, Anda juga memerlukan:

• Session WhatsApp di Konektor dengan nomor bisnis yang sama;
• akun Meta yang memiliki akses ke WhatsApp Business Account (WABA) tersebut;
• WABA ID untuk nomor bisnis tersebut.

WABA adalah akun bisnis yang menaungi nomor WhatsApp Anda di Meta. Saat Anda menghubungkan Meta, Konektor meminta Meta memilih dataset CTWA yang sudah terkait dengan WABA atau membuatnya jika belum tersedia. Anda tidak perlu mencari atau memasukkan Dataset ID.

Hubungkan webhook Halo AI

1. Buat integrasi Halo AI

1. Masuk ke Konektor, lalu buka Integrations.
2. Buka halaman integrasi partner.
3. Pilih + Tambah Integrasi.
4. Pilih Halo AI.
5. Isi Nama Integrasi, misalnya Halo AI - Toko Contoh.
6. Pilih Hubungkan.

Konektor tidak meminta API key Halo AI pada tahap ini.

2. Salin URL webhook

1. Cari kartu integrasi Halo AI yang baru dibuat.
2. Pilih Lihat Webhook URL.
3. Salin URL yang ditampilkan.

URL tersebut khusus untuk workspace Anda dan harus dirahasiakan. Jangan memasukkannya ke dokumentasi, tiket publik, atau pesan yang dapat dibaca orang lain.

3. Pasang webhook di Halo AI

1. Buka pengaturan webhook pada akun Halo AI Anda. Nama menunya dapat berbeda menurut tampilan Halo AI yang digunakan.
2. Tambahkan webhook untuk pesan WhatsApp masuk.
3. Tempel URL dari Konektor.
4. Simpan perubahan.

Periksa apakah lead sudah masuk

1. Kirim satu pesan baru dari nomor uji ke nomor WhatsApp bisnis Anda.
2. Buka menu Leads di Konektor.
3. Pastikan kontak dari pesan uji muncul sebagai lead.
4. Kembali ke kartu integrasi Halo AI dan periksa Sync terakhir.

Webhook bekerja jika lead baru muncul dan waktu Sync terakhir diperbarui. Status Terhubung pada kartu hanya menunjukkan bahwa konfigurasi integrasi sudah dibuat; status itu tidak membuktikan bahwa Halo AI telah mengirim pesan.

Aktifkan pelacakan konversi CTWA

Lewati bagian ini jika Anda tidak menjalankan iklan Click-to-WhatsApp. Webhook Halo AI dapat membawa ID klik dari iklan, tetapi tidak memberi Konektor izin untuk mengirim event ke Meta. Izin tersebut diperoleh saat WABA dihubungkan.

Siapkan akses dan WABA ID

Pastikan akun Meta yang akan digunakan memiliki akses ke WABA. Siapkan WABA ID untuk nomor bisnis tersebut, misalnya 123456789012345.

Nilai tersebut hanya contoh. Jangan menyalinnya ke workspace Anda. Minta admin portofolio bisnis Meta atau partner WhatsApp memberikan WABA ID yang menaungi nomor Anda jika Anda belum memilikinya.

Hubungkan WABA di Konektor

1. Di Konektor, buka WhatsApp > Sessions.
2. Cari Session dengan nomor yang sama dengan nomor bisnis di Halo AI.
3. Pilih ikon pensil untuk mengedit Session.
4. Isi WhatsApp Business Account ID dengan WABA ID.
5. Pilih Hubungkan Meta.
6. Login ke Meta dengan akun yang memiliki akses ke WABA, lalu setujui izin yang diminta.

Jika berhasil, Konektor menampilkan status CTWA terkonfigurasi. Meta memilih atau membuat dataset CTWA yang terkait dengan WABA, lalu Konektor menyimpan Dataset ID tersebut secara otomatis. Status ini memastikan konfigurasi tersimpan di Konektor, tetapi belum membuktikan bahwa Meta telah menerima event.

Uji satu konversi CTWA

1. Buka iklan CTWA Anda sebagai calon pelanggan, lalu kirim pesan baru.
2. Pastikan pesan tersebut membuat lead baru di Konektor.
3. Catat satu konversi untuk lead tersebut.
4. Buka menu Conversion. Koneksi CTWA yang siap menampilkan business_messaging; fallback sementara tampil sebagai pengiriman chat biasa.
5. Buka Meta Events Manager. Periksa dataset CTWA untuk pengiriman business_messaging, atau dataset Meta default untuk fallback chat sementara.

Setelah event baru berhasil, Anda dapat mencoba ulang konversi lama yang sebelumnya dilewati. Lakukan satu per satu agar hasilnya mudah diperiksa.

Mengatasi masalah

Lead tidak masuk

1. Pastikan URL webhook di Halo AI sama dengan URL yang ditampilkan oleh Lihat Webhook URL.
2. Pastikan webhook Halo AI aktif untuk pesan masuk.
3. Kirim pesan baru; pesan lama tidak memicu pengujian baru.
4. Periksa apakah Sync terakhir berubah dan apakah lead muncul.

Jika keduanya tidak berubah, hubungi Support dan sertakan waktu pengujian serta nama integrasi. Jangan kirim URL webhook lengkap.

Konversi CTWA terkirim sebagai chat atau dilewati

Konektor memakai event chat biasa saat koneksi CTWA khusus belum siap. Konversi tetap terkirim, tetapi belum mendapat atribusi business messaging khusus CTWA. Entri lama mungkin masih berstatus dilewati karena diproses sebelum fallback tersedia.

Pastikan lead berasal dari pesan baru melalui iklan CTWA. Setelah itu, pastikan WABA ID terisi dan status Session menunjukkan CTWA terkonfigurasi agar konversi baru memakai business messaging.

Jika konfigurasi baru saja diperbaiki, buat satu konversi baru sebelum mencoba ulang event lama.

WABA gagal dihubungkan ke dataset

Jika muncul pesan Failed to connect WABA to dataset, jangan menekan tombol berulang kali. Periksa kembali bahwa:

• akun Meta Anda memiliki akses ke WABA;
• WABA ID berasal dari akun bisnis yang benar;
• permintaan izin Meta disetujui sampai selesai.

Jika ketiganya sudah benar, hubungi Support. Sertakan nama Session dan waktu percobaan, tetapi jangan kirim token, kata sandi, atau URL webhook.

Tidak ada Session dengan nomor yang sama

CTWA belum dapat dihubungkan sendiri dari halaman integrasi Halo AI. Hubungi Support agar nomor dan kepemilikan WABA dapat diperiksa. Jangan membuat Session tidak resmi hanya untuk melewati langkah ini.

WABA dikelola oleh Halo AI atau partner lain

Penggunaan partner tidak menggantikan izin Meta. Minta partner atau admin portofolio bisnis Meta (Business Portfolio) memberikan akses yang diperlukan ke akun Meta Anda dan memastikan WABA ID. Meta akan memilih atau membuat dataset CTWA saat Anda menghubungkan akun. Jika akses tidak dapat diberikan, minta partner berkoordinasi dengan Support Konektor sebelum Anda mencoba menghubungkan WABA.

Panduan terkait

• Pelacakan konversi Click-to-WhatsApp
• Meta Conversions API
• Automation WhatsApp