Hubungkan Meta CTWA dengan Token App Meta

Gunakan jalur sementara ini jika workspace Anda menampilkan metode Token App Meta. Jalur ini menghubungkan Session WhatsApp ke dataset Click-to-WhatsApp (CTWA) melalui Meta App milik bisnis Anda.

Jika workspace memakai Direct Chat, pengaturan ini hanya mengirim data konversi CTWA. Direct Chat tetap mengelola percakapan, kontak, pesan, template, dan inbox Anda.

Sebelum mulai

Siapkan hal berikut:

• akses owner atau admin di workspace Konektor;
• Meta App yang dimiliki bisnis Anda dan terhubung ke Business Portfolio yang benar;
• use case WhatsApp dan Marketing API pada Meta App tersebut;
• akses ke WhatsApp Business Account (WABA) yang menaungi nomor pada Session;
• WABA ID numerik untuk nomor tersebut;
• token dengan izin whatsapp_business_management dan whatsapp_business_manage_events.

WABA dan Meta App harus berada dalam kendali bisnis Anda. Pengguna Meta atau System User yang membuat token juga harus memiliki akses ke App dan WABA tersebut.

Anda tidak perlu mencari atau memasukkan Dataset ID. Konektor meminta Meta memilih dataset WABA yang ada atau membuatnya saat koneksi diverifikasi.

Pilih token untuk pengujian atau produksi

Gunakan token pengguna dari Graph API Explorer hanya untuk pengujian terbatas. Token tersebut dapat kedaluwarsa atau berhenti bekerja saat akses pengguna berubah.

Gunakan token System User untuk pemakaian produksi yang berlanjut. Berikan System User akses hanya ke Meta App dan WABA yang diperlukan, lalu buat token dengan kedua izin CTWA.

Siapkan Meta App dan akses WABA

Nama menu Meta dapat berubah. Gunakan fungsi menu yang setara jika tampilan akun Anda berbeda.

1. Buka Meta for Developers, lalu buat atau gunakan App bisnis milik bisnis Anda.
2. Hubungkan App ke Business Portfolio yang memiliki atau mengelola WABA.
3. Tambahkan use case WhatsApp dan Marketing API pada App.
4. Berikan pengguna atau System User akses ke App dan WABA yang sesuai.
5. Buat token dengan whatsapp_business_management dan whatsapp_business_manage_events.
6. Buka WhatsApp Manager, lalu salin WABA ID untuk nomor WhatsApp yang digunakan.

Contoh format WABA ID: 100000000000001. Contoh ini fiktif dan tidak boleh digunakan pada workspace Anda.

Meta dapat meminta pengaturan tambahan sesuai jenis App dan aset bisnis Anda. Konektor memeriksa kedua izin, akses WABA, dan dataset sebelum menyimpan koneksi.

Simpan Session sebelum menyiapkan CTWA

1. Buka WhatsApp > Sessions.
2. Buat Session baru atau lengkapi Session untuk nomor WhatsApp yang digunakan.
3. Pilih Simpan sebelum Anda membuka pengaturan CTWA.

Setiap Session harus menggunakan WABA ID yang menaungi nomor tersebut. Jangan memakai Pixel ID, Dataset ID, atau WABA ID dari bisnis lain.

Hubungkan token pada Konektor

1. Pada baris Session yang sudah disimpan, pilih Siapkan CTWA. Pilih Kelola CTWA jika Session pernah dihubungkan.
2. Isi WhatsApp Business Account ID dengan WABA ID numerik pada modal CTWA.
3. Pilih Token App Meta.
4. Tempel token pada kolom Token App Meta.
5. Pilih Verifikasi & hubungkan.

Konektor memeriksa kedua izin, kepemilikan akses WABA, dan dataset sebelum menyimpan token. Jika token baru gagal saat penggantian, koneksi lama tetap digunakan.

Anda tidak perlu membuka Edit Session untuk menyimpan WABA ID. Modal CTWA memverifikasi dan menyimpan WABA ID bersama koneksi dalam satu proses.

Koneksi lokal siap saat Session menampilkan Siap - Token manual dan Dataset CTWA siap. Status tersebut belum membuktikan bahwa Meta telah menerima atau mengatribusikan event.

Gunakan token tersimpan untuk Session lain

Gunakan metode ini jika satu token yang sudah terhubung dapat mengakses WABA lain dalam workspace yang sama.

