Your AI Connector Docs

Hubungkan Aplikasi Meta Anda Sendiri

Jalankan WhatsApp melalui aplikasi Meta Anda sendiri dan bayar Meta langsung dengan tarif mereka sendiri. Your AI Connector tidak menambahkan biaya per pesan pada koneksi ini, dan tidak ada akun Twilio di tengahnya. Karena akun WhatsApp tersebut adalah milik Anda, klien Anda hanya akan melihat nama bisnis Anda.

Ini adalah opsi koneksi WhatsApp yang paling teknis — Anda akan membuat aplikasi di dalam situs pengembang Meta dan menyalin empat nilai kembali ke Your AI Connector. Luangkan waktu sekitar 20 menit. Jika itu terdengar lebih rumit dari yang Anda inginkan, koneksi WhatsApp Business terkelola tetap menjadi cara termudah untuk memulai.

Apa yang Anda butuhkan

  • Akses ke akun Meta Business Manager Anda.
  • Nomor telepon yang belum digunakan di aplikasi WhatsApp.
  • Sekitar 20 menit.

Bagian 1 — Siapkan aplikasi Anda di Meta

Lakukan langkah-langkah ini di sisi Meta terlebih dahulu. Anda akan mengumpulkan empat nilai selama proses ini: App ID, App secret, Access token, dan WhatsApp account ID.

1. Buat aplikasi

Buka developers.facebook.com, buka My Apps dan tekan Create App. Pilih tipe Business dan beri nama apa saja — nama tersebut hanya terlihat oleh Anda.

2. Tambahkan WhatsApp ke aplikasi

Di dasbor aplikasi, temukan WhatsApp dalam daftar produk dan tekan Set up. Meta membuat akun WhatsApp uji coba dengan nomor uji coba gratis sehingga Anda dapat mencoba berbagai hal sebelum menghubungkan nomor asli.

3. Aktifkan izin WhatsApp

Ini adalah langkah yang dilewati oleh sebagian besar panduan, dan melewatkannya adalah alasan paling umum mengapa koneksi gagal nantinya.

Di aplikasi Anda, buka App Review, lalu Permissions and Features. Cari whatsapp_business_management. Jika tertulis No access, tekan Get standard access — Meta akan meminta Anda memasukkan kembali kata sandi dan memberikannya saat itu juga. Tidak ada masa tunggu dan tidak ada peninjauan aplikasi; ini hanya satu tombol.

whatsapp_business_messaging biasanya sudah memiliki akses Standard. Kedua izin harus menunjukkan Standard access sebelum langkah berikutnya, jika tidak, token yang Anda buat akan kehilangan salah satunya.

4. Buat pengguna sistem

Di Meta Business Settings, buka Users, lalu System users. Tambahkan satu dan berikan akses admin ke aplikasi Anda dan akun WhatsApp Anda.

5. Buat token untuk pengguna tersebut

Pilih pengguna sistem tersebut dan tekan Generate token. Pilih aplikasi Anda, pilih token yang tidak pernah kedaluwarsa, dan centang whatsapp_business_messaging serta whatsapp_business_management. Meta hanya menampilkan token tersebut satu kali — segera salin token itu.

6. Temukan ID akun WhatsApp Anda

Di Business Settings, buka Accounts, lalu WhatsApp accounts, dan pilih akun Anda. Angka panjang di bawah namanya adalah ID tersebut.

App ID dan App secret Anda ada di App settings aplikasi, lalu Basic. Tekan Show di sebelah App secret untuk menampilkannya.

Bagian 2 — Hubungkan di Your AI Connector

