WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

Untuk developer yang membangun di atas WhatsApp Business Platform (Cloud API) — server WhatsApp Business Tools MCP memungkinkan agen AI dan asisten IDE Anda mengelola dan men-debug integrasi WhatsApp Business Anda dari satu tempat. Ini memungkinkan agen untuk menemukan bisnis dan akun WhatsApp yang Anda kelola, melakukan onboarding dan mendaftarkan nomor telepon, membuat dan mengelola template pesan, mengonfigurasi webhook, dan mengirim pesan — bertindak sebagai Anda, pada aplikasi dan bisnis yang Anda kelola.

Catatan: Server WhatsApp Business Tools MCP diluncurkan secara bertahap dan mungkin belum tersedia untuk semua orang. Antarmuka dan kumpulan alat masih dalam versi beta dan dapat berubah.

Ringkasan

Tabel berikut merangkum detail server:

Atribut	Nilai
Nama server	WhatsApp Business Tools
Transport	Streamable HTTP
Endpoint	https://mcp.facebook.com/whatsapp_business_tools
Autentikasi	Masuk akun developer Meta (OAuth)
Status	Beta - antarmuka dan kumpulan alat dapat berubah

Prasyarat

Server bertindak pada aset Anda sendiri, jadi sebelum agen dapat menggunakan sebagian besar alat, Anda perlu:

• Akses admin ke bisnis yang ingin Anda kelola (peran MANAGE).
• Aplikasi yang mendukung WhatsApp yang Anda admin, terhubung ke bisnis tersebut — aplikasi dengan use case WhatsApp Business Messaging (atau produk WhatsApp pada aplikasi lama). Anda harus memiliki akses admin pada aplikasi, bukan hanya pada bisnis.
• Menerima WhatsApp Business Cloud API Terms of Service untuk bisnis tersebut. Pengiriman pesan dan pendaftaran nomor telepon diblokir sampai admin menerimanya.

Jika ada prasyarat yang hilang, alat mengembalikan error yang dapat ditindaklanjuti yang memberi tahu Anda apa yang harus diperbaiki dan menautkan ke halaman tempat Anda dapat memperbaikinya.

Siapkan IDE atau klien agen Anda

Server WhatsApp Business Tools MCP adalah server remote. Klien yang mendukung server MCP remote dapat terhubung ke endpoint secara langsung. Untuk klien yang hanya mendukung server lokal (stdio), gunakan bridge mcp-remote, yang mem-proxy server remote melalui stdio.

Konfigurasikan klien Anda menggunakan salah satu bagian di bawah ini, lalu selesaikan masuk OAuth untuk mengautentikasi.

Claude Code dan Desktop

Claude Code — jalankan perintah berikut untuk menambahkan server:

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

Lalu jalankan /mcp dalam sesi dan pilih whatsapp_business_tools untuk mengautentikasi.

Claude Desktop — buka Settings > Connectors > Add custom connector, lalu atur:

• Name: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools

OpenAI Codex App dan ChatGPT

Codex App — buka Settings (ikon roda gigi, kiri bawah) > MCP Servers > Add servers, pilih Streamable HTTP, lalu atur:

• Name: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Authentication: OAuth

Klik Authenticate dan selesaikan masuk OAuth.

ChatGPT — buka Settings > Plugins > Browse plugins, klik + di kanan atas untuk menambahkan plugin baru, lalu atur:

• Name: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Authentication: OAuth

Simpan plugin dan selesaikan masuk OAuth.

Masuk OAuth

Server WhatsApp Business Tools MCP mengautentikasi dengan akun developer Meta Anda melalui OAuth, sehingga alur masuk yang sama berfungsi dengan setiap klien.

Alur masuk

Setelah Anda menambahkan server ke klien Anda (lihat Siapkan IDE atau klien agen Anda):

1. Mulai koneksi. Banyak klien memulai alur OAuth secara otomatis saat server ditambahkan. Yang lain mengharuskan Anda mengklik Connect atau Authenticate terlebih dahulu.
2. Masuk. Browser Anda terbuka untuk masuk dengan akun Meta Anda. Jika tidak terbuka otomatis, salin tautan yang dicetak klien Anda dan buka secara manual.
3. Beri akses. Di layar persetujuan, pilih bisnis dan aplikasi yang mendukung WhatsApp yang ingin diakses server.
4. Konfirmasi. Kembali ke klien Anda dan verifikasi koneksi Anda.

Anda perlu menyelesaikan alur masuk lagi saat memulai ulang klien.

Cakupan

Server meminta izin berikut selama persetujuan:

Cakupan	Akses
business_management	Menemukan dan bertindak pada bisnis yang Anda kelola yang Anda pilih selama persetujuan.
whatsapp_business_management	Mengelola akun WhatsApp Business, nomor telepon, template pesan, dan webhook.
whatsapp_business_messaging	Mengirim pesan dari nomor telepon terdaftar Anda.

Anda dapat meninjau atau mencabut akses kapan saja di facebook.com > Settings > Business Integrations.

Verifikasi koneksi Anda

