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.

Beralih dari koneksi terkelola

Anda dapat memulai dengan koneksi WhatsApp Business terkelola dan beralih ke aplikasi Meta Anda sendiri nantinya. Keduanya berada di akun yang sama, jadi tidak ada yang perlu dibangun ulang.

  • Kontak dan riwayat obrolan Anda tetap ada. Kontak, percakapan, tag, agen, dan basis pengetahuan adalah milik akun Anda, bukan milik koneksi. Menghapus atau mengganti nomor tidak akan menghapus data tersebut, dan ketika seseorang yang pernah menulis kepada Anda mengirim pesan lagi ke nomor tersebut, pesan itu akan masuk ke percakapan yang sama.
  • Nomor harus dipindahkan di sisi Meta terlebih dahulu. WhatsApp mengizinkan satu nomor berada di satu tempat dalam satu waktu. Minta dukungan untuk melepaskan nomor dari pengaturan terkelola, tambahkan ke Akun WhatsApp Business Anda sendiri di WhatsApp Manager, lalu ikuti langkah-langkah di halaman ini. Harap maklum bahwa nomor akan offline untuk sementara waktu selama proses pemindahan.
  • Gunakan nomor milik Anda sendiri jika berencana untuk beralih. Nomor yang disewa di dalam Your AI Connector adalah saluran virtual yang termasuk dalam pengaturan terkelola dan tidak dapat begitu saja dipindahkan ke aplikasi Meta Anda sendiri, jadi beralih berarti menggunakan nomor WhatsApp yang baru.
  • Templat perlu disetujui kembali. Meta menyetujui templat per Akun WhatsApp Business, jadi buat ulang templat yang Anda gunakan di bawah akun Anda sendiri (lihat Templat di bawah).
  • Agensi: setiap sub-akun menghubungkan aplikasi Meta-nya sendiri, sehingga klien dapat beralih satu per satu.

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 telah disetujui — pesan teks biasa akan diterima oleh Meta tetapi tidak akan terkirim.
  • Meta menagih Anda secara langsung untuk percakapan dengan tarif negara yang mereka tetapkan, melalui metode pembayaran yang terhubung ke akun WhatsApp Anda di Meta. Your AI Connector tidak mengenakan biaya per pesan pada koneksi ini; penggunaan AI ditagih dalam kredit seperti biasa.
  • Pastikan metode pembayaran yang valid tetap ada di akun WhatsApp tersebut. Tanpa metode pembayaran, Meta akan memblokir setiap percakapan yang dimulai oleh bisnis Anda — siaran dan pesan templat apa pun — dan menampilkan kesalahan di WhatsApp Manager. Pada koneksi ini, siaran akan menolak untuk dijalankan 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 masih akan terkirim untuk saat ini, tetapi mulai 1 Oktober 2026 Meta juga akan mengenakan biaya untuk balasan tersebut, sehingga akun tanpa metode pembayaran yang berfungsi akan benar-benar tidak aktif pada tanggal tersebut. Gambaran lengkapnya ada di Biaya WhatsApp & Perubahan Oktober 2026.
  • Estimasi biaya Anda terlihat berbeda di sini. Karena biaya ini tidak pernah memotong kredit Anda, estimasi pada langkah peninjauan siaran 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 ke lima penerima terverifikasi tanpa biaya — cara yang praktis untuk mencoba pengaturan lengkap sebelum mengarahkannya ke nomor asli.

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 yang tidak disengaja 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 tetap berfungsi sampai Anda mencabutnya, tetapi hanya token baru yang terlihat.
  • Balasan gagal dengan “Percakapan ini masuk melalui nomor WhatsApp Business …, yang bukan nomor yang terhubung” — aplikasi Meta Anda memiliki lebih dari satu nomor, dan orang-orang mengirim pesan ke nomor yang tidak terhubung di sini. Pesan mereka tetap muncul, karena Meta mengirim pesan aplikasi untuk setiap nomor, tetapi balasan hanya dapat dikirim dari nomor yang terhubung, sehingga AI tidak menjawabnya. Kartu WhatsApp di halaman Saluran menampilkan peringatan yang menyebutkan nomor tersebut sementara pesannya terus masuk. Baris nomor pada kartu tersebut tidak memiliki tombol Hubungkan Ulang (hanya Tetapkan sebagai utama dan hapus): buka kembali halaman koneksi aplikasi Meta Anda (Hubungkan WhatsApp pada kartu WhatsApp Business API, lalu Gunakan nomor yang sudah Anda miliki, lalu Aplikasi Meta Anda sendiri), tekan Hubungkan Ulang pada kartu koneksi di sana dan pilih nomor yang sebenarnya dihubungi oleh pelanggan Anda. Token pengguna sistem memerlukan akses ke akun WhatsApp tersebut. Jika nomor tersebut seharusnya tidak menjangkau Your AI Connector sama sekali, hapus nomor tersebut (atau akun WhatsApp-nya) dari aplikasi Meta Anda.
  • 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. Satu nomor hanya dapat berada di satu tempat dalam satu waktu, jadi jika nomor tersebut masih masuk ke aplikasi WhatsApp 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 saat itu juga jika masih ada yang kurang dari pihak Meta.
  • “Nomor ini sudah memiliki PIN verifikasi dua langkah” — nomor tersebut pernah disiapkan di tempat lain sebelumnya dan PIN-nya tetap ada. Matikan verifikasi dua langkah untuk nomor tersebut di WhatsApp Manager, lalu tekan Hubungkan Ulang.
  • “Meta belum memverifikasi nomor ini” — selesaikan verifikasi nomor di WhatsApp Manager (Meta akan mengirimkan kode), lalu tekan Hubungkan Ulang.
  • “Nomor ini dihosting di On-Premises API” — nomor tersebut berjalan pada produk lama WhatsApp yang dihosting sendiri, yang tidak dapat berbagi nomor dengan Cloud API. Migrasikan terlebih dahulu ke Cloud API di WhatsApp Manager.