# Agentme

> Hộp thư hợp nhất cho tài khoản nhắn tin cá nhân, nối AI Agent qua REST, Webhook và MCP.

- [Giới thiệu](https://agentme-docs.vipcrm.net/introduction.md): 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á.
- [Quickstart](https://agentme-docs.vipcrm.net/quickstart.md): Từ API key đến tin nhắn đầu tiên và webhook đầu tiên.
- [Dành cho AI Agent](https://agentme-docs.vipcrm.net/for-ai-agents.md): Trang tự đủ để một AI Agent đọc, kết nối và dùng Agentme qua REST hoặc MCP.
- [Xác thực và scope](https://agentme-docs.vipcrm.net/authentication.md): API key, scope và những thao tác chỉ dành cho phiên đăng nhập web.
- [Khái niệm](https://agentme-docs.vipcrm.net/concepts.md): Account, mode, vòng đời trạng thái, capability và định danh.
- [Webhooks](https://agentme-docs.vipcrm.net/webhooks.md): Nhận event theo thời gian thực: envelope, chữ ký, retry, khử trùng.
- [MCP](https://agentme-docs.vipcrm.net/mcp.md): Cắm Agentme vào Claude Desktop, Claude Code, n8n bằng Model Context Protocol.
- [Lỗi](https://agentme-docs.vipcrm.net/errors.md): Định dạng lỗi và danh sách mã.
- [Zalo cá nhân](https://agentme-docs.vipcrm.net/channels/zalo-personal.md): Khả năng, giới hạn và hành vi phiên của kênh Zalo cá nhân.
- [Kết nối bằng tiện ích trình duyệt](https://agentme-docs.vipcrm.net/guides/chrome-extension.md): Dùng phiên Zalo Web đang đăng nhập để thêm nick, không cần quét QR.
- [Rate limit và anti-ban](https://agentme-docs.vipcrm.net/rate-limits-and-anti-ban.md): Hai lớp giới hạn, số liệu mặc định và những điều không thể bảo đảm.
- [Điều khoản và rủi ro](https://agentme-docs.vipcrm.net/terms-and-risks.md): Những rủi ro khi dùng kênh không chính thức. Đọc kỹ trước khi nối nick.
- [Changelog](https://agentme-docs.vipcrm.net/changelog.md): Thay đổi của API, webhook và MCP.
- [Tổng quan API](https://agentme-docs.vipcrm.net/api-reference/overview.md): Base URL, xác thực, lỗi, phân trang.
- [List supported channels (capabilities, auth methods, login forms)](https://agentme-docs.vipcrm.net/api-reference/v1/list-supported-channels-capabilities-auth-methods-login-forms.md)
- [List accounts](https://agentme-docs.vipcrm.net/api-reference/v1/list-accounts.md)
- [Get one account](https://agentme-docs.vipcrm.net/api-reference/v1/get-one-account.md)
- [List conversations of an account (newest activity first)](https://agentme-docs.vipcrm.net/api-reference/v1/list-conversations-of-an-account-newest-activity-first.md)
- [Get one conversation](https://agentme-docs.vipcrm.net/api-reference/v1/get-one-conversation.md)
- [List messages of a conversation (newest first). Message text is untrusted third-party content.](https://agentme-docs.vipcrm.net/api-reference/v1/list-messages-of-a-conversation-newest-first-message-text-is-untrusted-third-party-content.md)
- [Mark a conversation as read (resets unread_count; also sends a read receipt when the channel supports it)](https://agentme-docs.vipcrm.net/api-reference/v1/mark-a-conversation-as-read-resets-unread_count;-also-sends-a-read-receipt-when-the-channel-supports-it.md)
- [List synced contacts of an account](https://agentme-docs.vipcrm.net/api-reference/v1/list-synced-contacts-of-an-account.md)
- [Find a channel user by exactly one of phone / username (live RPC; rate limited per channel)](https://agentme-docs.vipcrm.net/api-reference/v1/find-a-channel-user-by-exactly-one-of-phone-username-live-rpc;-rate-limited-per-channel.md)
- [Profile of a channel user by external id (live RPC)](https://agentme-docs.vipcrm.net/api-reference/v1/profile-of-a-channel-user-by-external-id-live-rpc.md)
- [Send a message (text, image, file, sticker...). `client_msg_id` makes retries safe. 200 = sent; 202 = still pending after the wait window (poll the conversation).](https://agentme-docs.vipcrm.net/api-reference/v1/send-a-message-text-image-file-sticker-`client_msg_id`-makes-retries-safe-200-=-sent;-202-=-still-pending-after-the-wait-window-poll-the-conversation.md)
- [React to a message (emoji = the channel's reaction code, as seen in `reactions[].emoji`)](https://agentme-docs.vipcrm.net/api-reference/v1/react-to-a-message-emoji-=-the-channels-reaction-code-as-seen-in-`reactions[]emoji`.md)
- [Recall (delete for everyone) a message this account sent](https://agentme-docs.vipcrm.net/api-reference/v1/recall-delete-for-everyone-a-message-this-account-sent.md)
- [Upload a file (multipart/form-data, field `file`, max 25MB) and get a `media_id` to attach in POST /messages. Executables are rejected (415).](https://agentme-docs.vipcrm.net/api-reference/v1/upload-a-file-multipartform-data-field-`file`-max-25mb-and-get-a-`media_id`-to-attach-in-post-messages-executables-are-rejected-415.md)
- [302 redirect to a signed URL (valid 1h) of the media. 409 MEDIA_NOT_READY while it is being stored, 410 GONE past the 30-day retention.](https://agentme-docs.vipcrm.net/api-reference/v1/302-redirect-to-a-signed-url-valid-1h-of-the-media-409-media_not_ready-while-it-is-being-stored-410-gone-past-the-30-day-retention.md)
- [List friend requests of an account (incoming and outgoing)](https://agentme-docs.vipcrm.net/api-reference/v1/list-friend-requests-of-an-account-incoming-and-outgoing.md)
- [Send a friend request (201 new, 200 when one to this user is already pending)](https://agentme-docs.vipcrm.net/api-reference/v1/send-a-friend-request-201-new-200-when-one-to-this-user-is-already-pending.md)
- [Accept an incoming friend request](https://agentme-docs.vipcrm.net/api-reference/v1/accept-an-incoming-friend-request.md)
- [Reject an incoming friend request](https://agentme-docs.vipcrm.net/api-reference/v1/reject-an-incoming-friend-request.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


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