WhatsApp Business Tools MCP: cara menghubungkan WhatsApp Business ke agen AI

Pada 15 September 2026, Meta merilis server WhatsApp Business Tools MCP resmi. Server ini menghubungkan agen AI—Claude Code, Codex, ChatGPT, atau Cursor—ke WhatsApp Business Platform. Alih-alih berpindah-pindah antara Developer Console, Business Manager, dan dokumentasi API, Anda cukup menjelaskan tugas kepada agen. Agen akan menambahkan nomor, membuat templat pesan, mengonfigurasi webhook, dan mengirim pesan uji.

Server ini masih dalam versi beta: akses diberikan secara bertahap, dan rilis ini ditujukan untuk pengembangan dan pengujian, bukan untuk pengiriman pesan produksi berskala besar. Berikut persiapan dan langkah koneksi untuk empat klien. Perintah dan pengaturan telah diperiksa berdasarkan dokumentasi resmi Meta pada 18 September 2026.

Informasi tentang penggunaan Ailoot tersedia di dokumentasi.

Apa itu WhatsApp Business Tools MCP?#

MCP (Model Context Protocol) adalah standar terbuka untuk menghubungkan sistem eksternal ke agen AI. Pelajari lebih lanjut di artikel Server MCP untuk Claude Code: 7 integrasi siap pakai. Koneksi terverifikasi dengan perintah instalasi tersedia di katalog MCP.

Sebelum rilis ini, menyiapkan integrasi WhatsApp biasanya dilakukan seperti ini: membuka Developer Console, membuat aplikasi, menghubungkan bisnis, menambahkan nomor telepon, memverifikasinya dengan kode, membuat token, mengonfigurasi webhook, memeriksa dokumentasi API—baru kemudian menulis baris kode pertama.

Meta menjelaskan gagasan di balik server ini sebagai berikut (diterjemahkan dari bahasa Inggris):

Meta kini memiliki dua server MCP, dan keduanya mudah tertukar. Meta Social Technologies MCP adalah alat pengembang serbaguna: untuk mencari dokumentasi, menemukan endpoint Graph API, dan mendiagnosis kesalahan aplikasi. WhatsApp Business Tools MCP digunakan untuk mengelola akun WhatsApp, nomor telepon, templat, webhook, dan pesan uji. Keduanya saling melengkapi, dan Anda dapat menghubungkan keduanya jika diperlukan.

Apa saja yang dapat dilakukan agen setelah terhubung?#

Alat-alat server dikelompokkan dengan awalan whatsapp_biz_. Menurut dokumentasi resmi:

• Ringkasan: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers—bisnis, akun, dan nomor telepon yang tersedia bagi Anda.
• Penyiapan nomor telepon: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Templat: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Pesan: whatsapp_biz_send_message—teks bebas dalam jendela percakapan 24 jam atau templat yang disetujui di luar jendela tersebut; agen mengonfirmasi penerima kepada Anda sebelum mengirim.
• Webhook: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Penyiapan akun: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token—tautan untuk membuat token pengguna sistem guna melakukan panggilan langsung ke Cloud API.

Saat pelanggan lebih dahulu mengirim pesan kepada bisnis, jendela layanan pelanggan terbuka: Anda dapat membalas dengan teks bebas selama 24 jam. Setiap pesan baru dari pelanggan memperpanjang jendela tersebut. Setelah jendela ditutup, Anda hanya dapat menghubungi pelanggan dengan templat yang disetujui. Agen memahami aturan ini dan, jika penerima berada di luar jendela, akan menyarankan penggunaan templat alih-alih teks biasa.

Kontrol akses sudah tersedia di dalam server. Anda masuk melalui akun Meta dan memilih bisnis tertentu; token tidak disertakan dalam riwayat percakapan. Setiap pembacaan dilakukan dalam konteks Anda, panggilan dicatat, dan tindakan yang membuat perubahan memerlukan orang yang telah terautentikasi; kunci aplikasi server saja tidak cukup.

Apa yang perlu diperiksa sebelum menghubungkan?#

