# Nhật ký thay đổi

Theo dõi cập nhật tài liệu và các thay đổi API đã được xác nhận.

API 4.0 · 4.1

## Đọc phiên bản API

Mỗi trang endpoint hiển thị phiên bản route API, như **API 4.0** hoặc **API 4.1**, phía trên tiêu đề. Dùng đúng phương thức HTTP và URL ghi trên trang đó. Số phiên bản khác nhau không phải lý do để đổi phiên bản trong một URL đang dùng.

Các hướng dẫn dùng chung liệt kê những phiên bản chúng bao gồm. Trang nhận webhook và dữ liệu sự kiện mô tả việc gửi tới máy chủ của bạn, nên không gắn với phiên bản trong route API của Subiz.

## 17/11/2026 — Cập nhật tài liệu

**Chỉ thay đổi tài liệu · Không thông báo thay đổi hành vi API**

- Viết lại các trang endpoint tiếng Anh trong nhóm Hội thoại và tin nhắn: Gửi tin nhắn vào hội thoại, Gửi tin nhắn cho khách hàng, Lấy thông tin hội thoại, Đọc lịch sử tin nhắn, Mời agent tham gia và Giao agent phụ trách. Các trang nay có ví dụ phản hồi, giới hạn và bước tiếp theo.
- Viết lại các trang tiếng Anh trong nhóm Khách hàng: Tạo khách hàng, Lấy thông tin khách hàng, Cập nhật thông tin khách hàng và Tìm hoặc tạo theo định danh kênh. Các trang nay liệt kê thuộc tính khách hàng có sẵn và có ví dụ phản hồi.
- Thêm trang tiếng Anh Định dạng khách hàng và thuộc tính trong nhóm Khách hàng, mô tả đối tượng User và Attribute, kiểu giá trị, nhiều giá trị và thuộc tính có sẵn.
- Thêm các trang tiếng Anh về Đơn hàng: Định dạng đơn hàng, Tạo đơn hàng, Lấy danh sách đơn hàng, Lấy thông tin đơn hàng và Cập nhật đơn hàng. Các trang này thay cho phần khung điều hướng Đơn hàng.
- Thêm các trang tiếng Anh về Sản phẩm: Định dạng sản phẩm, Tạo sản phẩm, Lấy danh sách sản phẩm, Lấy thông tin sản phẩm và Cập nhật sản phẩm. Các trang này thay cho phần khung điều hướng Sản phẩm.
- Thêm các trang tiếng Anh về Agent: Định dạng agent, Lấy danh sách agent và Lấy thông tin agent.
- Gửi tin nhắn cho khách hàng nay mô tả cách xác định khách hàng theo định danh kênh bằng `channel`, `channel_source` và `profile_id` ở cấp ngoài cùng.
- Thêm bản tiếng Việt cho mọi trang, gồm tất cả các trang nêu trên. Dùng menu ngôn ngữ ở đầu trang để chuyển đổi.

## 14/11/2026 — Cập nhật tài liệu

**Chỉ thay đổi tài liệu · Không thông báo thay đổi hành vi API**

- Thêm nhãn phiên bản API cho từng trang.
- Thêm hướng dẫn tiếng Anh Giới hạn sử dụng và Xử lý lỗi, với giới hạn dữ liệu đã kiểm chứng, các trường của phản hồi lỗi và hướng dẫn thử lại.
- Cập nhật hướng dẫn giới hạn sử dụng cho hạn mức theo token, hạn mức chung của tài khoản và hạn mức tin nhắn theo agent, việc đặt lại hằng ngày theo UTC và phản hồi HTTP 429 kèm Retry-After.
- Thêm nhật ký thay đổi này cho các cập nhật tài liệu và thay đổi API đã xác nhận trong tương lai.
- Mở rộng hướng dẫn webhook tiếng Anh với xác minh chữ ký, xử lý lần gửi và dữ liệu sự kiện khách hàng. Bản dịch tiếng Việt cho phần webhook khi đó đang chờ cập nhật.
- Thêm Đơn hàng và Sản phẩm làm khung điều hướng chờ bài viết đã kiểm chứng.

Mục này không khẳng định có thao tác API nào được giới thiệu hay ngừng hỗ trợ vào ngày này. Chưa có thao tác API 4.2 nào được ghi tài liệu.

## Thông báo thay đổi API

Chưa có lịch sử phát hành API nào được xác nhận từ mã nguồn. Các mục sau này sẽ nêu phiên bản và thao tác API bị ảnh hưởng, ngày có hiệu lực, thay đổi có phá vỡ tương thích hay không và các bước chuyển đổi cần thiết.