WhatsApp MCP

npx add-mcp 'https://server.wa-mcp.com/mcp'

Tài liệu WhatsApp MCP

WhatsApp MCP kết nối trợ lý AI của bạn (Claude, ChatGPT, Cursor hoặc bất kỳ ứng dụng nào hỗ trợ Model Context Protocol) với số WhatsApp bạn đang dùng. Trợ lý có thể đọc và tìm kiếm các cuộc trò chuyện, tìm những người đang chờ bạn trả lời, cũng như gửi, lên lịch, chỉnh sửa hoặc bày tỏ cảm xúc với tin nhắn — luôn từ số của bạn và chỉ khi bạn yêu cầu.

WhatsApp MCP kết nối với WhatsApp dưới dạng thiết bị được liên kết, giống như WhatsApp Web. Bạn không cần cài ứng dụng, dùng số mới hay Meta Business API.

Thiết lập

Bạn chỉ cần kết nối một lần, sau đó liên kết WhatsApp ngay trong cuộc trò chuyện.

Tùy chọn A: Danh mục connector của Claude

1. Trong Claude, mở danh mục connector và tìm WhatsApp MCP.
2. Nhấp Connect. Trang kết nối của chúng tôi sẽ mở ra: kiểm tra xem trang có ghi tên ứng dụng AI của bạn không, rồi nhấp Connect lần nữa.
3. Quay lại Claude, mở cuộc trò chuyện mới và nhập "Connect my WhatsApp" (xem phần "Liên kết WhatsApp" bên dưới).

Bạn không cần đăng ký hay mật khẩu: số WhatsApp là tài khoản của bạn, và việc liên kết số đó giúp chúng tôi xác nhận bạn là ai.

Tùy chọn B: URL kết nối cá nhân (mọi ứng dụng MCP)

1. Truy cập wa-mcp.com, chọn ứng dụng AI rồi nhấp Generate my link.
2. Thêm liên kết vào ứng dụng AI dưới dạng connector tùy chỉnh (máy chủ MCP). Trang web hướng dẫn chính xác các bước cho từng ứng dụng, còn How to Connect Claude to WhatsApp hướng dẫn từng bước cho Claude.
3. Mở cuộc trò chuyện mới và nhập "Connect my WhatsApp".

Hãy giữ kín liên kết: liên kết này hoạt động như mật khẩu. Bạn có thể dùng cùng một liên kết trong nhiều ứng dụng AI.

Liên kết WhatsApp

Khi bạn yêu cầu trợ lý kết nối WhatsApp, trợ lý sẽ đưa ra hai cách:

• Mã QR: trợ lý hiển thị mã QR (và liên kết đến trang có mã này). Trên điện thoại, mở WhatsApp → Settings → Linked devices → Link a device rồi quét mã.
• Mã ghép nối: cung cấp cho trợ lý số điện thoại kèm mã quốc gia. Trợ lý sẽ trả về mã gồm 8 ký tự. Trên điện thoại, mở Linked devices → Link a device → Link with phone number instead rồi nhập mã.

Sau khi liên kết, WhatsApp đồng bộ lịch sử gần đây (tối đa khoảng 90 ngày) với thiết bị được liên kết. Việc này có thể mất vài phút nếu tài khoản có nhiều dữ liệu.

Gói dịch vụ

• Dùng thử miễn phí: sử dụng mọi tính năng trong 1 giờ sau lần đầu tiên bạn liên kết điện thoại.
• Gói miễn phí: sau thời gian dùng thử, bạn vẫn có thể đọc, tóm tắt và tìm kiếm cuộc trò chuyện cũng như gửi tin nhắn văn bản. Tin nhắn văn bản sẽ kết thúc bằng "Sent via wa-mcp.com", và bạn không thể bắt đầu cuộc trò chuyện mới (với những người chưa nhắn cho bạn trong 90 ngày qua).
• Gói trả phí: gửi tệp (ảnh, video, tin nhắn thoại, tài liệu), lên lịch tin nhắn, chỉnh sửa, bày tỏ cảm xúc và xóa tin nhắn, bắt đầu cuộc trò chuyện mới với các biện pháp bảo vệ chống khóa tài khoản, và không có nhãn.

Hỏi trợ lý "What plan am I on?" để xem gói dịch vụ và các tùy chọn đăng ký.

Công cụ

Trợ lý sẽ chọn công cụ; bạn chỉ cần yêu cầu bằng ngôn ngữ thông thường.

Đọc tin nhắn

Công cụ	Chức năng
get_recent_chats	Các cuộc trò chuyện gần đây nhất, kèm tin nhắn mới nhất của mỗi cuộc trò chuyện.
get_unanswered_chats	Các cuộc trò chuyện có tin nhắn cuối cùng do người kia gửi, để bạn biết ai đang chờ trả lời.
read_chat_history	Tin nhắn trong một cuộc trò chuyện, với một người hoặc một nhóm.
search_messages	Tìm kiếm nội dung tin nhắn, có thể giới hạn trong một cuộc trò chuyện hoặc tin nhắn từ một người.
search_contacts	Tìm liên hệ hoặc nhóm theo tên hoặc số điện thoại.
download_media	Mở ảnh, tin nhắn thoại, video, tài liệu hoặc nhãn dán trong tin nhắn.
get_writing_style	Ví dụ về cách bạn viết để bản nháp được soạn thay bạn nghe giống giọng văn của bạn.

Gửi tin nhắn