Buka Pengaturan, lalu Saluran, temukan kartu WhatsApp Business API, dan tekan Hubungkan WhatsApp. Pilih Gunakan nomor yang sudah Anda miliki, lalu Aplikasi Meta Anda sendiri. Wizard akan terbuka pada ringkasan singkat — tekan Mulai penyiapan.

  1. Detail Anda. Langkah ini mengulangi lima langkah di sisi Meta dari Bagian 1 di samping formulir untuk empat nilai Anda. Tempelkan App ID, App secret, Access token, dan WhatsApp account ID persis seperti yang ditampilkan Meta, tanpa spasi tambahan, lalu tekan Check my details. Tidak ada yang disimpan sampai semuanya berfungsi — Your AI Connector memeriksanya dengan Meta terlebih dahulu.
  1. Pilih nomor untuk dihubungkan. Wizard mencantumkan setiap nomor di akun WhatsApp Anda, masing-masing dengan peringkat kualitas dari Meta. Pilih nomor yang akan digunakan ruang kerja ini untuk mengirim dan menerima pesan, lalu tekan Connect this number.
  1. Aktivasi dan pengiriman. Your AI Connector mengaktifkan nomor untuk Cloud API dan mendaftarkan webhook-nya ke Meta secara otomatis, sehingga pesan masuk akan sampai ke kotak masuk Anda — dalam banyak kasus, Anda akan langsung diarahkan ke kartu koneksi dengan konfirmasi “Nomor terhubung”. Jika langkah otomatis tidak dapat diselesaikan, wizard akan menampilkan URL callback dan token verifikasi dengan tombol salin, serta memandu Anda untuk menambahkannya sendiri di Meta; nilai yang sama akan tetap terlihat pada kartu koneksi jika sewaktu-waktu Meta meminta Anda untuk memasukkannya kembali.
  2. Wizard memeriksa koneksi itu sendiri. Pada langkah terakhir, sistem akan memverifikasi pengaturan secara otomatis — Anda tidak perlu menunggu. Setelah kartu menunjukkan status terhubung, kirimkan pesan WhatsApp ke diri sendiri dari ponsel lain dan lihat pesan tersebut masuk ke obrolan Anda: percakapan pada nomor tersebut kini mengalir seperti saluran lainnya, dan agen AI Anda dapat membalasnya. Jika pemeriksaan menemukan sesuatu yang masih diperlukan oleh Meta (misalnya verifikasi nomor), kartu akan memberi tahu Anda secara spesifik apa yang kurang, dan Verifikasi koneksi akan menjalankan pemeriksaan kembali setelah Anda memperbaikinya.

Anda dapat kembali ke halaman yang sama kapan saja untuk memeriksa status koneksi, Hubungkan kembali dengan detail baru, atau tekan Putuskan koneksi — nomor Anda, akun Meta Anda, dan penagihan Anda tetap menjadi milik Anda.

Hal yang perlu diketahui

  • Jendela 24 jam berlaku, seperti pada setiap koneksi WhatsApp Business. Anda selalu dapat membalas secara bebas kepada orang yang mengirim pesan kepada Anda dalam 24 jam terakhir. Di luar jendela tersebut, WhatsApp hanya mengizinkan bisnis untuk memulai percakapan dengan templat pesan yang disetujui — pesan teks biasa akan diterima oleh Meta tetapi tidak akan dikirim.
  • Meta menagih Anda secara langsung untuk percakapan dengan tarif negara yang mereka publikasikan, pada metode pembayaran yang terlampir di akun WhatsApp Anda di Meta. Your AI Connector tidak mengenakan biaya per pesan pada koneksi ini; penggunaan AI ditagih dalam kredit seperti biasa.
  • Simpan metode pembayaran yang valid di akun WhatsApp tersebut. Tanpa metode pembayaran, Meta memblokir setiap percakapan yang dimulai oleh bisnis Anda — siaran, kampanye, dan pesan templat apa pun — serta menampilkan kesalahan di WhatsApp Manager. Pada koneksi ini, siaran atau kampanye menolak untuk diluncurkan jika hal tersebut terjadi, dan meminta Anda untuk menambahkan metode pembayaran alih-alih gagal pesan demi pesan. Balasan kepada orang yang mengirim pesan kepada Anda terlebih dahulu tetap terkirim untuk saat ini, tetapi mulai 1 Oktober 2026 Meta juga akan mengenakan biaya untuk pesan tersebut, sehingga akun tanpa metode pembayaran yang berfungsi akan benar-benar senyap pada tanggal tersebut. Gambaran lengkapnya ada di WhatsApp Costs & the October 2026 Change.
  • Estimasi biaya Anda terlihat berbeda di sini. Karena biaya ini tidak pernah memotong kredit Anda, estimasi pada langkah peninjauan siaran (dan langkah peluncuran kampanye) menunjukkan jumlah kontak dan pembagian negara dengan catatan bahwa Meta menagihnya ke Akun WhatsApp Business Anda, bukan total kredit.
  • Nomor uji coba gratis. Nomor uji coba yang diberikan Meta kepada setiap aplikasi baru dapat mengirim pesan hingga lima penerima terverifikasi tanpa biaya — cara praktis untuk mencoba pengaturan lengkap sebelum mengarahkan nomor asli ke sana.

