WhatsApp Business Tools MCP

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

WhatsApp Business Tools MCP

Untuk developer yang membangun di 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. Server ini memungkinkan agen menemukan bisnis dan akun WhatsApp yang Anda kelola, melakukan onboarding dan mendaftarkan nomor telepon, membuat dan mengelola templat pesan, mengonfigurasi webhook, serta mengirim pesan — bertindak sebagai Anda, pada aplikasi dan bisnis yang Anda kelola.

Catatan: Catatan: Antarmuka dan rangkaian alat server WhatsApp Business Tools MCP 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 dengan akun developer Meta (OAuth)
ID Klien	Tidak diperlukan. Server mengenali klien yang didukung secara otomatis.
URI Pengalihan	Tidak diperlukan. Anda tidak membuat atau mengonfigurasi aplikasi Meta untuk server ini.
Klien yang didukung	Claude Code, Claude Desktop, ChatGPT, Codex CLI, aplikasi Codex
Status	Beta - antarmuka dan rangkaian alat dapat berubah

Sebelum memulai

Untuk menghubungkan klien, Anda memerlukan salah satu klien yang didukung dan tercantum di atas, dengan versi terkini.

Server diluncurkan secara bertahap, jadi server mungkin belum tersedia untuk akun Anda, bahkan setelah klien Anda terhubung.

Server bertindak atas aset milik Anda, jadi sebelum agen dapat menggunakan sebagian besar alat, Anda juga memerlukan:

• Akses admin ke bisnis yang ingin Anda kelola (peran MANAGE).
• Aplikasi berkemampuan WhatsApp yang Anda kelola sebagai admin, terhubung ke bisnis tersebut — aplikasi dengan kasus penggunaan WhatsApp Business Messaging (atau produk WhatsApp pada aplikasi versi lama). Anda harus memiliki akses admin pada aplikasi, bukan hanya pada bisnis.
• Persetujuan atas Ketentuan Layanan WhatsApp Business Cloud API untuk bisnis tersebut. Pengiriman pesan dan pendaftaran nomor telepon diblokir sampai admin menyetujuinya.

Jika ada prasyarat yang belum terpenuhi, alat akan menampilkan error yang dapat ditindaklanjuti, yang memberi tahu Anda apa yang perlu diperbaiki dan menautkan ke halaman tempat Anda dapat memperbaikinya.

Hubungkan klien Anda

Untuk menghubungkan klien yang didukung dan menyelesaikan otorisasi OAuth, ikuti Hubungkan klien MCP ke Meta. Gunakan nama server dan endpoint dari Ringkasan. Server ini tidak memerlukan ID klien, jadi gunakan pendaftaran otomatis.

Cakupan

Server meminta izin berikut selama proses persetujuan:

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

Anda dapat meninjau izin ini dan mencabut akses di Facebook melalui Pengaturan > Aktivitas Anda > Integrasi Bisnis.

Verifikasi koneksi Anda

Minta agen untuk mencantumkan alat yang tersedia dari server ini, menggunakan nama yang Anda berikan saat menghubungkannya. Lalu jalankan alat hanya-baca, seperti whatsapp_biz_businesses untuk mencantumkan bisnis yang Anda kelola. Koneksi berfungsi jika panggilan tersebut menampilkan bisnis Anda, bukan error autentikasi atau izin.

Batas laju

Permintaan dibatasi lajunya per pengguna per alat untuk melindungi platform. Jika Anda melampaui batas, alat akan menampilkan error batas laju; coba lagi setelah menunggu sebentar.

Alat

WhatsApp Business Tools MCP menyediakan alat dengan namespace berawalan whatsapp_biz_. Sebagian besar alat dibatasi pada bisnis yang Anda kelola, jadi sesi biasanya dimulai dengan mencantumkan bisnis Anda dan memilih salah satunya. Rangkaian alat terus berkembang selama versi beta.

Penemuan

• whatsapp_biz_businesses — Mencantumkan bisnis yang Anda kelola dan berikan aksesnya selama proses persetujuan. Gunakan alat ini terlebih dahulu untuk memilih bisnis. Contoh: "Cantumkan bisnis yang dapat saya kelola di WhatsApp."
• whatsapp_biz_accounts — Mencantumkan akun WhatsApp (dan akun perpesanan) di bawah suatu bisnis. Contoh: "Tampilkan akun WhatsApp untuk bisnis 1234567890."
• whatsapp_biz_phone_numbers — Mencantumkan nomor telepon pada bisnis atau akun WhatsApp, beserta status dan status onboarding. Contoh: "Cantumkan nomor telepon dan statusnya untuk bisnis ini."

Onboarding nomor telepon

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

Templat pesan

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Mencantumkan dan memeriksa templat pesan pada akun. Contoh: "Cantumkan templat yang disetujui untuk akun ini."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Membuat, memperbarui, dan menghapus templat pesan. Contoh: "Buat templat pemasaran bernama order_update dalam en_US."

Perpesanan

• whatsapp_biz_send_message — Mengirim teks bebas (hanya dikirim dalam jendela layanan pelanggan 24 jam) atau pesan templat yang disetujui dari nomor terdaftar. Meminta konfirmasi Anda tentang penerima sebelum mengirim. Contoh: "Kirim templat order_update ke +1 555 010 9999 dari nomor ini."

Webhook

• whatsapp_biz_configure_webhooks — Menetapkan URL callback dan token verifikasi untuk topik WhatsApp, lalu berlangganan ke kolom yang diizinkan. Contoh: "Konfigurasikan webhook untuk bisnis ini dengan callback https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Membuat akun WhatsApp berlangganan ke webhook aplikasi Anda agar peristiwanya dikirimkan. Contoh: "Buat akun WhatsApp ini berlangganan ke webhook."

Penyiapan akun

• whatsapp_biz_configure_payments — Mengonfigurasi metode pembayaran agar akun dapat mengirim pesan berbayar. Contoh: "Bantu saya menyiapkan pembayaran untuk akun ini."
• whatsapp_biz_verify_business — Memeriksa dan memulai verifikasi bisnis. Contoh: "Bagaimana status verifikasi bisnis, dan bagaimana cara memulainya?"
• whatsapp_biz_system_user_token — Mendapatkan tautan untuk membuat token akses pengguna sistem bagi bisnis Anda, sehingga Anda dapat membangun solusi perpesanan khusus yang memanggil WhatsApp Cloud API secara langsung. Pembuatan token berlangsung dengan aman di Pengaturan Bisnis — alat ini menampilkan tautan langsung ke halaman Pengguna Sistem, tempat Anda memilih pengguna sistem dan membuat token. Untuk mempelajari lebih lanjut, lihat Buat pengguna sistem dan buat token akses permanen. Contoh: "Berikan tautan untuk membuat token akses pengguna sistem bagi bisnis ini."

Masukan

Jika Anda memiliki masukan atau ingin melihat lebih banyak alat, sampaikan masukan Anda.

Terkait

• Ringkasan MCP
• Hubungkan klien MCP ke Meta
• Dokumentasi WhatsApp Business Platform

---

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