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.

1. Pastikan Meta App milik bisnis Anda dan pembuat token memiliki akses ke WABA yang menaungi nomor Halo AI.
2. Buka WhatsApp > Sessions, lalu buat atau lengkapi Session dengan nomor yang sama.
3. Pilih Simpan.
4. Pilih Siapkan CTWA pada baris Session yang sudah disimpan. Pilih Kelola CTWA jika Session pernah dihubungkan.
5. Isi WhatsApp Business Account ID pada modal CTWA.
6. Pilih Token App Meta, tempel token pada modal aman, lalu pilih Verifikasi & hubungkan.

Gunakan token System User untuk pemakaian produksi yang berlanjut. Gunakan token Graph API Explorer hanya untuk pengujian terbatas. Jangan kirim token melalui chat, email, tiket support, dokumentasi, atau tangkapan layar.

Ikuti panduan koneksi Meta CTWA untuk prasyarat App, kedua izin yang diperlukan, rotasi, pemutusan, dan migrasi ke Login Meta.

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 Konversi > Log Sinkronisasi dan periksa jalur serta status pengiriman.

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

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 menampilkan CTWA fallback atau dilewati

Konektor memakai fallback Meta CAPI saat koneksi CTWA khusus belum siap. Entri lama juga dapat tetap berstatus dilewati jika diproses sebelum fallback tersedia.

Pastikan lead berasal dari pesan baru melalui iklan CTWA. Buka WhatsApp > Sessions > Kelola CTWA, lalu pilih Periksa koneksi.

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

• Baris CTWA fallback dengan status accepted atau failed dapat memenuhi syarat.
• Baris Meta CTWA dengan status akhir failed dapat memenuhi syarat.
• Baris yang masih queued, sending, atau retry tidak memenuhi syarat.
• Baris Meta CTWA yang sudah accepted 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;
• token memiliki kedua izin CTWA yang dijelaskan dalam panduan Meta CTWA.

Jika ketiganya sudah benar, hubungi Support. Sertakan nama Session, waktu percobaan, dan pesan aman yang tampil. Jangan kirim token, kata sandi, WABA ID lengkap, Dataset ID, 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
• Hubungkan Meta CTWA dengan Token App Meta
• Meta Conversions API
• Automation WhatsApp