Server bertindak atas nama Anda dan hanya bekerja dengan sumber daya milik Anda, jadi periksa hal berikut sebelum panggilan pertama:

1. Anda memiliki bisnis Meta tempat Anda menjadi administrator (peran MANAGE).
2. Anda memiliki aplikasi Meta dengan skenario WhatsApp Business Messaging yang diaktifkan (atau produk WhatsApp pada aplikasi versi lama), dan Anda adalah administrator khusus untuk aplikasi tersebut; izin di tingkat bisnis saja tidak cukup.
3. Ketentuan WhatsApp Business Cloud API telah disetujui untuk bisnis tersebut—tanpa persetujuan ini, pendaftaran nomor telepon dan pengiriman pesan akan diblokir.

Menurut Meta, masalah terkait ketentuan penggunaan, metode pembayaran, dan verifikasi bisnis sering muncul tanpa penjelasan yang jelas. Agen memeriksanya terlebih dahulu dan memberikan tautan langsung untuk menyetujui ketentuan, menentukan metode pembayaran, atau memulai verifikasi bisnis.

Bagaimana cara menghubungkan server ke Claude Code?#

Jika Claude Code belum terpasang, mulailah dengan panduan Cara menginstal Claude Code dari situs web resmi.

1. Tambahkan server

   Di terminal, jalankan:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   Server ini berada di jarak jauh, jadi Anda tidak perlu menginstalnya secara lokal.

2. Masuk melalui Meta

   Dalam sesi Claude Code, ketik /mcp dan pilih whatsapp_business_tools. Jendela browser akan terbuka untuk masuk ke akun Meta Anda. Jika browser tidak terbuka, salin tautan dari klien lalu buka secara manual.

3. Berikan izin

   Pada layar persetujuan, pilih bisnis dan aplikasi dengan WhatsApp yang Anda izinkan untuk diakses. Server akan meminta tiga izin: business_management (menemukan bisnis tempat Anda menjadi administrator), whatsapp_business_management (akun, nomor telepon, templat, webhook), dan whatsapp_business_messaging (mengirim pesan dari nomor Anda).

4. Periksa koneksi

   Mulai ulang Claude Code, masuk lagi melalui /mcp, lalu tanyakan kepada agen alat apa saja yang dapat dilihatnya di server whatsapp_business_tools. Setelah itu, lakukan pembacaan yang aman: “Daftarkan bisnis yang dapat saya kelola”—agen akan memanggil whatsapp_biz_businesses. Jika tidak ada alat atau muncul kesalahan masuk, periksa alamat server dan masuk lagi.

Proses masuk OAuth terikat pada saat klien dijalankan: setelah Claude Code dimulai ulang, Anda perlu masuk lagi. Anda dapat mencabut akses kapan saja melalui pengaturan di facebook.com, pada bagian “Business Integrations.”

Bagaimana cara menghubungkan Codex, ChatGPT, dan Claude Desktop?#

Codex App. Buka pengaturan (ikon roda gigi di kiri bawah), buka MCP Servers, lalu pilih Add servers. Pilih Streamable HTTP dan masukkan:

• Nama: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Autentikasi: OAuth

Klik Authenticate dan masuk melalui browser.

ChatGPT. Settings, Plugins, Browse plugins, ikon “+” di pojok kanan atas. Masukkan nama, URL yang sama, dan OAuth sebagai jenis autentikasi.

Claude Desktop. Settings, Connectors, Add custom connector. Nama: WhatsApp Business Tools; URL: alamat server yang sama.

Setelah menambahkannya di klien mana pun, ikuti urutan pemeriksaan yang sama: mulai ulang, masuk lagi, lihat daftar alat, lalu baca daftar bisnis dengan aman.

Apa yang terjadi pada sesi pertama: dari daftar bisnis hingga pesan uji?#

Contoh sesi pertama yang umum dengan server yang telah terhubung:

