WhatsApp — AI cho Ứng Dụng Nhắn Tin Được Dùng Nhiều Nhất Thế Giới

WhatsApp ở khắp mọi nơi. Hơn hai tỷ người sử dụng nó mỗi ngày, và giờ đây bạn có thể cắm Hermes thẳng vào đó. Không cần tài khoản nhà phát triển Meta. Không cần xác minh doanh nghiệp. Không cần thiết lập API phức tạp. Chỉ cần quét mã QR và bạn đã có thể trò chuyện với AI agent của mình ngay từ chính ứng dụng bạn dùng để nhắn tin cho bạn bè.

Cách Thức Hoạt Động

Hermes kết nối với WhatsApp thông qua một cầu nối tích hợp dựa trên Baileys. Hãy hình dung nó như việc mô phỏng một phiên WhatsApp Web — giống hệt cách bạn liên kết trình duyệt với điện thoại của mình. Đây không phải là WhatsApp Business API chính thức, nghĩa là bạn không cần bất kỳ sự chấp thuận đặc biệt nào để bắt đầu.

Chạy hermes gateway setup và chọn WhatsApp để được hướng dẫn từng bước.

Hai Cách Sử Dụng

Chế độ	Cách hoạt động	Phù hợp nhất cho
Số bot riêng biệt (khuyến nghị)	Dành riêng một số điện thoại cho bot. Mọi người nhắn tin trực tiếp đến số đó.	Trải nghiệm người dùng sạch sẽ, nhiều người dùng, rủi ro khóa tài khoản thấp hơn
Tự nhắn cho chính mình	Sử dụng WhatsApp của bạn. Bạn nhắn tin cho chính mình để trò chuyện với agent.	Thiết lập nhanh, một người dùng, thử nghiệm

Cách số bot riêng biệt sạch sẽ hơn — AI của bạn có danh tính riêng, và bạn không trộn lẫn tin nhắn cá nhân với hội thoại bot. Chế độ tự nhắn hoàn hảo cho một bài chạy thử nhanh.

Trước Khi Bắt Đầu

Bạn sẽ cần:

Node.js v18+ và npm — cầu nối WhatsApp chạy như một tiến trình Node.js
Một chiếc điện thoại có cài WhatsApp (để quét mã QR)

Tin tốt: không giống các cầu nối dựa trên trình duyệt cũ, bạn không cần cài Chromium hay Puppeteer. Quá trình thiết lập nhẹ nhàng hơn nhiều.

Bước 1: Chạy Trình Hướng Dẫn Thiết Lập

hermes whatsapp

Trình hướng dẫn sẽ:

Hỏi bạn muốn chế độ nào (bot hoặc tự nhắn)
Cài đặt các phụ thuộc của cầu nối nếu cần
Hiển thị mã QR trong terminal của bạn
Chờ bạn quét mã đó

Để quét mã QR:

Mở WhatsApp trên điện thoại của bạn
Vào Cài đặt → Thiết bị đã liên kết
Chạm vào Liên kết thiết bị
Hướng camera vào mã QR trên terminal

Sau khi ghép cặp, trình hướng dẫn xác nhận kết nối và thoát. Phiên của bạn được lưu tự động.

Mẹo: Nếu mã QR bị lỗi hiển thị, hãy đảm bảo terminal của bạn rộng ít nhất 60 cột và hỗ trợ Unicode. Bạn cũng có thể thử một trình giả lập terminal khác.

Bước 2: Lấy Số Điện Thoại Thứ Hai (Chế Độ Bot)

Đối với chế độ bot, bạn cần một số chưa được đăng ký với WhatsApp. Dưới đây là các lựa chọn của bạn:

Lựa chọn	Chi phí	Ghi chú
Google Voice	Miễn phí	Chỉ ở Mỹ. Lấy số tại voice.google.com. Xác minh WhatsApp qua SMS thông qua ứng dụng Google Voice.
SIM trả trước	5–15 đô la một lần	Bất kỳ nhà mạng nào. Kích hoạt, xác minh WhatsApp, sau đó SIM có thể nằm trong ngăn kéo. Số phải duy trì hoạt động (gọi một cuộc mỗi 90 ngày).
Dịch vụ VoIP	Miễn phí–5 đô la/tháng	TextNow, TextFree, hoặc tương tự. Một số số VoIP bị WhatsApp chặn — hãy thử vài cái nếu cái đầu tiên không hoạt động.

Sau khi có số:

