> ## Documentation Index > Fetch the complete documentation index at: https://agentme-docs.vipcrm.net/llms.txt > Use this file to discover all available pages before exploring further. # Rate limit và anti-ban > Hai lớp giới hạn, số liệu mặc định và những điều không thể bảo đảm. > [!WARNING] > > Không có cấu hình nào bảo đảm nick không bị khoá. Giới hạn dưới đây chỉ **giảm** rủi ro bằng cách giữ nhịp độ giống người dùng thường. Zalo không công bố ngưỡng của họ, và các con số dưới đây là **mặc định của Agentme, chưa phải ngưỡng đã được Zalo xác nhận**. ## Hai lớp tách biệt | Lớp | Phạm vi | Mục đích | Khi vượt | | - | - | - | - | | API | 600 request/phút/key | Bảo vệ hệ thống | `429`, `details.limit_type = "api"` | | Kênh | Mỗi nick, mỗi loại hành động | Bảo vệ nick khỏi bị khoá | `429`, `details.limit_type = "channel"` | Giới hạn kênh áp ở worker nên **không thể vượt bằng cách đi đường REST hay MCP**. Vượt là từ chối ngay kèm `Retry-After`, không xếp hàng gửi trễ. ## Mặc định cho Zalo cá nhân | Hành động | Mỗi phút | Mỗi giờ | Mỗi ngày | | - | - | - | - | | Gửi text, ảnh, file, sticker | 20 | 300 | 1500 | | Nhắn **người lạ** (không phải bạn, chưa từng nhắn tới bạn). Tính thêm vào giới hạn gửi | 2 | 10 | 30 | | Reaction | 30 | 600 | 3000 | | Tìm theo số điện thoại / username | 2 | 10 | 30 | | Gửi lời mời kết bạn | 1 | 5 | 20 | Đây là điểm khởi đầu bảo thủ, sẽ được hiệu chỉnh khi có thêm dữ liệu thực tế. ## Làm nóng nick mới Nick mới trong Agentme bị giảm giới hạn cho các hành động rủi ro nhất (nhắn người lạ, kết bạn, tìm người), rồi tăng dần: | Tuổi nick trong Agentme | Hệ số | | - | - | | Ngày 0-3 | ×0,3 | | Ngày 4-7 | ×0,5 | | Ngày 8-14 | ×0,8 | | Từ ngày 15 | ×1 | Ví dụ: nick ngày đầu nhắn được tối đa 9 người lạ mỗi ngày (30 × 0,3). Nhắn người quen không bị làm nóng. ## Tự chỉnh giới hạn cho từng nick Trong trang chi tiết nick, mục **Giới hạn tốc độ**: * Giảm giới hạn: tự do. * Tăng trên mặc định: tối đa 2× mặc định (quản trị viên có thể đổi trần), phải xác nhận cảnh báo rủi ro, và thay đổi được ghi vào nhật ký hoạt động (mục cuối trang này). * Giới hạn tự chỉnh thay thế mức mặc định (kể cả làm nóng) cho hành động đó. ## Các lớp bảo vệ khác * **Nhịp gửi giống người:** giữa hai tin của cùng một nick có khoảng nghỉ ngẫu nhiên 0,8-2,5 giây (5-15 giây với người lạ). Tin gửi liên tiếp có thể chậm hơn vài giây. * **Chặn nội dung hàng loạt:** cùng một nội dung gửi tới từ 10 người nhận khác nhau trong 1 giờ (người lạ: từ 3 người) bị từ chối với `422 BULK_CONTENT_BLOCKED`. Quản trị viên có thể tắt kiểm tra này cho một nick cụ thể. * **Tạm khoá khi Zalo giới hạn:** nếu Zalo báo bạn gửi quá nhanh, hoặc 5 lần gửi liên tiếp lỗi, hành động đó bị khoá 15 phút (tăng gấp đôi nếu lặp lại, tối đa 6 giờ) và trả `429` kèm `Retry-After`. * **Proxy:** hệ thống kiểm tra proxy mỗi 5 phút. Proxy hỏng 3 lần liên tiếp thì nick tạm dừng, tự nối lại khi proxy ổn. * **Công tắc khẩn cấp:** khi Zalo đổi giao thức, quản trị viên có thể tắt cả kênh. Lúc đó API trả `409 ACCOUNT_NOT_READY` với `details.status = "channel_disabled"`. ## Nhật ký hoạt động Mục **Nhật ký** trong ứng dụng liệt kê ai đã làm gì: đăng nhập, thêm/xoá nick, đổi proxy, tạo/thu hồi API key, webhook, mọi lệnh gửi tin (chỉ ghi id tin, không ghi nội dung), kết bạn, tìm số điện thoại (số bị che dạng `09xx…123`), đổi giới hạn. Lọc theo nick, người thực hiện, loại hành động, ngày; xuất CSV. Lưu 365 ngày. ## Thực hành an toàn hơn * Dùng **nick phụ** cho tự động hoá, không dùng nick chính hay nick có giá trị. * Làm nóng nick mới từ từ. Đừng nhắn hàng loạt ngay ngày đầu. * Không nhắn người lạ hàng loạt, không gửi nội dung trùng lặp cho nhiều người, không spam kết bạn. * Mỗi nick một proxy riêng ổn định, IP cùng khu vực với người dùng thật. * Agent nên xử lý `429` bằng cách chờ `Retry-After`, không retry vòng lặp. Dùng `client_msg_id` khi retry để không gửi trùng. * Theo dõi `status` của nick (`expired`, `backoff`, `paused`) và dừng agent khi nick không `live`. ## Tìm người và kết bạn Hai hành động này bị giới hạn chặt nhất vì thường là tín hiệu spam. Đừng dùng để quét danh sách số điện thoại. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.