WhatsApp Business Tools MCP

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

Dành cho các nhà phát triển xây dựng trên Nền tảng WhatsApp Business (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 của bạn từ một nơi duy nhất. Nó cho phé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ị, đăng ký 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 — hoạt động thay bạn, trên các ứng dụng và doanh nghiệp mà bạn quản trị.

Lưu ý: Máy chủ WhatsApp Business Tools MCP đang được triển khai dần dần và có thể chưa khả dụng cho tất cả mọi người. Giao diện và bộ công cụ đang trong giai đoạn beta và có thể thay đổi.

Tổng quan

Bảng sau đây tóm tắt chi tiết 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)
Trạng thái	Beta - giao diện và bộ công cụ có thể thay đổi

Điều kiện tiên quyết

Máy chủ hoạt động 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ần:

• Quyền quản trị đối với doanh nghiệp bạn muốn quản lý (vai trò MANAGE).
• Một ứng dụng hỗ trợ WhatsApp mà bạn là quản trị viên, được kết nối với doanh nghiệp đó — một ứ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 đó. Việc gửi tin nhắn và đăng ký số điện thoại sẽ bị chặn cho đến khi quản trị viên chấp nhận chúng.

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ó thể hành động cho bạn biết cần sửa gì và liên kết đến trang nơi bạn có thể sửa.

Thiết lập IDE hoặc ứng dụng khách tác nhân của bạn

Máy chủ WhatsApp Business Tools MCP là máy chủ từ xa. Các ứng dụng khách hỗ trợ máy chủ MCP từ xa có thể kết nối trực tiếp đến điểm cuối. Đối với các ứng dụng khách chỉ hỗ trợ máy chủ cục bộ (stdio), hãy sử dụng cầu nối mcp-remote, cầu nối này ủy quyền máy chủ từ xa qua stdio.

Cấu hình ứng dụng khách của bạn bằng một trong các phần bên dưới, sau đó hoàn tất đăng nhập OAuth để xác thực.

Claude Code và Desktop

Claude Code — chạy lệnh sau để thêm máy chủ:

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

Sau đó chạy /mcp trong phiên và chọn whatsapp_business_tools để xác thực.

Claude Desktop — mở Cài đặt > Trình kết nối > Thêm trình kết nối tùy chỉnh, sau đó đặt:

• Tên: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools

OpenAI Codex App và ChatGPT

Codex App — mở Cài đặt (biểu tượng bánh răng, góc dưới bên trái) > Máy chủ MCP > Thêm máy chủ, chọn Streamable HTTP, sau đó đặt:

• Tên: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Xác thực: OAuth

Nhấp Xác thực và hoàn tất đăng nhập OAuth.

ChatGPT — mở Cài đặt > Plugin > Duyệt plugin, nhấp + ở góc trên bên phải để thêm plugin mới, sau đó đặt:

• Tên: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Xác thực: OAuth

Lưu plugin và hoàn tất đăng nhập OAuth.

Đăng nhập OAuth

Máy chủ WhatsApp Business Tools MCP xác thực bằng tài khoản nhà phát triển Meta của bạn qua OAuth, vì vậy quy trình đăng nhập tương tự hoạt động với mọi ứng dụng khách.

Quy trình đăng nhập

Sau khi bạn thêm máy chủ vào ứng dụng khách của mình (xem Thiết lập IDE hoặc ứng dụng khách tác nhân của bạn):

1. Bắt đầu kết nối. Nhiều ứng dụng khách tự động bắt đầu quy trình OAuth khi máy chủ được thêm. Các ứng dụng khác yêu cầu bạn nhấp Kết nối hoặc Xác thực trước.
2. Đăng nhập. Trình duyệt của bạn mở ra để đăng nhập bằng tài khoản Meta của bạn. Nếu nó không tự động mở, hãy sao chép liên kết mà ứng dụng khách của bạn in ra và mở thủ công.
3. Cấp quyền truy cập. Trên màn hình đồng ý, chọn các doanh nghiệp và ứng dụng hỗ trợ WhatsApp mà bạn muốn máy chủ truy cập.
4. Xác nhận. Quay lại ứng dụng khách của bạn và xác minh kết nối của bạn.

Bạn sẽ cần hoàn tất quy trình đăng nhập lại khi khởi động lại ứng dụng khách.

Phạm vi

Máy chủ yêu cầu các quyền sau trong quá trình đồng ý:

Phạm vi	Quyền truy cập
business_management	Khám phá và hành động trên các doanh nghiệp bạn quản trị mà bạn đã chọn trong quá trình đồng ý.
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 hoặc thu hồi quyền truy cập bất cứ lúc nào tại facebook.com > Cài đặt > Tích hợp doanh nghiệp.

Xác minh kết nối của bạn

Sau khi thêm máy chủ, hãy xác nhận tác nhân của bạn có thể thấy các công cụ:

1. Khởi động lại IDE hoặc ứng dụng khách tác nhân.
2. Yêu cầu tác nhân liệt kê các công cụ mà nó có từ máy chủ whatsapp_business_tools.
3. Chạy một công cụ đọc có rủi ro thấp. Ví dụ: yêu cầu nó liệt kê các doanh nghiệp bạn quản trị bằng whatsapp_biz_businesses.

Nếu tác nhân báo cáo không có công cụ hoặc lỗi xác thực, hãy kiểm tra lại URL điểm cuối và xác nhận bạn đã hoàn tất quy trình đăng nhập.

Công cụ

WhatsApp Business Tools MCP hiển thị các công cụ có tên được đặt tiền tố whatsapp_biz_. Hầu hết các công cụ được giới hạn trong một doanh nghiệp bạn quản trị, vì vậy một phiên điển hình 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 phát triể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à bạn đã cấp quyền trong quá trình đồng ý. Sử dụng công cụ này trước tiên để 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) trong một doanh nghiệp. Ví dụ: "Hiển thị các tài khoản WhatsApp cho doanh nghiệp 1234567890."
• whatsapp_biz_phone_numbers — Liệt kê các số điện thoại trên một doanh nghiệp hoặc tài khoản WhatsApp, kèm trạng thái và trạng thái đăng ký. Ví dụ: "Liệt kê các số điện thoại và trạng thái của chúng cho doanh nghiệp này."

Đăng ký 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ý một số đã xác minh để nó có thể gửi và 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à kiểm tra các mẫu tin nhắn trên 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 các 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 tin nhắn 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 và đă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ý một tài khoản WhatsApp vào webhook của ứng dụng của bạn để các sự kiện của nó được gửi đến. Ví dụ: "Đăng ký tài khoản WhatsApp này vào 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à làm cách nào để bắt đầu?"
• whatsapp_biz_system_user_token — Lấy liên kết để tạo mã thông báo truy cập người dùng hệ thống cho doanh nghiệp của bạn, để bạn có thể 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ã thông báo diễn ra an toàn trong Cài đặt doanh nghiệp — công cụ trả về liên kết sâu đến trang Người dùng hệ thống, nơi bạn chọn người dùng hệ thống và tạo mã thông báo. Để tìm hiểu thêm, hãy xem <a href="/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token" target="_blank">Tạo người dùng hệ thống và tạo mã thông báo truy cập vĩnh viễn</a>. Ví dụ: "Cung cấp cho tôi liên kết để tạo mã thông báo truy cập người dùng hệ thống cho doanh nghiệp này."

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 cho từng công cụ để bảo vệ nền tảng. Nếu bạn 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 khoảng thời gian ngắn.

Phản hồi

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

Liên quan

• Tổng quan MCP
• Tài liệu Nền tảng WhatsApp Business

---

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