# WhatsApp Business Tools MCP: cara menyambungkan WhatsApp Business kepada ejen AI
> Pelayan MCP rasmi Meta untuk WhatsApp Business: perkara yang boleh dilakukan oleh ejen, arahan sambungan dalam Claude Code, persediaan dalam Codex dan ChatGPT, serta batasan versi beta.
Source: https://ailoot.ai/blog/ms/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/ms/whatsapp-business-mcp/
Language: ms
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-8bfd9858e409e3960f0722ca21779e548b0580e44963750be820605cf1c5aa02
Pada 15 September 2026, Meta melancarkan pelayan WhatsApp Business Tools MCP rasmi. Pelayan ini menyambungkan ejen AI—Claude Code, Codex, ChatGPT atau Cursor—kepada platform WhatsApp Business. Daripada beralih antara Developer Console, Business Manager dan dokumentasi API, anda hanya perlu menerangkan tugasan kepada ejen. Ejen itu akan menambah nombor, mencipta templat mesej, mengkonfigurasi webhook dan menghantar mesej ujian.
Pelayan ini masih dalam versi beta: akses sedang diberikan secara berperingkat, dan keluaran ini bertujuan untuk pembangunan dan pengujian, bukan untuk menghantar mesej pada skala besar dalam persekitaran produksi. Di bawah ialah persediaan dan langkah sambungan untuk empat klien. Arahan dan tetapan telah disemak berdasarkan dokumentasi rasmi Meta pada 18 September 2026.
Maklumat tentang cara bekerja dengan Ailoot tersedia dalam [dokumentasi](https://ailoot.ai/docs/).
## Apakah WhatsApp Business Tools MCP?
Perkara utama
Ini ialah pelayan MCP jauh rasmi Meta yang menyediakan alat kepada ejen AI untuk mengurus platform WhatsApp Business: akaun, nombor telefon, templat mesej, webhook dan penghantaran mesej ujian. Akses menggunakan OAuth: anda log masuk dengan akaun Meta dan memilih perniagaan yang dibenarkan untuk diurus oleh pelayan.
MCP (Model Context Protocol) ialah piawaian terbuka untuk menyambungkan sistem luaran kepada ejen AI. Ketahui lebih lanjut dalam artikel [Pelayan MCP untuk Claude Code: 7 integrasi sedia digunakan](https://ailoot.ai/blog/ms/mcp-servers-claude-code/). Sambungan yang telah disahkan berserta arahan pemasangan tersedia dalam katalog MCP.
Sebelum keluaran ini, persediaan integrasi WhatsApp kelihatan begini: buka Developer Console, cipta aplikasi, pautkan perniagaan, tambah nombor telefon, sahkannya dengan kod, jana token, konfigurasi webhook, semak dokumentasi API—kemudian barulah menulis baris kod yang pertama.
Meta menerangkan idea di sebalik pelayan ini seperti berikut (diterjemahkan daripada bahasa Inggeris):
Anda terangkan perkara yang diperlukan, kemudian ejen akan menentukan sendiri akaun, nombor telefon, templat dan panggilan API yang perlu digunakan.
— Meta for Developers, https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/
Meta kini mempunyai dua pelayan MCP dan kedua-duanya mudah dikelirukan. Meta Social Technologies MCP ialah alat pembangunan serba guna untuk mencari dokumentasi, menemukan titik akhir Graph API dan mendiagnosis ralat aplikasi. WhatsApp Business Tools MCP pula digunakan untuk mengurus akaun WhatsApp, nombor telefon, templat, webhook dan mesej ujian. Kedua-duanya saling melengkapi dan anda boleh menyambungkan kedua-duanya jika perlu.
## Apakah yang sebenarnya boleh dilakukan oleh ejen selepas disambungkan?
Perkara utama
Pelayan ini menyokong empat kumpulan tugasan. Menyediakan nombor telefon dari awal: menambah nombor, menghantar kod pengesahan, mengesahkan nombor dan mendaftarkannya. Templat mesej: mencipta dan mengedit templat serta menyemak status kelulusannya. Webhook: menetapkan URL callback dan melanggan medan. Semakan prasyarat: ejen mengesan jika terma belum diterima atau pembayaran belum disediakan, lalu memberikan pautan terus untuk menyelesaikan masalah.
Alat pelayan ini dikumpulkan di bawah awalan `whatsapp_biz_`. Menurut dokumentasi rasmi:
- Gambaran keseluruhan: `whatsapp_biz_businesses`, `whatsapp_biz_accounts`, `whatsapp_biz_phone_numbers`—perniagaan, akaun dan nombor telefon yang tersedia untuk anda.
- Persediaan nombor telefon: `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`.
- Mesej: `whatsapp_biz_send_message`—teks bebas dalam tempoh perbualan 24 jam atau templat yang diluluskan selepas tempoh itu; ejen akan mengesahkan penerima dengan anda sebelum menghantar.
- Webhook: `whatsapp_biz_configure_webhooks`, `whatsapp_biz_subscribe_webhook`.
- Persediaan akaun: `whatsapp_biz_configure_payments`, `whatsapp_biz_verify_business`, `whatsapp_biz_system_user_token`—pautan untuk mencipta token pengguna sistem bagi panggilan Cloud API secara langsung.
Apabila pelanggan menghantar mesej kepada perniagaan terlebih dahulu, tetingkap khidmat pelanggan akan dibuka: anda boleh membalas dengan teks bebas selama 24 jam. Setiap mesej baharu daripada pelanggan akan melanjutkan tempoh tetingkap itu. Selepas tetingkap ditutup, anda hanya boleh menghubungi pelanggan dengan templat yang diluluskan. Ejen mengetahui peraturan ini dan akan mencadangkan penghantaran templat, bukannya teks biasa, jika penerima berada di luar tempoh tersebut.
Kawalan akses terbina dalam pelayan ini. Anda log masuk melalui akaun Meta dan memilih perniagaan tertentu; token tidak dimasukkan dalam sejarah perbualan. Setiap pembacaan dilakukan dalam konteks anda, panggilan direkodkan dan tindakan yang membuat perubahan memerlukan orang yang telah disahkan; kunci aplikasi pelayan sahaja tidak mencukupi.
## Apakah yang perlu disemak sebelum menyambung?
Perkara utama
Tiga prasyarat: peranan MANAGE dalam perniagaan Meta yang ingin anda urus; hak pentadbir pada aplikasi yang mengaktifkan senario WhatsApp; dan penerimaan terma WhatsApp Business Cloud API. Jika ada perkara yang belum dipenuhi, alat ini akan memulangkan ralat yang menerangkan masalah serta pautan ke halaman untuk menyelesaikannya.
Pelayan bertindak bagi pihak anda dan hanya berfungsi dengan sumber milik anda, jadi semak perkara berikut sebelum panggilan pertama:
1. Anda mempunyai perniagaan Meta dan merupakan pentadbir di dalamnya (peranan MANAGE).
2. Anda mempunyai aplikasi Meta yang mengaktifkan senario WhatsApp Business Messaging (atau produk WhatsApp dalam aplikasi lama), dan anda ialah pentadbir aplikasi itu secara khusus; kebenaran pada peringkat perniagaan sahaja tidak mencukupi.
3. Perniagaan tersebut telah menerima terma WhatsApp Business Cloud API—tanpanya, pendaftaran nombor telefon dan penghantaran mesej akan disekat.
Menurut Meta, masalah berkaitan terma penggunaan, kaedah pembayaran dan pengesahan perniagaan sering berlaku tanpa penjelasan yang jelas. Ejen menyemaknya terlebih dahulu dan memberikan pautan terus untuk menerima terma, menetapkan kaedah pembayaran atau memulakan pengesahan perniagaan.
## Bagaimanakah cara menyambungkan pelayan kepada Claude Code?
Perkara utama
Jalankan arahan `claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`, kemudian taip `/mcp` dalam sesi, pilih pelayan dan log masuk melalui Meta. Selepas memulakan semula klien, anda perlu log masuk semula.
Jika anda belum memasang Claude Code, mulakan dengan panduan [Cara memasang Claude Code daripada laman web rasmi](https://ailoot.ai/blog/ms/install-claude-code/).
1. ### Tambahkan pelayan
Dalam terminal, jalankan:
```bash
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
```
Pelayan ini berada jauh, jadi anda tidak perlu memasangnya secara setempat.
2. ### Log masuk melalui Meta
Dalam sesi Claude Code, taip `/mcp` dan pilih `whatsapp_business_tools`. Tetingkap pelayar akan dibuka untuk anda log masuk ke akaun Meta. Jika pelayar tidak dibuka, salin pautan daripada klien dan buka pautan itu secara manual.
3. ### Berikan kebenaran
Pada skrin persetujuan, pilih perniagaan dan aplikasi dengan WhatsApp yang anda benarkan untuk diakses. Pelayan akan meminta tiga kebenaran: `business_management` (mencari perniagaan yang anda tadbir), `whatsapp_business_management` (akaun, nombor telefon, templat, webhook) dan `whatsapp_business_messaging` (menghantar mesej daripada nombor anda).
4. ### Semak sambungan
Mulakan semula Claude Code, log masuk semula melalui `/mcp` dan tanya ejen alat yang dapat dilihatnya pada pelayan `whatsapp_business_tools`. Kemudian lakukan bacaan yang selamat: “Senaraikan perniagaan yang boleh saya urus”—ejen akan memanggil `whatsapp_biz_businesses`. Jika tiada alat atau anda menerima ralat log masuk, semak alamat pelayan dan log masuk semula.
Log masuk OAuth dikaitkan dengan pelancaran klien: selepas memulakan semula Claude Code, anda perlu log masuk semula. Anda boleh membatalkan akses pada bila-bila masa melalui tetapan di facebook.com, di bahagian “Business Integrations”.
## Bagaimanakah cara menyambungkan Codex, ChatGPT dan Claude Desktop?
Perkara utama
Ketiga-tiganya menggunakan alamat pelayan dan log masuk OAuth yang sama; hanya lokasi dalam tetapan berbeza. Codex App: Settings, MCP Servers, tambah pelayan Streamable HTTP. ChatGPT: Settings, Plugins, tambah melalui URL. Claude Desktop: Settings, Connectors, penyambung tersuai.
**Codex App.** Buka tetapan (ikon gear di bahagian bawah kiri), pergi ke MCP Servers dan pilih Add servers. Pilih Streamable HTTP dan masukkan:
- Nama: `WhatsApp Business Tools`
- URL: `https://mcp.facebook.com/whatsapp_business_tools`
- Pengesahan: OAuth
Klik Authenticate dan log masuk dalam pelayar.
**ChatGPT.** Settings, Plugins, Browse plugins, ikon “+” di penjuru kanan atas. Masukkan nama, URL yang sama dan OAuth sebagai jenis pengesahan.
**Claude Desktop.** Settings, Connectors, Add custom connector. Nama: `WhatsApp Business Tools`; URL: alamat pelayan yang sama.
Selepas menambahkannya pada mana-mana klien, ikuti urutan semakan yang sama: mulakan semula, log masuk semula, lihat senarai alat dan baca senarai perniagaan dengan selamat.
## Apakah yang berlaku dalam sesi pertama: daripada senarai perniagaan hingga mesej ujian?
Perkara utama
Urutannya ialah: senaraikan perniagaan, pilih satu, lihat akaun dan nombor telefonnya, tambah nombor telefon, hantar kod pengesahan melalui SMS atau panggilan, sahkan nombor dengan kod itu, daftarkan nombor, cipta templat, hantar mesej ujian dan konfigurasi webhook. Anda sendiri memberikan kod SMS kepada ejen.
Contoh sesi pertama dengan pelayan yang telah disambungkan:
1. “Senaraikan perniagaan yang saya urus”—ejen memanggil `whatsapp_biz_businesses`, kemudian anda memilih perniagaan yang diperlukan.
2. “Tunjukkan akaun WhatsApp dan nombor telefon perniagaan ini”—`whatsapp_biz_accounts` dan `whatsapp_biz_phone_numbers`, berserta statusnya.
3. “Tambahkan nombor telefon ujian saya kepada akaun”—`whatsapp_biz_add_phone_number`.
4. “Hantar kod pengesahan melalui SMS”—`whatsapp_biz_send_verification_code`. Kod akan tiba pada telefon anda.
5. “Sahkan nombor dengan kod 123456”—`whatsapp_biz_verify_phone_number`, kemudian daftarkan nombor itu dengan `whatsapp_biz_register_phone_number`.
6. “Cipta templat `order_update` dalam bahasa pilihan penerima untuk pemberitahuan pesanan”—`whatsapp_biz_create_template`; ejen akan memberikan pautan untuk menyemak status kelulusannya.
7. “Hantar mesej ujian ke nombor saya”—`whatsapp_biz_send_message`; ejen akan mengesahkan penerima sebelum menghantar.
8. “Konfigurasikan webhook di [https://example.com/webhook](https://example.com/webhook)”—`whatsapp_biz_configure_webhooks` dan langgan melalui `whatsapp_biz_subscribe_webhook`.
Selepas itu, mesej masuk daripada pelanggan akan tiba di alamat yang ditetapkan—biasanya CRM, perkhidmatan sokongan pelanggan atau bot mengambil mesej di situ. Anda membina pemprosesan pada alamat itu secara berasingan; pelayan hanya mengendalikan konfigurasi.
## Apakah batasan versi beta?
Perkara utama
Pelayan ini dalam versi beta: set alat mungkin berubah dan akses diberikan secara berperingkat, bukan kepada semua orang serentak. Keluaran ini bertujuan untuk pembangunan dan pengujian; ia tidak sesuai untuk menghantar mesej dalam skala besar di persekitaran produksi. Setiap alat mempunyai had permintaan bagi setiap pengguna, dan anda perlu log masuk semula selepas memulakan semula klien.
Terdapat empat batasan pelayan yang perlu diingati.
**Status beta.** Meta menyatakan bahawa antara muka dan set alat mungkin berubah, dan akses diberikan secara berperingkat. Jika anda masih belum dapat menyambung kepada pelayan, akses itu mungkin belum diberikan kepada anda.
**Tujuan.** Keluaran ini bertujuan untuk pembangunan dan pengujian; ia bukan untuk penghantaran besar-besaran dalam produksi. Untuk penghantaran mesej produksi, anda memerlukan integrasi penuh dengan Cloud API—contohnya, menggunakan token pengguna sistem, yang pautannya disediakan oleh alat `whatsapp_biz_system_user_token`.
**Had.** Permintaan dihadkan bagi setiap pengguna untuk setiap alat. Jika anda melebihi had, alat akan memulangkan ralat had—tunggu dan cuba lagi.
**Peraturan tetingkap 24 jam.** Di luar tetingkap perbualan pelanggan, anda hanya boleh menghantar templat yang diluluskan.
## Mengapakah perkara ini penting kepada perniagaan?
Perkara utama
Kini anda boleh menyelesaikan persediaan awal integrasi WhatsApp dalam satu perbualan dengan ejen: ejen mengetahui urutan langkah dan memahami ralat platform. Kegunaan utamanya termasuk sokongan pelanggan, pemberitahuan pesanan dan janji temu, serta penyediaan templat.
Senario lazim bagi perniagaan kecil: pelanggan menghantar mesej melalui WhatsApp dan anda mahu membalas dengan pantas serta menghantar pemberitahuan status pesanan. Dahulu, persediaan awal bermakna anda perlu bekerja sendiri dalam beberapa papan pemuka Meta atau mengupah pembangun. Kini, anda boleh menyelesaikan bahagian ini dalam perbualan dengan ejen. Anda masih perlu membina pengendalian mesej masuk pada alamat anda sendiri secara berasingan—itulah tugasan seterusnya selepas mengkonfigurasi webhook.
Pelayan ini juga berguna jika integrasi anda sudah berjalan. Templat mesej memerlukan kemas kini berkala: promosi baharu, teks pemberitahuan baharu. Melalui pelayan, ejen mencipta atau mengedit templat dan menunjukkan status kelulusannya tanpa menghantar anda ke papan pemuka.
Pendekatan yang serupa—ejen menyambung kepada sistem luaran dan menggunakannya berdasarkan penerangan anda—ditunjukkan bersama dokumentasi dalam panduan Cara menyambungkan NotebookLM kepada Claude Code melalui MCP.
## Apa seterusnya?
Perkara utama
Semak prasyarat, sambungkan pelayan dengan satu arahan, log masuk dan baca senarai perniagaan dengan selamat. Kemudian tambah nombor telefon ujian dan hantar mesej pertama. Ingat bahawa pelayan ini dalam versi beta: sediakan integrasi penuh Cloud API untuk penghantaran mesej dalam produksi.
Pengumuman pelayan ini dibuat tiga hari lalu. Anda boleh bermula dengan satu arahan dan log masuk melalui Meta, kemudian minta ejen menyenaraikan perniagaan anda. Seterusnya, mengikut keperluan: nombor telefon, templat, webhook, mesej ujian.
Cara lain untuk menyambungkan ejen kepada sistem luaran terdapat dalam koleksi [pelayan MCP untuk Claude Code](https://ailoot.ai/blog/ms/mcp-servers-claude-code/)—tujuh lagi integrasi berfungsi untuk pelbagai tugasan.
### Sumber
- [Meta for Developers: Pengumuman WhatsApp Business Tools MCP (15.09.2026)](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta: Dokumentasi WhatsApp Business Tools MCP](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta: Gambaran keseluruhan pelayan MCP untuk pembangun](https://developers.facebook.com/documentation/mcp)
- [Platform WhatsApp Business: Dokumentasi](https://developers.facebook.com/documentation/business-messaging/whatsapp)
Kenali [Ailoot](https://ailoot.ai/).
## Soalan lazim: WhatsApp Business Tools MCP: cara menyambungkan WhatsApp Business kepada ejen AI
### Apakah pemeriksaan sambungan pertama yang paling selamat?
Selepas log masuk OAuth, periksa senarai alat dan baca perniagaan yang boleh anda urus. Ini memeriksa akses sebelum menambah nombor telefon, mencipta templat, mengkonfigurasi webhook atau menghantar mesej ujian.
### Adakah mengkonfigurasi webhook turut membina pengendalian mesej?
Tidak. Pelayan MCP mengkonfigurasi callback dan langganan, tetapi anda perlu membina CRM, perkhidmatan sokongan atau bot secara berasingan untuk menerima serta memproses mesej masuk pada alamat itu.
## Ailoot · Syarikat dan portfolio projeknya
Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.
Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.
Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.