Hubungkan HaloAI ke Konektor

HaloAI menghubungkan nomor Anda lewat WhatsApp Business API (WABA). Karena itu pengaturan ini meminta WABA ID.

Webhook adalah URL khusus yang dipakai HaloAI 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 HaloAI;
• satu nomor WhatsApp untuk mengirim pesan uji.

Untuk pelacakan konversi CTWA, Anda juga memerlukan:

• nomor bisnis yang sama sudah terhubung lewat HaloAI di Konektor;
• 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 HaloAI

1. Buat integrasi HaloAI

1. Masuk ke Konektor.
2. Buka Pengaturan > Lainnya > Integrasi.
3. Cari kartu HaloAI.
4. Klik kartu Halo AI di bagian Tersedia untuk dihubungkan.
5. Isi Nama Integrasi, misalnya HaloAI - Toko Contoh.
6. Pilih Hubungkan.

Konektor tidak meminta API key HaloAI pada tahap ini.

2. Salin URL webhook

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

Salin URL secara utuh, termasuk bagian ?secret=. Bagian itu adalah kunci pribadi integrasi Anda. 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 HaloAI

1. Buka pengaturan webhook pada akun HaloAI Anda. Nama menunya dapat berbeda menurut tampilan HaloAI 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 HaloAI dan periksa Sinkron terakhir.

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

Aktifkan pelacakan konversi CTWA

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

1. Pastikan akun Facebook Anda adalah admin bisnis yang memiliki WABA untuk nomor HaloAI.
2. Setelah koneksi HaloAI berhasil, klik Siapkan CTWA untuk nomor ini. Atau buka Koneksi > Nomor & CTWA, lalu klik Pakai nomor yang sudah terhubung.
3. Pilih Siapkan CTWA pada nomor itu. Pilih Kelola CTWA jika nomor pernah dihubungkan.
4. Isi WhatsApp Business Account ID pada panel CTWA.
5. Klik Login dengan Meta. Login Meta adalah metode utama.
6. Di dialog Meta, centang bisnis dan akun WhatsApp nomor ini.

Ikuti panduan Meta CTWA untuk langkah lengkap, pemutusan, dan penggantian koneksi.

Uji satu konversi CTWA

1. Buka iklan CTWA sebagai calon pelanggan, lalu kirim pesan baru.
2. Pastikan pesan membuat lead baru di Konektor.
3. Catat satu konversi untuk lead tersebut.
4. Buka Iklan & Konversi > Konversi, tab Log pengiriman, dan periksa jalur serta status pengiriman.

Badge Meta CTWA menunjukkan jalur khusus CTWA. Badge tersebut bukan bukti penerimaan. Status Terkirim pada baris Meta CTWA membuktikan bahwa Meta menerima event khusus. Badge CTWA cadangan menunjukkan jalur cadangan lewat Meta CAPI. Hasil tersebut tidak membuktikan bahwa Ads Manager sudah melaporkan atau mengatribusikan konversi.

Mengatasi masalah

Lead tidak masuk

1. Pastikan URL webhook di HaloAI sama dengan URL yang ditampilkan oleh Lihat Webhook URL.
2. Pastikan webhook HaloAI aktif untuk pesan masuk.
3. Kirim pesan baru; pesan lama tidak memicu pengujian baru.
4. Periksa apakah Sinkron terakhir berubah dan apakah lead muncul.
5. Jika integrasi dibuat sebelum 22 Oktober 2026, salin lagi URL dari Lihat Webhook URL. Ganti URL lama di HaloAI dengan URL baru yang berisi ?secret=. URL lama tanpa kunci akan berhenti diterima.

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

Konversi menampilkan CTWA cadangan atau Dilewati

Konektor memakai jalur cadangan lewat Meta CAPI saat koneksi CTWA khusus belum siap. Entri lama juga dapat tetap berstatus Dilewati jika diproses sebelum jalur cadangan tersedia. Uji tanpa klik iklan Meta juga tampil Dilewati karena Mode ketat. Hasil itu wajar.

Pastikan lead berasal dari pesan baru melalui iklan CTWA. Buka Koneksi > Nomor & CTWA > Kelola CTWA, lalu pilih Periksa koneksi.

Jika konfigurasi baru saja diperbaiki, buat satu konversi baru. Pengiriman ulang mengikuti aturan berikut:

• Baris CTWA cadangan dengan status Terkirim atau Gagal dapat memenuhi syarat.
• Baris Meta CTWA dengan status akhir Gagal dapat memenuhi syarat.
• Baris yang masih Antre tidak memenuhi syarat.
• Baris Meta CTWA yang sudah Terkirim memblokir pengiriman khusus duplikat untuk event dan dataset yang sama.
• Baris Meta CAPI biasa tidak menawarkan pengiriman ulang CTWA.

WABA gagal dihubungkan ke dataset

Jika Konektor menyatakan WABA atau dataset tidak tersedia, jangan menekan tombol berulang kali. Periksa kembali bahwa:

• akun Meta Anda memiliki akses ke WABA;
• WABA ID berasal dari akun bisnis yang benar;
• akun Facebook yang login memiliki akses ke WABA tersebut.

Jika ketiganya sudah benar, hubungi Support. Sertakan nama nomor, waktu percobaan, dan pesan aman yang tampil. Jangan kirim token, kata sandi, WABA ID lengkap, Dataset ID, atau URL webhook.

Nomor tidak muncul di Nomor & CTWA

Buka Koneksi > Nomor & CTWA, lalu klik Pakai nomor yang sudah terhubung. Jika nomor HaloAI tidak ada di daftar, hubungi Support agar nomor dan kepemilikan WABA dapat diperiksa. Jangan membuat Sesi QR hanya untuk melewati langkah ini.

WABA dikelola oleh HaloAI 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
• Siapkan Meta CTWA dengan Login Meta
• Meta Conversions API
• Aturan Otomatisasi