Thiết lập WhatsApp
Hướng dẫn từng bước kết nối Claw Buff agent với WhatsApp
Tích hợp WhatsApp đang ở giai đoạn Beta. Tính năng này sử dụng giao thức WhatsApp Web (Baileys) — không phải API chính thức. Xem Lưu ý quan trọng bên dưới.
Kết nối AI Agent Claw Buff với WhatsApp để người dùng có thể trò chuyện như với một liên hệ thông thường. Quá trình thiết lập mất khoảng 5 phút.
Yêu cầu trước khi bắt đầu
- Tài khoản WhatsApp (khuyến nghị sử dụng số điện thoại riêng)
- Điện thoại thông minh để quét mã QR
- Agent Claw Buff đã được triển khai (Bắt đầu sử dụng)
Bước 1: Kết nối với Claw Buff
- Mở Bảng điều khiển Claw Buff → trang Kênh liên lạc
- Tìm thẻ WhatsApp và nhấn Connect
- Nhấn Generate QR Code
Mã QR sẽ hiển thị trên màn hình.
Bước 2: Quét mã QR
Mở WhatsApp trên điện thoại
Mở menu ⋮ (góc trên bên phải) hoặc Cài đặt, sau đó chọn Linked Devices → Link a Device. Trên một số phiên bản, hãy nhấn biểu tượng QR bên cạnh tên hồ sơ.
Quét mã QR
Hướng camera điện thoại vào mã QR hiển thị trên Bảng điều khiển. Kết nối sẽ được thiết lập tự động.
Xác nhận kết nối
Bảng điều khiển sẽ hiển thị trạng thái Connected. Bạn sẽ thấy số điện thoại đã liên kết.
Bước 3: Bắt đầu trò chuyện
Gửi tin nhắn đến số WhatsApp đã liên kết từ bất kỳ tài khoản WhatsApp nào. AI Agent sẽ phản hồi ngay!
Chúng tôi khuyến nghị sử dụng số điện thoại riêng cho bot WhatsApp. Điều này giúp tách biệt WhatsApp cá nhân và tránh rủi ro cho tài khoản cá nhân của bạn.
Tính năng
| Tính năng | Hỗ trợ |
|---|---|
| Tin nhắn trực tiếp | Có |
| Nhóm chat | Có |
| Định dạng phong phú | Có |
| Tệp đính kèm | Có |
| Tin nhắn thoại | Đang phát triển |
Lưu ý quan trọng
Trạng thái Beta
Tích hợp WhatsApp sử dụng thư viện Baileys (giao thức WhatsApp Web). Đây không phải API chính thức của WhatsApp, điều này có nghĩa:
- Rủi ro tài khoản — WhatsApp có thể hạn chế các tài khoản sử dụng API không chính thức. Hãy dùng số điện thoại riêng, không dùng số cá nhân
- Phiên hết hạn — Phiên liên kết hết hạn sau khoảng 30 ngày không hoạt động. Bạn sẽ cần quét lại mã QR
- Không có SLA — Thay đổi giao thức từ WhatsApp có thể tạm thời làm gián đoạn kết nối
Khuyến nghị dùng số riêng
Chúng tôi đặc biệt khuyến nghị sử dụng số điện thoại riêng cho bot WhatsApp. Các lựa chọn:
- SIM trả trước
- Số Google Voice
- Số VoIP có khả năng nhận SMS để xác minh
Phương án thay thế: Cloud API
Cho các trường hợp sử dụng trong môi trường sản phẩm cần API chính thức, hỗ trợ WhatsApp Cloud API đang được lên kế hoạch cho phiên bản tương lai. Phương án này sẽ sử dụng Business API chính thức của Meta với SLA đầy đủ và không có rủi ro tài khoản.
Câu hỏi thường gặp
1. Mã QR hết hạn?
Mã QR hết hạn sau khoảng 60 giây. Nhấn Generate QR Code lần nữa trong Bảng điều khiển để nhận mã mới.
2. Kết nối thường xuyên bị ngắt?
- Đảm bảo điện thoại luôn được kết nối internet
- Kiểm tra WhatsApp đã được cập nhật lên phiên bản mới nhất
- Phiên có thể cần được liên kết lại nếu điện thoại bị mất kết nối quá lâu
3. Tin nhắn không được gửi đi?
- Kiểm tra số điện thoại người nhận đúng định dạng E.164 (ví dụ: +15551234567)
- Tin nhắn nhóm yêu cầu số bot phải là thành viên của nhóm
- Kiểm tra trang Kênh liên lạc trong Bảng điều khiển để xem chi tiết lỗi