WhatsApp Business Tools MCP: Cách kết nối WhatsApp Business với agent AI

Ngày 15 tháng 9 năm 2026, Meta phát hành máy chủ WhatsApp Business Tools MCP chính thức. Máy chủ kết nối một agent AI—Claude Code, Codex, ChatGPT hoặc Cursor—với WhatsApp Business Platform. Thay vì chuyển qua lại giữa Developer Console, Business Manager và tài liệu API, bạn mô tả nhiệm vụ cho agent, rồi agent sẽ thêm số điện thoại, tạo mẫu tin nhắn, cấu hình webhook và gửi tin nhắn thử.

Máy chủ vẫn đang trong giai đoạn beta: quyền truy cập được triển khai dần và bản phát hành này dành cho phát triển, thử nghiệm, không phải gửi tin nhắn ở quy mô lớn trong môi trường sản xuất. Dưới đây là các bước chuẩn bị và kết nối cho bốn ứng dụng khách. Các lệnh và cài đặt đã được đối chiếu với tài liệu chính thức của Meta vào ngày 18 tháng 9 năm 2026.

Thông tin về cách làm việc với Ailoot có trong tài liệu.

WhatsApp Business Tools MCP là gì?#

MCP (Model Context Protocol) là một tiêu chuẩn mở để kết nối các hệ thống bên ngoài với agent AI. Tìm hiểu thêm trong bài viết Máy chủ MCP cho Claude Code: 7 tích hợp có sẵn. Danh mục MCP liệt kê các kết nối đã được xác minh cùng lệnh cài đặt.

Trước khi có bản phát hành này, việc thiết lập tích hợp WhatsApp diễn ra như sau: mở Developer Console, tạo ứng dụng, liên kết doanh nghiệp, thêm số điện thoại, xác minh số bằng mã, tạo token, cấu hình webhook, xem tài liệu API—rồi mới viết dòng mã đầu tiên.

Meta mô tả ý tưởng đằng sau máy chủ như sau (dịch từ tiếng Anh):

Hiện Meta có hai máy chủ MCP, và rất dễ nhầm lẫn giữa chúng. Meta Social Technologies MCP là công cụ phát triển đa năng: tìm kiếm tài liệu, khám phá các endpoint của Graph API và chẩn đoán lỗi ứng dụng. WhatsApp Business Tools MCP dùng để làm việc với tài khoản WhatsApp, số điện thoại, mẫu tin nhắn, webhook và tin nhắn thử. Hai máy chủ bổ trợ cho nhau; nếu cần, bạn có thể kết nối cả hai.

Sau khi kết nối, agent có thể làm chính xác những gì?#

Các công cụ của máy chủ được nhóm theo tiền tố whatsapp_biz_. Theo tài liệu chính thức:

• Tổng quan: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers—các doanh nghiệp, tài khoản và số điện thoại nào khả dụng với bạn.
• Thiết lập số điện thoại: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Mẫu tin nhắn: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Tin nhắn: whatsapp_biz_send_message—văn bản tự do trong cửa sổ hội thoại 24 giờ hoặc mẫu tin đã được phê duyệt khi ngoài khoảng thời gian này; agent xác nhận người nhận với bạn trước khi gửi.
• Webhook: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Thiết lập tài khoản: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token—liên kết để tạo token người dùng hệ thống dùng cho các lệnh gọi Cloud API trực tiếp.

Khi khách hàng nhắn cho doanh nghiệp trước, cửa sổ dịch vụ khách hàng sẽ mở: bạn có thể trả lời bằng văn bản tự do trong 24 giờ. Mỗi tin nhắn mới của khách hàng sẽ kéo dài cửa sổ này. Khi cửa sổ đóng, bạn chỉ có thể liên hệ khách hàng bằng mẫu tin đã được phê duyệt. Agent biết quy tắc này và nếu người nhận ở ngoài cửa sổ, agent sẽ đề xuất gửi mẫu tin thay vì văn bản thông thường.

Máy chủ được tích hợp sẵn các biện pháp kiểm soát truy cập. Bạn đăng nhập qua tài khoản Meta và chọn những doanh nghiệp cụ thể; token không được đưa vào lịch sử hội thoại. Mỗi lần đọc đều diễn ra trong ngữ cảnh của bạn, các lệnh gọi được ghi nhật ký và hành động tạo ra thay đổi cần có người đã xác thực; chỉ có khóa ứng dụng máy chủ là chưa đủ.

Bạn nên kiểm tra điều gì trước khi kết nối?#

Máy chủ thay mặt bạn thực hiện thao tác và chỉ làm việc với tài nguyên của bạn, vì vậy hãy kiểm tra những điều sau trước lần gọi đầu tiên:

1. Bạn có một doanh nghiệp Meta mà mình là quản trị viên (vai trò MANAGE).
2. Bạn có một ứng dụng Meta đã bật kịch bản WhatsApp Business Messaging (hoặc sản phẩm WhatsApp trong các ứng dụng cũ hơn), và bạn là quản trị viên của chính ứng dụng đó; chỉ có quyền ở cấp doanh nghiệp là chưa đủ.
3. Doanh nghiệp đã chấp nhận các điều khoản WhatsApp Business Cloud API—nếu chưa, việc đăng ký số điện thoại và gửi tin nhắn sẽ bị chặn.

Theo Meta, các vấn đề về điều khoản sử dụng, phương thức thanh toán và xác minh doanh nghiệp thường phát sinh mà không có lời giải thích rõ ràng. Agent kiểm tra trước những vấn đề này và cung cấp liên kết trực tiếp để bạn chấp nhận điều khoản, chỉ định phương thức thanh toán hoặc bắt đầu xác minh doanh nghiệp.

Kết nối máy chủ với Claude Code như thế nào?#

Nếu chưa cài đặt Claude Code, hãy bắt đầu với hướng dẫn Cách cài đặt Claude Code từ trang web chính thức.

1. Thêm máy chủ

   Trong terminal, chạy:

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

   Máy chủ ở dạng từ xa nên bạn không cần cài đặt cục bộ.

2. Đăng nhập qua Meta

   Trong phiên Claude Code, nhập /mcp và chọn whatsapp_business_tools. Một cửa sổ trình duyệt sẽ mở để bạn đăng nhập vào tài khoản Meta. Nếu trình duyệt không mở, hãy sao chép liên kết từ ứng dụng khách và mở thủ công.

3. Cấp quyền

   Trên màn hình chấp thuận, chọn các doanh nghiệp và ứng dụng có WhatsApp mà bạn cho phép truy cập. Máy chủ sẽ yêu cầu ba quyền: business_management (tìm doanh nghiệp mà bạn là quản trị viên), whatsapp_business_management (tài khoản, số điện thoại, mẫu tin nhắn, webhook) và whatsapp_business_messaging (gửi tin nhắn từ các số của bạn).

4. Kiểm tra kết nối

   Khởi động lại Claude Code, đăng nhập lại qua /mcp và hỏi agent xem nó thấy những công cụ nào trên máy chủ whatsapp_business_tools. Sau đó thực hiện thao tác đọc an toàn: “Liệt kê các doanh nghiệp tôi có thể quản lý”—agent sẽ gọi whatsapp_biz_businesses. Nếu không có công cụ nào hoặc bạn nhận được lỗi đăng nhập, hãy kiểm tra địa chỉ máy chủ và đăng nhập lại.

Đăng nhập OAuth gắn với lần khởi chạy ứng dụng khách: sau khi khởi động lại Claude Code, bạn cần đăng nhập lại. Bạn có thể thu hồi quyền truy cập bất kỳ lúc nào trong phần cài đặt trên facebook.com, mục “Business Integrations.”

Kết nối Codex, ChatGPT và Claude Desktop như thế nào?#

Codex App. Mở cài đặt (biểu tượng bánh răng ở góc dưới bên trái), vào MCP Servers và chọn Add servers. Chọn Streamable HTTP rồi nhập:

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

Nhấp Authenticate và đăng nhập trong trình duyệt.

ChatGPT. Settings, Plugins, Browse plugins, biểu tượng “+” ở góc trên bên phải. Nhập tên, cùng URL đó và OAuth làm loại xác thực.

Claude Desktop. Settings, Connectors, Add custom connector. Tên: WhatsApp Business Tools; URL: cùng địa chỉ máy chủ.

Sau khi thêm trong bất kỳ ứng dụng khách nào, hãy làm theo cùng một trình tự kiểm tra: khởi động lại, đăng nhập lại, xem danh sách công cụ và đọc danh sách doanh nghiệp một cách an toàn.

Phiên đầu tiên diễn ra thế nào: từ danh sách doanh nghiệp đến tin nhắn thử?#

Một phiên đầu tiên điển hình với máy chủ đã kết nối:

1. “Liệt kê các doanh nghiệp tôi quản lý”—agent gọi whatsapp_biz_businesses, rồi bạn chọn doanh nghiệp cần dùng.
2. “Cho tôi xem các tài khoản WhatsApp và số điện thoại của doanh nghiệp này”—whatsapp_biz_accounts và whatsapp_biz_phone_numbers, cùng trạng thái của chúng.
3. “Thêm số điện thoại thử nghiệm của tôi vào tài khoản”—whatsapp_biz_add_phone_number.
4. “Gửi mã xác minh qua SMS”—whatsapp_biz_send_verification_code. Mã sẽ đến điện thoại của bạn.
5. “Xác minh số bằng mã 123456”—whatsapp_biz_verify_phone_number, sau đó đăng ký số bằng whatsapp_biz_register_phone_number.
6. “Tạo mẫu order_update bằng ngôn ngữ người nhận ưu tiên để thông báo đơn hàng”—whatsapp_biz_create_template; agent sẽ cung cấp liên kết đến trạng thái phê duyệt.
7. “Gửi tin nhắn thử đến số của tôi”—whatsapp_biz_send_message; agent sẽ xác nhận người nhận trước khi gửi.
8. “Cấu hình webhook tại https://example.com/webhook”—whatsapp_biz_configure_webhooks và đăng ký nhận bằng whatsapp_biz_subscribe_webhook.

Sau đó, tin nhắn đến từ khách hàng sẽ được gửi đến địa chỉ đã chỉ định—thường là CRM, dịch vụ hỗ trợ khách hàng hoặc bot truy xuất chúng tại đó. Bạn xây dựng phần xử lý ở địa chỉ đó riêng; máy chủ chỉ xử lý cấu hình.

Phiên bản beta có những hạn chế nào?#

Có bốn hạn chế của máy chủ cần lưu ý.

Trạng thái beta. Meta cho biết giao diện và bộ công cụ có thể thay đổi, còn quyền truy cập được triển khai dần. Nếu bạn chưa kết nối được với máy chủ, có thể dịch vụ chưa được cung cấp cho bạn.

Mục đích. Bản phát hành dành cho phát triển và thử nghiệm; không nhằm phục vụ việc gửi tin nhắn hàng loạt trong môi trường sản xuất. Để gửi tin nhắn trong môi trường sản xuất, bạn cần tích hợp đầy đủ với Cloud API—ví dụ như dùng token người dùng hệ thống, liên kết tạo token được cung cấp bởi công cụ whatsapp_biz_system_user_token.

Giới hạn. Số lượng yêu cầu bị giới hạn theo từng người dùng cho mỗi công cụ. Nếu vượt quá giới hạn, công cụ sẽ trả về lỗi giới hạn—hãy chờ rồi thử lại.

Quy tắc cửa sổ 24 giờ. Khi ở ngoài cửa sổ hội thoại với khách hàng, bạn chỉ có thể gửi các mẫu tin đã được phê duyệt.

Điều này có ý nghĩa gì đối với doanh nghiệp?#

Một tình huống điển hình của doanh nghiệp nhỏ: khách hàng nhắn tin qua WhatsApp và bạn muốn trả lời nhanh, đồng thời gửi thông báo trạng thái đơn hàng. Trước đây, việc thiết lập ban đầu đòi hỏi bạn tự làm việc trên nhiều bảng điều khiển Meta hoặc thuê lập trình viên. Giờ đây, bạn có thể hoàn tất phần này qua một cuộc hội thoại với agent. Bạn vẫn cần xây dựng riêng cách xử lý tin nhắn đến tại địa chỉ của mình—đó là nhiệm vụ tiếp theo sau khi cấu hình webhook.

Máy chủ cũng hữu ích nếu tích hợp của bạn đã chạy. Mẫu tin nhắn cần được cập nhật thường xuyên: chương trình khuyến mãi mới, nội dung thông báo mới. Thông qua máy chủ, agent tạo hoặc chỉnh sửa mẫu tin và hiển thị trạng thái phê duyệt mà không cần đưa bạn đến bảng điều khiển.

Một cách tiếp cận tương tự—agent kết nối với hệ thống bên ngoài và làm việc với hệ thống đó dựa trên mô tả của bạn—được minh họa kèm tài liệu trong hướng dẫn Cách kết nối NotebookLM với Claude Code thông qua MCP.

Tiếp theo nên làm gì?#

Máy chủ được công bố cách đây ba ngày. Bạn có thể bắt đầu bằng một lệnh và đăng nhập qua Meta, rồi yêu cầu agent liệt kê các doanh nghiệp của mình. Tiếp theo, tùy theo nhu cầu: số điện thoại, mẫu tin, webhook và tin nhắn thử.

Các cách khác để kết nối agent với hệ thống bên ngoài có trong bộ sưu tập Máy chủ MCP cho Claude Code—còn có thêm bảy tích hợp đang hoạt động cho nhiều nhiệm vụ khác nhau.

Tìm hiểu Ailoot.