WhatsApp Business Tools MCP

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

WhatsApp Business Tools MCP

Dành cho các nhà phát triển xây dựng trên WhatsApp Business Platform (Cloud API) — máy chủ WhatsApp Business Tools MCP cho phép tác nhân AI và trợ lý IDE của bạn quản lý và gỡ lỗi tích hợp WhatsApp Business tại một nơi. Máy chủ giúp tác nhân khám phá các doanh nghiệp và tài khoản WhatsApp mà bạn quản trị, tiếp nhận và đăng ký số điện thoại, tạo và quản lý mẫu tin nhắn, cấu hình webhook và gửi tin nhắn — thay mặt bạn, trên các ứng dụng và doanh nghiệp mà bạn quản trị.

Lưu ý: Lưu ý: Giao diện và bộ công cụ của máy chủ WhatsApp Business Tools MCP đang ở giai đoạn beta và có thể thay đổi.

Tổng quan

Bảng sau đây tóm tắt thông tin máy chủ:

Thuộc tính	Giá trị
Tên máy chủ	WhatsApp Business Tools
Giao thức truyền tải	Streamable HTTP
Điểm cuối	https://mcp.facebook.com/whatsapp_business_tools
Xác thực	Đăng nhập tài khoản nhà phát triển Meta (OAuth)
Client ID	Không bắt buộc. Máy chủ tự động nhận diện các ứng dụng được hỗ trợ.
URI chuyển hướng	Không bắt buộc. Bạn không cần tạo hoặc cấu hình ứng dụng Meta cho máy chủ này.
Ứng dụng được hỗ trợ	Claude Code, Claude Desktop, ChatGPT, Codex CLI, ứng dụng Codex
Trạng thái	Beta - giao diện và bộ công cụ có thể thay đổi

Trước khi bắt đầu

Để kết nối ứng dụng, bạn cần dùng một trong các ứng dụng được hỗ trợ liệt kê ở trên và phiên bản hiện hành.

Máy chủ đang được triển khai dần, vì vậy có thể tài khoản của bạn chưa sử dụng được máy chủ, ngay cả sau khi ứng dụng kết nối.

Máy chủ thao tác trên tài sản của chính bạn, vì vậy trước khi tác nhân có thể sử dụng hầu hết các công cụ, bạn cũng cần:

• Quyền quản trị đối với doanh nghiệp mà bạn muốn quản lý (vai trò MANAGE).
• Một ứng dụng có bật WhatsApp mà bạn là quản trị viên, được kết nối với doanh nghiệp đó — ứng dụng có trường hợp sử dụng WhatsApp Business Messaging (hoặc sản phẩm WhatsApp trên ứng dụng cũ hơn). Bạn phải có quyền quản trị trên ứng dụng, không chỉ trên doanh nghiệp.
• Đã chấp nhận Điều khoản dịch vụ WhatsApp Business Cloud API cho doanh nghiệp đó. Các thao tác nhắn tin và đăng ký số điện thoại sẽ bị chặn cho đến khi quản trị viên chấp nhận điều khoản.

Nếu thiếu bất kỳ điều kiện tiên quyết nào, công cụ sẽ trả về lỗi có hướng dẫn hành động, cho biết bạn cần khắc phục điều gì và liên kết đến trang nơi bạn có thể khắc phục.

Kết nối ứng dụng

Để kết nối ứng dụng được hỗ trợ và hoàn tất ủy quyền OAuth, hãy làm theo hướng dẫn Kết nối ứng dụng MCP với Meta. Sử dụng tên máy chủ và điểm cuối trong phần Tổng quan. Máy chủ này không yêu cầu client ID, vì vậy hãy sử dụng đăng ký tự động.

Phạm vi quyền

Máy chủ yêu cầu các quyền sau trong quá trình chấp thuận:

Phạm vi	Quyền truy cập
business_management	Khám phá và thao tác trên các doanh nghiệp bạn quản trị đã chọn trong quá trình chấp thuận.
whatsapp_business_management	Quản lý tài khoản WhatsApp Business, số điện thoại, mẫu tin nhắn và webhook.
whatsapp_business_messaging	Gửi tin nhắn từ các số điện thoại đã đăng ký của bạn.

Bạn có thể xem lại các quyền này và thu hồi quyền truy cập trên Facebook tại Cài đặt > Hoạt động của bạn > Tích hợp doanh nghiệp.

Xác minh kết nối

Yêu cầu tác nhân liệt kê các công cụ mà nó có từ máy chủ này, bằng tên bạn đã đặt khi kết nối. Sau đó chạy một công cụ chỉ đọc, chẳng hạn như whatsapp_biz_businesses để liệt kê các doanh nghiệp bạn quản trị. Kết nối hoạt động bình thường khi lệnh gọi đó trả về các doanh nghiệp của bạn thay vì lỗi xác thực hoặc quyền truy cập.

Giới hạn tốc độ

Các yêu cầu được giới hạn tốc độ theo từng người dùng và từng công cụ để bảo vệ nền tảng. Nếu vượt quá giới hạn, công cụ sẽ trả về lỗi giới hạn tốc độ; hãy thử lại sau một lúc.