Setelah menambahkan server, konfirmasikan bahwa agen Anda dapat melihat alat:

1. Mulai ulang IDE atau klien agen.
2. Minta agen untuk membuat daftar alat yang dimilikinya dari server whatsapp_business_tools.
3. Jalankan alat baca berisiko rendah. Misalnya, minta untuk membuat daftar bisnis yang Anda kelola dengan whatsapp_biz_businesses.

Jika agen melaporkan tidak ada alat atau error autentikasi, periksa ulang URL endpoint dan konfirmasikan bahwa Anda menyelesaikan alur masuk.

Alat

WhatsApp Business Tools MCP mengekspos nama alat dengan awalan whatsapp_biz_. Sebagian besar alat dibatasi pada bisnis yang Anda kelola, jadi sesi tipikal dimulai dengan membuat daftar bisnis Anda dan memilih satu. Kumpulan alat berkembang selama beta.

Penemuan

• whatsapp_biz_businesses — Buat daftar bisnis yang Anda kelola dan yang Anda berikan selama persetujuan. Gunakan ini terlebih dahulu untuk memilih bisnis. Contoh: "Daftarkan bisnis yang bisa saya kelola di WhatsApp."
• whatsapp_biz_accounts — Buat daftar akun WhatsApp (dan akun pesan) di bawah bisnis. Contoh: "Tampilkan akun WhatsApp untuk bisnis 1234567890."
• whatsapp_biz_phone_numbers — Buat daftar nomor telepon di bisnis atau akun WhatsApp, dengan status dan status onboarding. Contoh: "Daftarkan nomor telepon dan statusnya untuk bisnis ini."

Onboarding nomor telepon

• whatsapp_biz_add_phone_number — Tambahkan nomor telepon ke akun WhatsApp. Contoh: "Tambahkan nomor telepon +1 555 010 1234 ke akun WhatsApp saya."
• whatsapp_biz_send_verification_code — Kirim kode verifikasi ke nomor telepon. Contoh: "Kirim kode verifikasi melalui SMS ke nomor ini."
• whatsapp_biz_verify_phone_number — Verifikasi nomor telepon dengan kode yang diterima. Contoh: "Verifikasi nomor ini dengan kode 123456."
• whatsapp_biz_register_phone_number — Daftarkan nomor terverifikasi sehingga dapat mengirim dan menerima. Contoh: "Daftarkan nomor ini untuk pesan."

Template pesan

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Buat daftar dan periksa template pesan di akun. Contoh: "Daftarkan template yang disetujui untuk akun ini."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Buat, perbarui, dan hapus template pesan. Contoh: "Buat template pemasaran bernama order_update dalam en_US."

Pesan

• whatsapp_biz_send_message — Kirim pesan teks bebas (hanya dikirim dalam jendela layanan pelanggan 24 jam) atau pesan template yang disetujui dari nomor terdaftar. Mengonfirmasi target dengan Anda sebelum mengirim. Contoh: "Kirim template order_update ke +1 555 010 9999 dari nomor ini."

Webhook

• whatsapp_biz_configure_webhooks — Atur URL callback dan token verifikasi untuk topik WhatsApp dan berlangganan bidang yang diizinkan. Contoh: "Konfigurasikan webhook untuk bisnis ini dengan callback https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Berlangganan akun WhatsApp ke webhook aplikasi Anda sehingga event-nya dikirim. Contoh: "Berlangganan akun WhatsApp ini ke webhook."

Pengaturan akun

• whatsapp_biz_configure_payments — Konfigurasikan metode pembayaran sehingga akun dapat mengirim pesan yang dapat ditagih. Contoh: "Bantu saya mengatur pembayaran untuk akun ini."
• whatsapp_biz_verify_business — Periksa dan mulai verifikasi bisnis. Contoh: "Apa status verifikasi bisnis, dan bagaimana cara memulainya?"
• whatsapp_biz_system_user_token — Dapatkan tautan untuk membuat system user access token untuk bisnis Anda, sehingga Anda dapat membangun solusi pesan kustom yang memanggil WhatsApp Cloud API secara langsung. Pembuatan token terjadi dengan aman di Business Settings — alat mengembalikan tautan dalam ke halaman System Users, tempat Anda memilih system user dan membuat token. Untuk mempelajari lebih lanjut, lihat <a href="/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token" target="_blank">Buat system user dan buat permanent access token</a>. Contoh: "Beri saya tautan untuk membuat system user access token untuk bisnis ini."

Batas kecepatan

Permintaan dibatasi kecepatannya per pengguna per alat untuk melindungi platform. Jika Anda melebihi batas, alat mengembalikan error batas kecepatan; coba lagi setelah menunggu sebentar.

Umpan balik

Jika Anda memiliki umpan balik atau ingin melihat lebih banyak alat, bagikan umpan balik Anda.

Terkait

• Ringkasan MCP
• Dokumentasi WhatsApp Business Platform

---

Indeks dokumentasi lengkap untuk produk ini: https://developers.facebook.com/documentation/mcp/llms.txt