Công cụ	Chức năng
send_message	Gửi tin nhắn văn bản hoặc tệp từ liên kết cho một người hoặc nhóm. Trước tiên, hiển thị trạng thái đang nhập.
schedule_message	Lên lịch gửi tin nhắn vào thời điểm sau đó, một lần hoặc lặp lại (hằng ngày, hằng tuần, hằng tháng, v.v.).
list_scheduled_messages	Liệt kê các tin nhắn đã lên lịch sắp tới và lịch sử tin nhắn đã lên lịch trước đó.
cancel_scheduled_message	Hủy một tin nhắn đã lên lịch (bao gồm tất cả các lần lặp lại).
react_to_message	Bày tỏ cảm xúc với tin nhắn bằng emoji hoặc gỡ cảm xúc đó.
edit_message	Thay đổi nội dung tin nhắn do bạn gửi.
delete_message	Xóa tin nhắn do bạn gửi đối với tất cả mọi người.
mark_as_read	Đánh dấu cuộc trò chuyện là đã đọc.

Kết nối và tài khoản

Công cụ	Chức năng
get_session_status	Kiểm tra WhatsApp của bạn đã được liên kết và kết nối hay chưa.
get_pairing_qr	Bắt đầu liên kết bằng mã QR.
request_pairing_code	Bắt đầu liên kết bằng mã ghép nối.
restart_session	Kết nối lại với WhatsApp nếu tin nhắn ngừng đến.
manage_subscription	Hiển thị gói dịch vụ và các tùy chọn đăng ký.
report_feedback	Gửi cho chúng tôi báo cáo lỗi hoặc yêu cầu tính năng.
unlink_whatsapp	Hủy liên kết WhatsApp (tài khoản của bạn vẫn được giữ lại).
delete_account	Xóa tài khoản và toàn bộ dữ liệu sau khi bạn xác nhận.

Ví dụ câu lệnh

• "Ai đang chờ tôi trả lời từ hôm qua?"
• "Tóm tắt những gì nhóm gia đình đã bàn trong tuần này."
• "Tìm tin nhắn Carlos gửi cho tôi có địa chỉ."
• "Báo Ana rằng đơn hàng sẽ được gửi đi vào thứ Năm." (trợ lý sẽ hiển thị bản nháp trước, trừ khi bạn đã cung cấp chính xác nội dung cần gửi)
• "Mỗi thứ Hai lúc 9 giờ sáng, nhắc nhóm làm việc gửi cập nhật hằng tuần."

An toàn

• Bạn luôn kiểm soát nội dung được gửi. Khi trợ lý soạn tin nhắn thay bạn, trợ lý sẽ hiển thị bản nháp trước khi gửi, trừ khi bạn đã cung cấp chính xác nội dung.
• Biện pháp bảo vệ chống khóa tài khoản. Tin nhắn gửi cho những người chưa nhắn cho bạn trong 90 ngày qua sẽ được giãn cách (tối đa 1 tin nhắn mỗi phút và 10 người khác nhau trong mỗi 12 giờ), vì gửi dồn dập có thể khiến số điện thoại bị đánh dấu là spam. Không giới hạn tin nhắn trong các cuộc trò chuyện với người đã nhắn cho bạn. Không có công cụ gửi hàng loạt.
• Trạng thái đang nhập. Trước mỗi tin nhắn sẽ xuất hiện thông báo ngắn "typing…", giống như khi bạn tự nhập tin nhắn.

Khắc phục sự cố

• "WhatsApp is not linked": thiết bị được liên kết đã bị gỡ (trên điện thoại của bạn hoặc do bạn hủy liên kết). Yêu cầu trợ lý kết nối lại WhatsApp bằng cùng số điện thoại.
• Mã ghép nối không hoạt động: mã sẽ hết hạn sau một thời gian ngắn. Yêu cầu mã mới, kiểm tra số điện thoại có mã quốc gia và chọn Link with phone number instead trên điện thoại.
• Tin nhắn ngừng đến: yêu cầu trợ lý khởi động lại kết nối WhatsApp. Nếu WhatsApp trên điện thoại của bạn ngoại tuyến khoảng 14 ngày, WhatsApp sẽ đăng xuất các thiết bị được liên kết: mở WhatsApp trên điện thoại rồi liên kết lại.
• "This connection is permanently registered to phone number…": mỗi kết nối chỉ thuộc về một số điện thoại. Để dùng số khác, hãy hủy liên kết, sau đó xóa connector rồi thêm lại (hoặc tạo URL cá nhân mới nếu bạn đang dùng URL cá nhân).
• Connector báo chưa kết nối (người dùng danh mục): xóa WhatsApp MCP khỏi danh sách connector rồi kết nối lại, sau đó liên kết cùng điện thoại. Tài khoản và gói đăng ký của bạn vẫn được giữ nguyên.

Quyền riêng tư và dữ liệu của bạn

Tin nhắn được lưu trên máy chủ của chúng tôi trong 90 ngày để trợ lý có thể tìm kiếm, và không bao giờ được dùng cho quảng cáo hoặc huấn luyện AI. Nội dung trợ lý đọc được sẽ do nhà cung cấp của trợ lý xử lý theo chính sách của họ. Bạn có thể yêu cầu trợ lý hủy liên kết WhatsApp hoặc xóa tài khoản bất cứ lúc nào; khi xóa, mọi dữ liệu sẽ bị xóa ngay lập tức. Xem đầy đủ chi tiết trong Privacy Policy và Terms.