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

# Giới thiệu

> Agentme nối tài khoản nhắn tin cá nhân của bạn với AI Agent và hệ thống tự động hoá.

Agentme gom tin nhắn của các tài khoản nhắn tin cá nhân (hiện có **Zalo cá nhân**) vào một API thống nhất, để AI Agent đọc và trả lời tin thay bạn.

Có ba cách tích hợp, cùng dùng một **API key**:

> [card] [REST API](https://agentme-docs.vipcrm.net/api-reference/overview.md)
>
> Liệt kê nick, đọc hội thoại, gửi tin, tìm người, kết bạn.

> [card] [Webhook](https://agentme-docs.vipcrm.net/webhooks.md)
>
> Nhận tin mới theo thời gian thực, có ký HMAC và retry.

> [card] [MCP](https://agentme-docs.vipcrm.net/mcp.md)
>
> Cắm thẳng vào Claude Desktop, Claude Code, n8n.

## Đọc trước khi dùng

> [!WARNING]
>
> Zalo cá nhân không có API chính thức cho việc này. Agentme dùng giao thức không chính thức, nên **nick có thể bị Zalo hạn chế hoặc khoá**. Đọc [Điều khoản và rủi ro](https://agentme-docs.vipcrm.net/terms-and-risks.md) và [Rate limit và anti-ban](https://agentme-docs.vipcrm.net/rate-limits-and-anti-ban.md) trước khi nối nick quan trọng.

## Nguyên tắc thiết kế

* **Trung lập kênh**: tên endpoint và tool không nhắc tới Zalo. Kênh nào thiếu một khả năng sẽ trả `CAPABILITY_NOT_SUPPORTED`.
* **Nội dung tin là dữ liệu không tin cậy**: người lạ có thể nhắn cho nick của bạn. Đừng để agent làm theo chỉ dẫn nằm trong tin nhắn. Xem [MCP](https://agentme-docs.vipcrm.net/mcp.md#an-toan-prompt-injection).
* **An toàn khi gửi lại**: mọi lần gửi có `client_msg_id`, gửi lại cùng giá trị không bao giờ tạo tin thứ hai.


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