> ## 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.

# Zalo cá nhân

> Khả năng, giới hạn và hành vi phiên của kênh Zalo cá nhân.

> [!WARNING]
>
> Kênh này dùng giao thức **không chính thức** của Zalo. Xem [Điều khoản và rủi ro](https://agentme-docs.vipcrm.net/terms-and-risks.md).

## Khả năng

Có: gửi text, ảnh, file, sticker; reaction; thu hồi tin; trạng thái đang gõ; nhóm; tìm theo số điện thoại hoặc username; nhắn người lạ; kết bạn; đồng bộ danh bạ; nhận tin theo thời gian thực (mode `full`).

**Không có** (khai báo trung thực, gọi sẽ trả `CAPABILITY_NOT_SUPPORTED`): gửi voice, gửi video, sửa tin, xác nhận đã đọc tới đối phương (`/read` chỉ reset bộ đếm chưa đọc phía Agentme), kéo lịch sử cũ.

## Lịch sử

Agentme chỉ có tin **từ lúc nick kết nối** (nhận qua listener) và tin gửi qua API. Không kéo được tin cũ trước đó từ Zalo. Nick ở `send_only` không nhận tin đến.

## Một phiên web mỗi nick

Zalo chỉ cho một phiên web hoạt động mỗi nick:

* Đăng nhập QR ở trình duyệt khác sẽ **huỷ phiên của Agentme**. Cookie đã lưu bị từ chối và nick chuyển `expired`, cần đăng nhập lại.
* Khi bạn dùng Zalo web song song, Agentme có thể bị đá và chuyển `yielded`, sau đó thử kết nối lại. Hành vi khi mở cùng lúc nhiều nơi (kể cả Zalo PC) **chưa được kiểm chứng đầy đủ**.
* Muốn giữ phiên web đang dùng: kết nối bằng [tiện ích trình duyệt](https://agentme-docs.vipcrm.net/guides/chrome-extension.md) (dùng chung phiên, không quét QR). Sau đó đóng tab Zalo Web và đừng bấm "Đăng xuất".
* Cách ổn định nhất: dùng nick phụ chỉ cho Agentme.

## Gửi file và mode

Gửi file cần listener đang chạy (mode `full`). Ở `send_only`, file và video bị từ chối thay vì treo.

## Proxy

Bắt buộc cho mọi nick, kể cả lúc đăng nhập. Không có proxy thì không kết nối, không bao giờ fallback sang IP máy chủ. Mỗi nick giữ cố định một IP đi ra, nên đừng đổi proxy tuỳ tiện. Proxy hỏng thì nick bị `paused` thay vì đi đường khác.

## Cookie, fingerprint

`imei` và `userAgent` được cố định từ lúc đăng nhập. Nếu nhập bằng cookie, phải dùng imei và UA của chính trình duyệt đã lấy cookie.

## Media nhận về

Ảnh/file nhận được được tải về lưu 30 ngày. Ngay sau khi người gửi upload, CDN của Zalo đôi khi trả lỗi tạm trong vài giây, nên attachment có thể `pending` rồi mới `stored`. Sticker nhận được hiện không tải về được (`failed`).

## Giới hạn mặc định

Gửi tin 20/phút, nhắn người lạ 2/phút và 30/ngày, kết bạn 1/phút và 20/ngày; nick mới được làm nóng dần. Chi tiết và cách tự chỉnh: [Rate limit và anti-ban](https://agentme-docs.vipcrm.net/rate-limits-and-anti-ban.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.