Công cụ

WhatsApp Business Tools MCP cung cấp các công cụ có tiền tố không gian tên whatsapp_biz_. Hầu hết công cụ được giới hạn trong phạm vi một doanh nghiệp bạn quản trị, vì vậy một phiên làm việc thông thường bắt đầu bằng việc liệt kê các doanh nghiệp của bạn và chọn một doanh nghiệp. Bộ công cụ đang được hoàn thiện trong giai đoạn beta.

Khám phá

• whatsapp_biz_businesses — Liệt kê các doanh nghiệp bạn quản trị và đã cấp quyền trong quá trình chấp thuận. Hãy dùng công cụ này trước để chọn một doanh nghiệp. Ví dụ: "Liệt kê các doanh nghiệp tôi có thể quản lý trên WhatsApp."
• whatsapp_biz_accounts — Liệt kê các tài khoản WhatsApp (và tài khoản nhắn tin) thuộc một doanh nghiệp. Ví dụ: "Hiển thị các tài khoản WhatsApp của doanh nghiệp 1234567890."
• whatsapp_biz_phone_numbers — Liệt kê các số điện thoại thuộc một doanh nghiệp hoặc tài khoản WhatsApp, kèm trạng thái và tình trạng tiếp nhận. Ví dụ: "Liệt kê các số điện thoại và trạng thái của chúng trong doanh nghiệp này."

Tiếp nhận số điện thoại

• whatsapp_biz_add_phone_number — Thêm số điện thoại vào tài khoản WhatsApp. Ví dụ: "Thêm số điện thoại +1 555 010 1234 vào tài khoản WhatsApp của tôi."
• whatsapp_biz_send_verification_code — Gửi mã xác minh đến một số điện thoại. Ví dụ: "Gửi mã xác minh qua SMS đến số này."
• whatsapp_biz_verify_phone_number — Xác minh số điện thoại bằng mã đã nhận. Ví dụ: "Xác minh số này bằng mã 123456."
• whatsapp_biz_register_phone_number — Đăng ký số đã xác minh để số đó có thể gửi và nhận tin nhắn. Ví dụ: "Đăng ký số này để nhắn tin."

Mẫu tin nhắn

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Liệt kê và xem chi tiết các mẫu tin nhắn trong một tài khoản. Ví dụ: "Liệt kê các mẫu đã được phê duyệt cho tài khoản này."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Tạo, cập nhật và xóa mẫu tin nhắn. Ví dụ: "Tạo mẫu tiếp thị có tên order_update bằng en_US."

Nhắn tin

• whatsapp_biz_send_message — Gửi văn bản tự do (chỉ được gửi trong cửa sổ dịch vụ khách hàng 24 giờ) hoặc tin nhắn mẫu đã được phê duyệt từ một số đã đăng ký. Xác nhận người nhận với bạn trước khi gửi. Ví dụ: "Gửi mẫu order_update đến +1 555 010 9999 từ số này."

Webhook

• whatsapp_biz_configure_webhooks — Đặt URL callback và mã thông báo xác minh cho chủ đề WhatsApp, đồng thời đăng ký các trường được phép. Ví dụ: "Cấu hình webhook cho doanh nghiệp này với callback https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Đăng ký tài khoản WhatsApp với webhook của ứng dụng để gửi các sự kiện của tài khoản đó. Ví dụ: "Đăng ký tài khoản WhatsApp này với webhook."

Thiết lập tài khoản

• whatsapp_biz_configure_payments — Cấu hình phương thức thanh toán để tài khoản có thể gửi tin nhắn tính phí. Ví dụ: "Giúp tôi thiết lập thanh toán cho tài khoản này."
• whatsapp_biz_verify_business — Kiểm tra và bắt đầu xác minh doanh nghiệp. Ví dụ: "Trạng thái xác minh doanh nghiệp là gì và tôi bắt đầu xác minh như thế nào?"
• whatsapp_biz_system_user_token — Lấy liên kết để tạo mã truy cập người dùng hệ thống cho doanh nghiệp của bạn, giúp bạn xây dựng giải pháp nhắn tin tùy chỉnh gọi trực tiếp WhatsApp Cloud API. Việc tạo mã diễn ra an toàn trong Business Settings — công cụ trả về liên kết sâu đến trang System Users, nơi bạn chọn người dùng hệ thống và tạo mã. Để tìm hiểu thêm, xem Tạo người dùng hệ thống và tạo mã truy cập vĩnh viễn. Ví dụ: "Cho tôi liên kết để tạo mã truy cập người dùng hệ thống cho doanh nghiệp này."

Phản hồi

Nếu bạn có ý kiến phản hồi hoặc muốn có thêm công cụ, hãy chia sẻ phản hồi.

Liên quan

• Tổng quan về MCP
• Kết nối ứng dụng MCP với Meta
• Tài liệu WhatsApp Business Platform

---

Chỉ mục tài liệu đầy đủ cho sản phẩm này: https://developers.facebook.com/documentation/mcp/llms.txt