Templat

Templat pesan berfungsi pada koneksi ini, dan templat tersebut tersimpan di Akun WhatsApp Business Anda sendiri. Buat templat di halaman Templat dan templat tersebut akan dibuat di akun itu serta ditinjau oleh Meta, dengan hasil disetujui, tertunda, atau ditolak yang ditampilkan kembali kepada Anda di sini. Templat yang sudah Anda miliki di WhatsApp Manager akan muncul di daftar secara otomatis, dan tombol Sinkronkan dari Meta akan menarik semua perubahan yang baru saja Anda buat di sana. Pengiriman berfungsi seperti pada koneksi WhatsApp lainnya — pilih templat yang disetujui untuk memulai percakapan atau membuka kembali percakapan di luar jendela 24 jam. Detailnya ada di Menggunakan Templat Dengan Akun WhatsApp Meta Anda Sendiri.

Jika ada sesuatu yang tidak berfungsi

  • “Kami tidak dapat terhubung dengan detail tersebut” — salin ulang setiap nilai; spasi tambahan biasanya menjadi penyebabnya. Pesan tersebut menyertakan balasan dari Meta sendiri, yang biasanya menyebutkan nilai mana yang salah.
  • Pesan kesalahan mengatakan token hilang whatsapp_business_management — aplikasi Anda belum diberikan izin tersebut. Kembali ke Bagian 1, langkah 3, tekan Dapatkan akses standar, lalu buat token baru dengan kedua izin dicentang dan periksa kembali detail Anda. Membuat ulang token tanpa langkah tersebut akan terus menghasilkan kesalahan yang sama.
  • Token Anda menghilang — Meta hanya menampilkan token satu kali. Buat token baru dari pengguna sistem yang sama; token lama akan tetap berfungsi sampai Anda mencabutnya, tetapi hanya token baru yang terlihat.
  • Pesan yang Anda mulai tidak sampai — periksa catatan jendela 24 jam di atas: di luar jendela tersebut, hanya pesan templat yang dikirimkan.
  • Tidak ada pesan yang masuk sama sekali — nomor tersebut mungkin belum diaktifkan untuk Cloud API. Sebuah nomor hanya bisa berada di satu tempat dalam satu waktu, jadi jika nomor tersebut masih masuk ke aplikasi WhatsApp Business di ponsel, hapus terlebih dahulu di sana, lalu tekan Verifikasi koneksi pada kartu koneksi. Your AI Connector akan mengaktifkannya untuk Anda dan memberi tahu Anda secara langsung jika Meta masih memerlukan sesuatu.
  • “Nomor ini sudah memiliki PIN verifikasi dua langkah” — nomor tersebut sebelumnya pernah disiapkan di tempat lain dan PIN-nya tetap tersimpan. Matikan verifikasi dua langkah untuk nomor tersebut di WhatsApp Manager, lalu tekan Hubungkan kembali.
  • “Meta belum memverifikasi nomor ini” — selesaikan verifikasi nomor di WhatsApp Manager (Meta akan mengirimkan kode ke nomor tersebut), lalu tekan Hubungkan kembali.
  • “Nomor ini dihosting di API On-Premises” — nomor tersebut berjalan pada produk lama WhatsApp yang dihosting sendiri, yang tidak dapat berbagi nomor dengan Cloud API. Migrasikan nomor tersebut ke Cloud API di WhatsApp Manager terlebih dahulu.