1. “Daftarkan bisnis yang saya kelola”—agen memanggil whatsapp_biz_businesses, lalu Anda memilih bisnis yang diperlukan.
2. “Tampilkan akun dan nomor telepon WhatsApp bisnis ini”—whatsapp_biz_accounts dan whatsapp_biz_phone_numbers, beserta statusnya.
3. “Tambahkan nomor telepon uji saya ke akun ini”—whatsapp_biz_add_phone_number.
4. “Kirim kode verifikasi melalui SMS”—whatsapp_biz_send_verification_code. Kode akan tiba di ponsel Anda.
5. “Verifikasi nomor dengan kode 123456”—whatsapp_biz_verify_phone_number, lalu daftarkan dengan whatsapp_biz_register_phone_number.
6. “Buat templat order_update dalam bahasa yang disukai penerima untuk notifikasi pesanan”—whatsapp_biz_create_template; agen akan memberikan tautan ke status persetujuannya.
7. “Kirim pesan uji ke nomor saya”—whatsapp_biz_send_message; agen akan mengonfirmasi penerima sebelum mengirim.
8. “Konfigurasikan webhook di https://example.com/webhook”—whatsapp_biz_configure_webhooks dan berlangganan menggunakan whatsapp_biz_subscribe_webhook.

Setelah itu, pesan masuk dari pelanggan akan tiba di alamat yang ditentukan—biasanya, CRM, layanan dukungan pelanggan, atau bot mengambilnya dari sana. Anda membangun pemrosesan di alamat tersebut secara terpisah; server hanya menangani konfigurasi.

Apa saja keterbatasan versi beta?#

Ada empat keterbatasan server yang perlu diingat.

Status beta. Meta menyatakan bahwa antarmuka dan kumpulan alat dapat berubah, dan akses diberikan secara bertahap. Jika Anda belum dapat terhubung ke server, mungkin aksesnya belum tersedia bagi Anda.

Tujuan penggunaan. Rilis ini ditujukan untuk pengembangan dan pengujian; bukan untuk pengiriman pesan produksi massal. Untuk pengiriman pesan produksi, Anda memerlukan integrasi penuh dengan Cloud API—misalnya, menggunakan token pengguna sistem yang tautannya disediakan oleh alat whatsapp_biz_system_user_token.

Batas. Jumlah permintaan per pengguna dibatasi untuk setiap alat. Jika Anda melampaui batas, alat akan menampilkan kesalahan batas—tunggu lalu coba lagi.

Aturan jendela 24 jam. Di luar jendela percakapan pelanggan, Anda hanya dapat mengirim templat yang disetujui.

Mengapa ini penting bagi bisnis?#

Skenario umum untuk bisnis kecil: pelanggan mengirim pesan melalui WhatsApp, dan Anda ingin membalas dengan cepat serta mengirim notifikasi status pesanan. Sebelumnya, penyiapan awal mengharuskan Anda bekerja sendiri di beberapa dasbor Meta atau menyewa pengembang. Kini, Anda dapat menyelesaikan bagian ini dalam percakapan dengan agen. Anda tetap perlu membangun penanganan pesan masuk di alamat Anda sendiri secara terpisah—itulah tugas berikutnya setelah webhook dikonfigurasi.

Server ini juga berguna jika integrasi Anda sudah berjalan. Templat pesan perlu diperbarui secara rutin: promosi baru, teks notifikasi baru. Melalui server, agen membuat atau mengedit templat dan menampilkan status persetujuannya tanpa mengarahkan Anda ke dasbor.

Pendekatan serupa—agen terhubung ke sistem eksternal dan menggunakannya berdasarkan deskripsi Anda—diperlihatkan beserta dokumentasinya dalam panduan Cara menghubungkan NotebookLM ke Claude Code melalui MCP.

Apa selanjutnya?#

Pengumuman server ini baru berlangsung tiga hari lalu. Anda dapat memulai dengan satu perintah dan masuk melalui Meta, lalu meminta agen menampilkan daftar bisnis Anda. Berikutnya, sesuai kebutuhan: nomor telepon, templat, webhook, pesan uji.

Cara lain untuk menghubungkan agen ke sistem eksternal tersedia dalam koleksi Server MCP untuk Claude Code—ada tujuh integrasi siap pakai lainnya untuk berbagai tugas.

Kenali Ailoot.