Cài WhatsApp trên một chiếc điện thoại (hoặc dùng ứng dụng WhatsApp Business với SIM kép)
Đăng ký số mới với WhatsApp
Chạy hermes whatsapp và quét mã QR từ tài khoản WhatsApp đó

Bước 3: Cấu Hình Hermes

Thêm phần sau vào tệp ~/.hermes/.env của bạn:

# Bắt buộc
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" hoặc "self-chat"

# Kiểm soát truy cập — chọn MỘT trong các tùy chọn này:
WHATSAPP_ALLOWED_USERS=15551234567         # Danh sách số điện thoại phân tách bằng dấu phẩy (kèm mã quốc gia, không có dấu +)
# WHATSAPP_ALLOWED_USERS=*                 # HOẶC dùng * để cho phép tất cả
# WHATSAPP_ALLOW_ALL_USERS=true            # HOẶC đặt cờ này (hiệu quả tương tự như *)

Viết tắt cho phép tất cả: Đặt WHATSAPP_ALLOWED_USERS=* cho phép tất cả người gửi. Để dùng luồng ghép cặp thay vào đó, hãy xóa cả hai biến và dựa vào hệ thống ghép cặp DM.

Các cài đặt hành vi tùy chọn trong ~/.hermes/config.yaml:

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

unauthorized_dm_behavior: pair là mặc định toàn cục. Người gửi DM không xác định sẽ nhận được mã ghép cặp.
whatsapp.unauthorized_dm_behavior: ignore khiến WhatsApp giữ im lặng đối với các DM không được ủy quyền — thường là lựa chọn tốt hơn cho một số điện thoại riêng tư.

Sau đó khởi động gateway:

hermes gateway              # Chạy nền trước
hermes gateway install      # Cài đặt như một dịch vụ người dùng
sudo hermes gateway install --system   # Chỉ Linux: dịch vụ hệ thống khởi động cùng máy

Gateway tự động khởi động cầu nối WhatsApp bằng phiên đã lưu.

Lưu Trữ Phiên

Cầu nối Baileys lưu phiên của nó tại ~/.hermes/platforms/whatsapp/session. Điều này có nghĩa:

Phiên sống sót qua các lần khởi động lại — bạn không cần quét lại mã QR mỗi lần
Dữ liệu phiên bao gồm khóa mã hóa và thông tin xác thực thiết bị
Không chia sẻ hoặc commit thư mục phiên này — nó cấp toàn quyền truy cập vào tài khoản WhatsApp

Ghép Cặp Lại

Nếu phiên bị hỏng (đặt lại điện thoại, cập nhật WhatsApp, hủy liên kết thủ công), bạn sẽ thấy lỗi kết nối trong nhật ký gateway. Để khắc phục:

hermes whatsapp

Lệnh này tạo mã QR mới để ghép cặp lại.

Một Lời Cảnh Báo

WhatsApp không chính thức hỗ trợ bot bên thứ ba ngoài Business API. Sử dụng cầu nối bên thứ ba mang một rủi ro nhỏ về hạn chế tài khoản. Để giảm thiểu rủi ro:

Dùng số điện thoại riêng cho bot (không phải số cá nhân của bạn)
Không gửi tin nhắn hàng loạt/spam — giữ việc sử dụng ở mức trò chuyện
Không tự động hóa nhắn tin gửi đi cho những người chưa nhắn tin trước

Ngoài ra, WhatsApp định kỳ cập nhật giao thức Web của họ, có thể tạm thời phá vỡ khả năng tương thích với cầu nối bên thứ ba. Khi điều này xảy ra, Hermes sẽ cập nhật phụ thuộc cầu nối. Nếu bot ngừng hoạt động sau một bản cập nhật WhatsApp, hãy kéo phiên bản Hermes mới nhất và ghép cặp lại.

Muốn Thứ Gì Đó Chính Thống Hơn?

Nếu bạn đang vận hành một bot doanh nghiệp thực thụ và muốn sự ổn định, hãy xem hướng dẫn WhatsApp Business Cloud API. Đây là con đường chính thức được Meta hỗ trợ: không có rủi ro khóa tài khoản, nhưng yêu cầu tài khoản Meta Business và một URL webhook công khai. Hai bộ điều hợp cũng có thể chạy song song với các số điện thoại khác nhau nếu bạn có lý do.

Đối với hầu hết các dự án cá nhân và thử nghiệm, cầu nối Baileys là cách nhanh nhất để đưa AI vào WhatsApp của bạn. Quét, cấu hình, và bắt đầu trò chuyện.