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

# Changelog

> Thay đổi của API, webhook và MCP.

## 2026-11-14

* REST `/api/v1`: channels, accounts, conversations, messages (gửi, reaction, thu hồi), media, contacts, tìm người, kết bạn. Lỗi thống nhất, phân trang cursor, `Idempotency-Key`.
* Webhook `schema_version` `2026-11-01`: ký HMAC-SHA256, hỗ trợ hai `v1=` khi xoay secret, retry 7 lần.
* MCP server (Streamable HTTP, không session) với 10 công cụ lọc theo scope và capability.
* Kênh Zalo cá nhân.
* Gửi tin: hàng `pending` được tạo trước khi xếp lệnh (id trong `202` luôn có hàng thật); gửi lại tin `pending` không gửi trùng; `202` không lưu theo `Idempotency-Key`; `Idempotency-Key` gắn với đường dẫn thật.
* `direction=after` luôn trả `next_cursor`; giới hạn tin đến muộn được ghi trong [Khái niệm](https://agentme-docs.vipcrm.net/concepts.md).
* Upload media lưu vào DB (`media_uploads`), stream thẳng lên R2, hết hạn sau 30 ngày kể từ lúc tạo object (`410`).
* Webhook: id có tiền tố (`msg_`, `med_`, `cnv_`, `acc_`); đổi shape trước khi khoá API v1 nên `schema_version` giữ `2026-11-01`.
* `502 UPSTREAM_ERROR` có thể kèm `details.upstream_code`.

Chính sách phiên bản: thêm field là tương thích ngược. Thay đổi phá vỡ sẽ ra `/v2` và `schema_version` webhook mới, có thông báo trước.


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