# Subiz Developer Docs English and Vietnamese developer documentation. ## English ### Get Started - [Subiz API](/developers/index.md): Connect your systems to Subiz customers, conversations, messages, and webhooks. - [Authentication](/developers/get-started/authentication.md): Authorize API requests with a Bearer access token. - [Usage limits](/developers/get-started/usage-limits.md): Understand token and account request limits, payload sizes, and retry timing. - [Errors](/developers/get-started/errors.md): Read API error responses, fix requests, and decide when to retry. ### Messages - [Message formats](/developers/messages/formats.md): Write plain text and rich messages with blocks, links, and text formatting. - [Send to a conversation](/developers/api-reference/messages/send.md): Send a message into an existing conversation. - [Attachments](/developers/messages/attachments.md): Add images, video, audio, files, and interactive content to a message. - [Send to a customer](/developers/api-reference/messages/send-to-user.md): Send a message to a customer through a connected channel. ### Customers (Users) - [User and attribute format](/developers/users/format.md): Understand the customer object and how attribute values are stored. - [Create a customer](/developers/api-reference/users/create.md): Create a customer record with attributes and an optional channel identity. - [Get customer details](/developers/api-reference/users/retrieve.md): Read a customer's profile and attributes by Subiz user ID. - [Update customer details](/developers/api-reference/users/update.md): Change a customer's attributes, such as name, email, or phone. - [Find or create by channel identity](/developers/api-reference/users/identity.md): Get the Subiz customer for a Facebook, Zalo, or other channel profile. ### Conversations - [List conversations](/developers/api-reference/conversations/list.md): List conversations through the Subiz API. - [Get conversation details](/developers/api-reference/conversations/retrieve.md): Read a conversation's state, members, owner, and channel. - [Read message history](/developers/api-reference/conversations/history.md): List the messages and other events in a conversation. - [Invite an agent](/developers/api-reference/conversations/invite-agent.md): Add an existing agent to a conversation as a participant. - [Assign an agent](/developers/api-reference/conversations/assign-agent.md): Make a specific agent responsible for a conversation. ### Agents - [Agent format](/developers/agents/format.md): Understand the agent object: identity, contact details, role, and state. - [List agents](/developers/api-reference/agents/list.md): Get the agents in your account, for example to find an agent ID. - [Get agent details](/developers/api-reference/agents/retrieve.md): Get one agent in your account by agent ID. ### Orders - [Order format](/developers/orders/format.md): Understand the order object: items, customer, shipping, amounts, and statuses. - [Create an order](/developers/api-reference/orders/create.md): Create an order for an existing customer. - [List orders](/developers/api-reference/orders/list.md): Search orders by customer, status, date, and more. - [Get order details](/developers/api-reference/orders/retrieve.md): Read one order by its Subiz order ID. - [Update an order](/developers/api-reference/orders/update.md): Change selected fields of an order, such as its status or note. ### Products - [Product format](/developers/products/format.md): Understand the product object: price, stock, availability, variants, and images. - [Create a product](/developers/api-reference/products/create.md): Add a product to your catalog, or update it by your own product ID. - [List products](/developers/api-reference/products/list.md): Search your catalog by text, SKU, price, availability, and more. - [Get product details](/developers/api-reference/products/retrieve.md): Read one product by its Subiz product ID. - [Update a product](/developers/api-reference/products/update.md): Change a product's price, stock, availability, or other fields. ### Webhooks - [Receive webhook events](/developers/webhooks/receiving.md): Create a webhook in Subiz, verify deliveries, and process events safely. - [Event payload examples](/developers/webhooks/payloads.md): Read message, customer, and conversation events in a webhook delivery. ### Updates - [Changelog](/developers/changelog.md): Track documentation updates and confirmed API changes. ## Tiếng Việt ### Bắt đầu - [Subiz API](/developers/vi/index.md): Kết nối hệ thống của bạn với khách hàng, hội thoại, tin nhắn và webhook của Subiz. - [Xác thực](/developers/vi/get-started/authentication.md): Ủy quyền yêu cầu API bằng Bearer access token. - [Giới hạn sử dụng](/developers/vi/get-started/usage-limits.md): Hiểu giới hạn yêu cầu theo token và tài khoản, kích thước dữ liệu và thời điểm thử lại. - [Xử lý lỗi](/developers/vi/get-started/errors.md): Đọc phản hồi lỗi API, sửa yêu cầu và quyết định khi nào thử lại. ### Tin nhắn - [Định dạng tin nhắn](/developers/vi/messages/formats.md): Viết tin nhắn văn bản thuần và tin nhắn phong phú với block, liên kết và định dạng chữ. - [Gửi tin nhắn vào hội thoại](/developers/vi/api-reference/messages/send.md): Gửi tin nhắn vào một hội thoại có sẵn. - [Tệp đính kèm](/developers/vi/messages/attachments.md): Thêm ảnh, video, âm thanh, tệp và nội dung tương tác vào tin nhắn. - [Gửi tin nhắn cho khách hàng](/developers/vi/api-reference/messages/send-to-user.md): Gửi tin nhắn cho khách hàng qua một kênh đã kết nối. ### Khách hàng - [Định dạng khách hàng và thuộc tính](/developers/vi/users/format.md): Hiểu đối tượng khách hàng và cách lưu giá trị thuộc tính. - [Tạo khách hàng](/developers/vi/api-reference/users/create.md): Tạo hồ sơ khách hàng với thuộc tính và định danh kênh tùy chọn. - [Lấy thông tin khách hàng](/developers/vi/api-reference/users/retrieve.md): Đọc hồ sơ và thuộc tính của khách hàng theo ID user Subiz. - [Cập nhật thông tin khách hàng](/developers/vi/api-reference/users/update.md): Thay đổi thuộc tính của khách hàng, như tên, email hoặc số điện thoại. - [Tìm hoặc tạo theo định danh kênh](/developers/vi/api-reference/users/identity.md): Lấy khách hàng Subiz tương ứng với hồ sơ Facebook, Zalo hoặc kênh khác. ### Hội thoại - [Liệt kê hội thoại](/developers/vi/api-reference/conversations/list.md): Tìm các hội thoại của khách hàng. - [Lấy thông tin hội thoại](/developers/vi/api-reference/conversations/retrieve.md): Đọc trạng thái, thành viên, người phụ trách và kênh của hội thoại. - [Đọc lịch sử tin nhắn](/developers/vi/api-reference/conversations/history.md): Liệt kê tin nhắn và các sự kiện khác trong một hội thoại. - [Mời agent tham gia](/developers/vi/api-reference/conversations/invite-agent.md): Thêm một agent có sẵn vào hội thoại với vai trò người tham gia. - [Giao agent phụ trách](/developers/vi/api-reference/conversations/assign-agent.md): Giao cho một agent cụ thể phụ trách hội thoại. ### Agent - [Định dạng agent](/developers/vi/agents/format.md): Hiểu đối tượng agent: định danh, thông tin liên hệ, vai trò và trạng thái. - [Lấy danh sách agent](/developers/vi/api-reference/agents/list.md): Lấy các agent trong tài khoản, ví dụ để tìm ID agent. - [Lấy thông tin agent](/developers/vi/api-reference/agents/retrieve.md): Lấy một agent trong tài khoản theo ID agent. ### Đơn hàng - [Định dạng đơn hàng](/developers/vi/orders/format.md): Hiểu đối tượng đơn hàng: mặt hàng, khách hàng, giao hàng, số tiền và trạng thái. - [Tạo đơn hàng](/developers/vi/api-reference/orders/create.md): Tạo đơn hàng cho một khách hàng đã có. - [Lấy danh sách đơn hàng](/developers/vi/api-reference/orders/list.md): Tìm đơn hàng theo khách hàng, trạng thái, ngày và nhiều tiêu chí khác. - [Lấy thông tin đơn hàng](/developers/vi/api-reference/orders/retrieve.md): Đọc một đơn hàng theo ID đơn hàng Subiz. - [Cập nhật đơn hàng](/developers/vi/api-reference/orders/update.md): Thay đổi một số trường của đơn hàng, như trạng thái hoặc ghi chú. ### Sản phẩm - [Định dạng sản phẩm](/developers/vi/products/format.md): Hiểu đối tượng sản phẩm: giá, tồn kho, tình trạng hàng, biến thể và hình ảnh. - [Tạo sản phẩm](/developers/vi/api-reference/products/create.md): Thêm sản phẩm vào danh mục, hoặc cập nhật theo ID sản phẩm của bạn. - [Lấy danh sách sản phẩm](/developers/vi/api-reference/products/list.md): Tìm trong danh mục theo từ khóa, SKU, giá, tồn kho và nhiều tiêu chí khác. - [Lấy thông tin sản phẩm](/developers/vi/api-reference/products/retrieve.md): Đọc một sản phẩm theo ID sản phẩm Subiz. - [Cập nhật sản phẩm](/developers/vi/api-reference/products/update.md): Thay đổi giá, tồn kho, tình trạng hàng hoặc các trường khác của sản phẩm. ### Webhook - [Nhận sự kiện webhook](/developers/vi/webhooks/receiving.md): Tạo webhook trong Subiz, xác minh các lần gửi và xử lý sự kiện an toàn. - [Ví dụ dữ liệu sự kiện](/developers/vi/webhooks/payloads.md): Đọc sự kiện tin nhắn, khách hàng và hội thoại trong một lần gửi webhook. ### Cập nhật - [Nhật ký thay đổi](/developers/vi/changelog.md): Theo dõi cập nhật tài liệu và các thay đổi API đã được xác nhận.