Skip to main content
Tích hợp KiotViet cho phép AI agent truy cập trực tiếp vào hệ thống quản lý bán hàng KiotViet của doanh nghiệp. Sau khi kết nối, agent có thể trả lời chính xác về sản phẩm, giá cả, tồn kho, và trạng thái đơn hàng — tất cả từ dữ liệu thực, không phải thông tin cũ.
Trang tích hợp KiotViet

​
Yêu cầu

  • Gói Pro trở lên trên AgentBase.
  • Tài khoản KiotViet có quyền truy cập Public API (Client ID và Client Secret).
Nếu bạn chưa có thông tin API, đăng nhập KiotViet → Thiết lập → Kết nối API để tạo ứng dụng và lấy Client ID / Client Secret. Xem hướng dẫn API của KiotViet để biết thêm chi tiết.

​
Kết nối KiotViet

1

Mở trang Tích hợp

Trên sidebar, chọn Tích hợp → nhấn vào card KiotViet.
Card KiotViet trên trang Tích hợp
2

Nhấn Kết nối

Nhấn nút “Kết nối” để mở dialog nhập thông tin.
Dialog kết nối KiotViet
3

Nhập thông tin API

Điền 3 trường bắt buộc:
Tên cửa hàng là tên đăng nhập KiotViet (ví dụ: cuahangtoi), không phải tên hiển thị của cửa hàng. Bạn có thể tìm tên này ở URL khi đăng nhập KiotViet: https://cuahangtoi.kiotviet.vn.
4

Kiểm tra kết nối

AgentBase sẽ tự động kiểm tra kết nối bằng cách xác thực với API KiotViet. Nếu thành công, trạng thái chuyển sang “Đã kết nối” (chấm xanh).
Trạng thái đã kết nối

​
Đồng bộ sản phẩm

Sau khi kết nối, bước tiếp theo là đồng bộ danh mục sản phẩm từ KiotViet vào kiến thức của agent.
Dialog quản lý KiotViet
1

Mở dialog quản lý

Nhấn “Quản lý” trên card KiotViet đã kết nối.
2

Nhấn Đồng bộ sản phẩm

Nhấn nút “Đồng bộ ngay” để bắt đầu kéo danh mục sản phẩm từ KiotViet.
3

Chờ đồng bộ hoàn tất

Quá trình đồng bộ thường mất 10–30 giây tùy thuộc vào số lượng sản phẩm. Trạng thái hiển thị trực tiếp trong dialog.
4

Huấn luyện lại agent

Sau khi đồng bộ xong, nhấn “Huấn luyện lại agent” để agent học kiến thức mới từ danh mục sản phẩm.
Nếu bạn không huấn luyện lại, agent sẽ không biết về sản phẩm mới được đồng bộ.

​
Dữ liệu được đồng bộ

Mỗi sản phẩm từ KiotViet được đưa vào kiến thức của agent bao gồm:
Tồn kho không được đồng bộ vào kiến thức tĩnh. Số lượng tồn kho thay đổi liên tục, nên agent sử dụng tính năng kiểm tra tồn kho thời gian thực thay vì dữ liệu cũ từ lần đồng bộ.

​
Đồng bộ lại

Khi bạn thêm sản phẩm mới, thay đổi giá, hoặc cập nhật mô tả trên KiotViet, hãy:
  1. Nhấn “Đồng bộ ngay” để kéo dữ liệu mới.
  2. Nhấn “Huấn luyện lại agent” để áp dụng thay đổi.
Gói Pro bao gồm tính năng Tự động đồng bộ hàng tuần — agent tự động cập nhật danh mục sản phẩm mà không cần thao tác thủ công.

​
Tính năng sau khi kết nối

Sau khi kết nối và đồng bộ, agent tự động có các khả năng sau:

Trả lời về sản phẩm

Agent trả lời câu hỏi về tên, giá, mô tả sản phẩm dựa trên danh mục đã đồng bộ từ KiotViet.

Kiểm tra tồn kho

Khi khách hỏi “Còn hàng không?”, agent gọi API KiotViet để trả lời với số lượng tồn kho chính xác tại thời điểm hỏi.

Hiển thị hình ảnh sản phẩm

Khi kiểm tra tồn kho, agent hiển thị hình ảnh sản phẩm từ KiotViet ngay trong cửa sổ chat — giúp khách hàng nhận diện đúng sản phẩm.

Tra cứu đơn hàng

Khách hàng có thể hỏi trạng thái đơn hàng bằng mã đơn hàng, mã hóa đơn, hoặc số điện thoại. Agent trả lời ngay với thông tin từ KiotViet.
Xem chi tiết về cách các tính năng này hoạt động trong cuộc trò chuyện tại trang Hành động KiotViet.

​
Nâng cấp gói KiotViet

Tích hợp KiotViet có 2 cấp độ:
Dialog nâng cấp KiotViet

​
Ngắt kết nối

1

Mở quản lý

Nhấn “Quản lý” trên card KiotViet.
2

Nhấn Ngắt kết nối

Cuộn xuống cuối dialog và nhấn “Ngắt kết nối”.
3

Xác nhận

Xác nhận ngắt kết nối. Dữ liệu sản phẩm đã đồng bộ sẽ bị xóa khỏi nguồn dữ liệu.
Sau khi ngắt kết nối, agent sẽ không còn khả năng kiểm tra tồn kho hoặc tra cứu đơn hàng. Bạn cần huấn luyện lại agent để xóa kiến thức sản phẩm cũ.

​
Xử lý sự cố

Nếu gặp lỗi liên tục, thử ngắt kết nối và kết nối lại. Điều này sẽ tạo lại token xác thực từ đầu.