1. Pilih Siapkan CTWA pada Session berikutnya.
2. Isi WhatsApp Business Account ID untuk nomor pada Session tersebut.
3. Pilih Gunakan token tersimpan.
4. Pilih Verifikasi & hubungkan.

Konektor memeriksa ulang token terhadap WABA baru. Konektor juga memeriksa WABA lain yang memakai konektor tersebut sebelum menyimpan perubahan.

Metode ini tidak menampilkan atau mengirim ulang token ke browser. Jika token tidak dapat mengakses WABA baru, koneksi lama tetap tersedia.

Periksa tiga bukti yang berbeda

Jangan gabungkan tiga hasil berikut:

1. Konfigurasi lokal siap. Session menampilkan Siap - Token manual. Konektor telah memvalidasi dan menyimpan koneksi.
2. Meta menerima event CTWA khusus. Session menampilkan Meta menerima event CTWA, dan Log Sinkronisasi menampilkan baris Meta CTWA dengan status accepted.
3. Ads Manager melaporkan atau mengatribusikan konversi. Periksa hasil ini secara terpisah di Meta Ads Manager.

Konektor dapat membuktikan hasil pertama dan kedua. Penerimaan oleh Meta Graph tidak menjamin Ads Manager akan melaporkan atau mengatribusikan konversi.

Baca jalur dan status pengiriman

Tab Log Sinkronisasi pada menu Konversi menunjukkan jalur dan status secara terpisah. Badge menunjukkan jalur. Badge tersebut bukan bukti penerimaan:

• Meta CTWA: Konektor mencoba jalur khusus CTWA ke dataset WABA.
• CTWA fallback: Konektor mencoba jalur fallback Meta CAPI untuk event CTWA.
• Meta CAPI: Konektor mencoba pengiriman Meta biasa yang bukan pengiriman khusus CTWA.

Periksa status pada baris yang sama. Hanya baris Meta CTWA dengan status accepted yang membuktikan bahwa Meta menerima event khusus.

Tombol Kirim Ulang sebagai Meta CTWA 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.

Periksa, ganti, atau putuskan koneksi

Buka WhatsApp > Sessions, lalu pilih Kelola CTWA.

• Pilih Periksa koneksi untuk memvalidasi izin dan aset kembali. Tindakan ini tidak mengirim event pembelian uji.
• Pilih Ganti token untuk memverifikasi token baru sebelum mengganti token aktif.
• Pilih Putuskan CTWA untuk melepas koneksi dari Session tersebut.

Memutuskan CTWA di Konektor tidak mencabut token di Meta. Cabut token melalui pengaturan bisnis Meta jika token tidak boleh digunakan lagi.

Pindah ke Login Meta nanti

Workspace pilot yang memakai Direct Chat tidak menampilkan Login Meta. Gunakan Token App Meta atau Gunakan token tersimpan selama pilot berlangsung.

Setelah Login Meta tersedia untuk bisnis Anda, buka Kelola CTWA dan pilih Ganti token. Pilih Login Meta, lalu lanjutkan dengan Login dengan Meta.

Konektor mempertahankan token manual selama koneksi OAuth baru belum lolos verifikasi. Jika migrasi gagal, koneksi manual lama tetap aktif. Setelah migrasi berhasil, Session menampilkan Siap - Login Meta.

Mengatasi masalah

Token tidak valid atau kedaluwarsa

Buat token baru pada App bisnis yang benar. Pastikan token berasal dari pengguna atau System User yang masih memiliki akses ke WABA.

Token belum memiliki kedua izin CTWA

Buat ulang token dengan whatsapp_business_management dan whatsapp_business_manage_events. Pastikan App memiliki use case WhatsApp dan Marketing API.

WABA tidak tersedia

Periksa bahwa WABA ID hanya berisi angka. Pastikan WABA menaungi nomor pada Session dan dapat diakses oleh pembuat token.

Event menampilkan CTWA fallback

Pilih Kelola CTWA, lalu jalankan Periksa koneksi. Buat satu konversi baru setelah koneksi siap sebelum mencoba ulang fallback lama yang memenuhi syarat.

Dukungan perlu memeriksa kegagalan

Kirim nama Session, waktu percobaan, dan pesan aman yang tampil di Konektor. Jangan kirim token, WABA ID lengkap, Dataset ID, URL pribadi, atau tangkapan layar yang memuat rahasia.

Panduan terkait

• Pantau pengiriman pada Dashboard Konversi
• Siapkan Meta Conversions API untuk event biasa
• Hubungkan Halo AI dan siapkan CTWA
• Pahami pelacakan konversi Click-to-WhatsApp