Tích hợp KiotViet

Kết nối KiotViet với AI Agent: trả lời khách bằng dữ liệu bán hàng thật

Giữ nguyên KiotViet bạn đang dùng. Aura thêm một lớp AI Agent đọc tồn kho, giá, đơn hàng và lịch sử mua của khách qua MCP server có sẵn, rồi trả lời trên Zalo OA, Facebook và website trong vài giây.

Hôm nay

Nhân viên mở KiotViet để tra từng câu hỏi

Khách hỏi còn size không, đơn giao chưa. Nhân viên chuyển qua lại giữa điện thoại và máy POS, khách nhắn tối thì sáng hôm sau mới có người trả lời.

Với Aura

AI Agent tra KiotViet và trả lời ngay

Tồn kho theo chi nhánh, giá theo bảng giá, trạng thái đơn được trả lời trong vài giây. Đơn mới được tạo nháp để nhân viên xác nhận.

Đặt lịch demo với dữ liệu KiotViet Xem danh sách công cụ

Kết nối KiotViet với AI Agent để làm gì?

KiotViet cung cấp API cho phép phần mềm khác đọc và ghi dữ liệu cửa hàng: hàng hóa, tồn kho, khách hàng, đơn đặt hàng, hóa đơn và chi nhánh. Aura đóng gói toàn bộ API đó thành một MCP server, để AI Agent tự tra cứu và thao tác trên KiotViet khi trả lời khách, thay vì nhân viên phải mở phần mềm tra tay.

KiotViet giỏi việc quản lý bán hàng tại quầy và kho. Nhưng phần lớn câu hỏi của khách bây giờ đến qua Zalo và Facebook, ngoài giờ cửa hàng mở. Dữ liệu để trả lời nằm sẵn trong KiotViet; cái thiếu là người trả lời đủ nhanh. Aura không thay KiotViet. Aura là lớp AI Agent nằm giữa kênh chat và KiotViet, xem thêm cách lớp này hoạt động trong bài AI Agent ngành bán lẻ.

Cách Aura kết nối KiotViet với AI Agent

Một tin nhắn của khách đi qua năm bước. AI Agent không bao giờ nhìn thấy mật khẩu hay API key của KiotViet; nó chỉ gọi công cụ đã được cấp quyền.

Khách nhắn tin

Trên Zalo OA, Facebook hoặc website: "Giày X size 39 chi nhánh Q7 còn không?"

Orchestration Brain

Hiểu ý định, chia việc, chọn Agent và công cụ cần gọi.

MCP server KiotViet

Kiểm tra quyền, áp chính sách duyệt, ghi nhật ký từng lần gọi.

KiotViet API

Tra sản phẩm, tồn kho chi nhánh, bảng giá, khách hàng, đơn hàng.

Trả lời & hành động

Trả lời còn hàng và giá, đề nghị giữ hàng, tạo đơn nháp chờ xác nhận.

MCP (Model Context Protocol) là chuẩn mở để AI Agent gọi công cụ và đọc dữ liệu từ phần mềm khác một cách có kiểm soát. Aura đóng gói toàn bộ API của KiotViet thành một MCP server có sẵn: mỗi API là một công cụ có tên, mô tả và tham số rõ ràng. Đội Aura cấu hình kết nối cho bạn; bạn không cần viết code. Đọc thêm: MCP là gì.

Sơ đồ tuần tự kỹ thuật: tin nhắn khách đi qua Aura Channel Gateway, Orchestration Brain, Aura MCP Gateway, Policy & Approval với n8n, MCP server KiotViet và KiotViet API — Một lượt xử lý đầy đủ: Agent gọi `tools/list` rồi `tools/call` qua MCP Gateway; công cụ đọc chạy ngay, công cụ ghi đi qua Policy & Approval (n8n gửi yêu cầu duyệt, callback ký HMAC) trước khi MCP server gọi KiotViet API. Credential KiotViet chỉ được giải mã trong MCP server, không bao giờ đến LLM. Xem ảnh lớn.

Công cụ MCP cho KiotViet

Mỗi API của KiotViet là một công cụ trong MCP server. Dưới đây là các công cụ AI Agent dùng nhiều nhất. Aura cũng nhận webhook từ KiotViet (đơn mới, cập nhật tồn kho, khách mới) để kích hoạt quy trình tự động.

Công cụ	Agent dùng để	Loại	Duyệt
Hàng hóa và tồn kho
`kiotviet.search_products`	Tìm hàng theo tên, mã hàng, mã vạch, nhóm hàng	Đọc	Tự động
`kiotviet.get_product`	Xem giá bán, thuộc tính (size, màu), đơn vị tính, hình ảnh	Đọc	Tự động
`kiotviet.get_inventory`	Tồn kho của một mặt hàng theo từng chi nhánh	Đọc	Tự động
`kiotviet.list_price_books`	Lấy giá theo bảng giá: lẻ, sỉ, khách VIP	Đọc	Tự động
`kiotviet.update_product`	Sửa thông tin hoặc giá bán	Ghi	Cần duyệt
Đơn hàng và hóa đơn
`kiotviet.search_orders`	Tra đơn đặt hàng theo mã đơn, số điện thoại, trạng thái	Đọc	Tự động
`kiotviet.get_invoice`	Xem hóa đơn, trạng thái thanh toán và giao hàng	Đọc	Tự động
`kiotviet.create_order`	Tạo đơn đặt hàng từ hội thoại (đơn nháp chờ xác nhận)	Ghi	Theo chính sách
`kiotviet.cancel_order`	Hủy hoặc đổi trạng thái đơn đặt hàng	Ghi	Cần duyệt
Khách hàng
`kiotviet.search_customers`	Tìm khách theo số điện thoại, tên, mã khách	Đọc	Tự động
`kiotviet.get_customer_history`	Lịch sử mua, tổng chi tiêu, công nợ, nhóm khách	Đọc	Tự động
`kiotviet.upsert_customer`	Tạo hoặc cập nhật khách từ thông tin trong chat	Ghi	Theo chính sách
Chi nhánh và báo cáo
`kiotviet.list_branches`	Danh sách chi nhánh, địa chỉ, giờ mở cửa	Đọc	Tự động
`kiotviet.sales_summary`	Doanh thu theo ngày, chi nhánh, mặt hàng	Đọc	Tự động

Tự động: chạy ngay. Theo chính sách: tự chạy khi dưới ngưỡng bạn đặt, vượt ngưỡng thì chờ người duyệt. Cần duyệt: luôn chờ người có thẩm quyền xác nhận. Bạn đổi được mức duyệt của từng công cụ.

API KiotViet gồm những gì?

API KiotViet chia theo nhóm dữ liệu của cửa hàng: hàng hóa và nhóm hàng, tồn kho theo chi nhánh, bảng giá, khách hàng, đơn đặt hàng, hóa đơn, chi nhánh, nhà cung cấp. Ứng dụng kết nối xác thực bằng Client ID và Client Secret để lấy access token có thời hạn, rồi gọi từng API bằng token đó. Ngoài các API đọc và ghi, KiotViet còn có webhook báo cho ứng dụng biết khi có đơn mới, hàng thay đổi tồn kho hay khách mới.

Tự lập trình với KiotViet API nghĩa là bạn phải tự lo phần làm mới token, phân trang khi lấy danh sách dài, giới hạn số lần gọi, xử lý lỗi và cập nhật khi KiotViet đổi phiên bản. MCP server của Aura làm sẵn những việc đó, nên phần còn lại chỉ là chọn công cụ nào được bật. Nếu bạn muốn hiểu nền tảng trước, đọc API là gì và webhook là gì.

KiotViet kết nối được với những gì qua Aura?

Qua MCP server, KiotViet kết nối với các kênh và hệ thống mà cửa hàng đang dùng: Zalo OA và Facebook để trả lời khách, ZNS để gửi thông báo đơn hàng, MISA AMIS hoặc phần mềm kế toán khác để đối chiếu công nợ, và n8n cho các quy trình chạy theo lịch. Mỗi kết nối dùng chung một cơ chế quyền hạn, duyệt và nhật ký.

KiotViet CRM: chăm sóc khách hàng ngay trên dữ liệu KiotViet

KiotViet đã lưu khách hàng, nhóm khách, lịch sử mua và công nợ. Điều nhiều cửa hàng tìm khi gõ "KiotViet CRM" hay "CRM KiotViet" là phần còn thiếu: lịch sử trò chuyện với khách, nhắc chăm sóc đúng lúc, và biết khách đang nhắn là khách quen hay khách mới. Aura bổ sung đúng lớp đó mà không bắt bạn chuyển dữ liệu sang một phần mềm CRM khác: hội thoại Zalo, Facebook được gắn vào đúng khách hàng trên KiotViet, AI Agent đọc lịch sử mua để tư vấn và nhắc mua lại. Xem thêm CRM tích hợp AI.

4 quy trình chạy ngay với KiotViet

Mỗi quy trình là một chuỗi công cụ MCP được Orchestration Brain gọi theo đúng thứ tự, có điểm dừng cho người duyệt khi cần.

Tra tồn kho theo chi nhánh

Khách hỏi còn hàng không. Agent tìm đúng mặt hàng, kiểm tra tồn ở chi nhánh khách nhắc tới, gợi ý chi nhánh gần nhất còn hàng và báo giá theo bảng giá của khách.

kiotviet.search_productskiotviet.get_inventorykiotviet.list_price_books

Chốt đơn ngay trong chat

Khách đồng ý mua. Agent nhận diện khách cũ qua số điện thoại, tạo đơn đặt hàng nháp trên KiotViet. Đơn dưới ngưỡng bạn đặt tự xác nhận, đơn lớn chờ nhân viên duyệt.

kiotviet.search_customerskiotviet.create_order

Báo trạng thái đơn và giao hàng

Khách hỏi "đơn của chị tới đâu rồi". Agent tra đơn theo số điện thoại, báo trạng thái thanh toán và giao hàng. Đơn đổi trạng thái thì gửi thông báo ZNS tự động.

kiotviet.search_orderskiotviet.get_invoice

Nhắc mua lại và chăm khách VIP

Từ lịch sử mua, Agent tìm khách đến chu kỳ mua lại hoặc khách VIP lâu chưa quay lại, soạn tin cá nhân hóa gửi qua Zalo OA trong khung cho phép.

kiotviet.get_customer_historyzalo_oa.send_template

Ví dụ: Chuỗi 6 cửa hàng giày ở TP.HCM nhận khoảng 250 tin nhắn Zalo mỗi ngày, 60% là hỏi còn size và giá. Sau khi kết nối KiotViet, AI Agent trả lời các câu này trong vài giây kể cả buổi tối, tạo đơn nháp cho khách muốn giữ hàng, và chủ chuỗi nhận báo cáo doanh thu từng chi nhánh qua Zalo lúc 22 giờ mỗi ngày.

Một MCP server, ba cách dùng

Cùng một kết nối KiotViet, cùng quyền hạn và nhật ký, dùng được ở cả ba nơi.

AI Agent trong hộp thư Aura

Agent trả lời khách trên Zalo OA, Facebook, website bằng dữ liệu KiotViet thật, chuyển cho nhân viên khi cần. Hộp thư đa kênh.

Workflow tự động với n8n

Chạy theo lịch hoặc theo sự kiện: báo cáo cuối ngày, nhắc việc, đồng bộ dữ liệu. Bước ghi dữ liệu đi qua luồng duyệt. Mẫu n8n workflow.

Trợ lý AI của bạn

Kết nối Claude, ChatGPT hoặc Gemini với MCP endpoint của Aura bằng token riêng của doanh nghiệp, rồi hỏi bằng tiếng Việt: "Hôm qua chi nhánh nào bán chậm nhất, mặt hàng nào sắp hết hàng?"

Bảo mật và phân quyền

Kết nối AI với dữ liệu kinh doanh chỉ đáng làm khi bạn kiểm soát được AI làm gì. Đây là các nguyên tắc áp dụng cho mọi MCP server của Aura.

Khóa API không rời máy chủ

Thông tin kết nối KiotViet được mã hóa AES-256 khi lưu. AI Agent và trợ lý bên ngoài không bao giờ nhận được khóa, chỉ nhận dữ liệu đã chuẩn hóa.

Tách biệt từng doanh nghiệp

Mỗi doanh nghiệp có token MCP riêng. Danh tính doanh nghiệp lấy từ token đã xác thực, không lấy từ tham số do AI truyền vào.

Đọc tự do, ghi phải duyệt

Công cụ đọc chạy ngay. Công cụ ghi đi qua kiểm tra chính sách; thao tác rủi ro cao chờ người duyệt qua Zalo hoặc email trước khi thực thi. Hết hạn mà chưa duyệt thì tự hủy.

Nhật ký mọi lần gọi

Ai gọi, công cụ nào, lúc nào, kết quả ra sao, ai duyệt. Dùng để kiểm tra, đối soát và tối ưu chi phí.

Quyền tối thiểu

Chỉ bật những công cụ quy trình cần. Có thể bắt đầu ở chế độ chỉ đọc rồi mở dần quyền ghi.

Ổn định khi API chập chờn

Tự thử lại có giãn cách, ngắt mạch khi KiotViet quá tải, tôn trọng giới hạn tần suất gọi, và báo lỗi rõ ràng thay vì đoán.

Thu hồi quyền bất cứ lúc nào: xóa kết nối trong Aura hoặc vô hiệu hóa khóa API ngay trong KiotViet.

Triển khai trong 5 bước

Đội Aura làm phần kỹ thuật. Bạn chuẩn bị quyền truy cập và quyết định quy trình nào chạy tự động.

Cấp quyền truy cập KiotViet API
Chủ cửa hàng tạo Client ID và Client Secret trong phần thiết lập kết nối API của KiotViet, rồi gửi cho Aura qua kênh bảo mật. Tên mục có thể khác theo phiên bản; đội Aura hướng dẫn trực tiếp.
Aura cấu hình MCP server
Đội Aura mã hóa thông tin kết nối, kiểm tra quyền, chọn chi nhánh hoặc kho cần dùng và chạy thử từng công cụ với dữ liệu KiotViet của bạn.
Chọn công cụ và mức duyệt
Bạn quyết định công cụ nào được bật, ngưỡng nào tự chạy, ai duyệt thao tác ghi và duyệt qua kênh nào (Zalo hoặc email).
Chạy thử ở chế độ gợi ý
Trong 1–2 tuần đầu, AI Agent soạn câu trả lời và đề xuất thao tác để nhân viên xem trước khi gửi. Chỉnh kiến thức và quy tắc theo phản hồi thật.
Bật tự động và theo dõi
Mở chế độ tự trả lời cho các tình huống đã ổn định. Theo dõi nhật ký, tỷ lệ chuyển cho người và thời gian phản hồi trên bảng điều khiển.

Tự kết nối KiotViet API hay dùng MCP server có sẵn?

Ba cách phổ biến để đưa dữ liệu KiotViet vào quy trình chăm sóc và bán hàng.

Tiêu chí	Tự lập trình với KiotViet API	n8n / Make + HTTP	Aura MCP server
Thời gian đưa vào chạy	Vài tuần đến vài tháng	Vài ngày đến vài tuần cho mỗi luồng	Vài ngày, đội Aura cấu hình
Hiểu tin nhắn tự do của khách	Tự xây phần AI và xử lý ngữ cảnh	Tự ghép bước gọi AI, tự viết prompt	Có sẵn Orchestration Brain và bộ nhớ hội thoại
Quản lý token, giới hạn gọi API KiotViet	Đội bạn tự làm	Một phần, phải tự xử lý lỗi	Có sẵn: thử lại, ngắt mạch, nhật ký
Duyệt trước khi ghi dữ liệu	Tự xây màn hình duyệt	Tự ghép luồng duyệt	Có sẵn, đặt mức duyệt cho từng công cụ
Dùng từ Claude, ChatGPT, Gemini	Phải tự viết MCP server	Không trực tiếp	Có, cùng một MCP endpoint
Bảo trì khi KiotViet đổi API	Đội bạn	Đội bạn	Đội Aura

Đang cân nhắc công cụ workflow? Xem so sánh Zapier, Make và n8n và API là gì.

Đọc thêm

Các bài viết liên quan đến kết nối KiotViet, MCP và AI Agent.

API là gì

Vì sao phần mềm cần API trước khi AI làm việc được trên đó.

MCP là gì

Chuẩn mở để AI Agent đọc dữ liệu doanh nghiệp an toàn.

AI Agent ngành bán lẻ

Ứng dụng AI Agent cho cửa hàng và chuỗi bán lẻ.

ZNS là gì

Gửi thông báo đơn hàng qua Zalo tự động từ phần mềm bán hàng.

Mẫu n8n workflow

Luồng đơn mới → Zalo, lead → Google Sheet.

Upsell và cross-sell

Gợi ý mua thêm từ lịch sử mua của khách.

Câu hỏi thường gặp về kết nối KiotViet

KiotViet có API không?

Có. KiotViet cung cấp API để phần mềm khác đọc và ghi dữ liệu cửa hàng như hàng hóa, tồn kho, khách hàng, đơn đặt hàng, hóa đơn, chi nhánh, và gửi webhook khi có sự kiện mới. Aura dùng API này để xây MCP server cho AI Agent.

Lấy Client ID và Client Secret KiotViet ở đâu?

Trong phần thiết lập kết nối API trên trang quản lý KiotViet, thường chỉ tài khoản chủ cửa hàng hoặc quản trị mới thấy. Tên mục có thể thay đổi theo phiên bản; đội Aura hướng dẫn từng bước khi triển khai.

Kết nối KiotViet với Zalo được không?

Được. Aura nhận và trả lời tin nhắn trên Zalo OA qua API chính thức của Zalo, đồng thời gọi KiotViet để lấy tồn kho, giá và đơn hàng. Thông báo đơn hàng có thể gửi qua ZNS khi đơn đổi trạng thái.

AI Agent có tự sửa giá hay hủy đơn trên KiotViet không?

Mặc định là không. Công cụ sửa giá và hủy đơn luôn chờ người có thẩm quyền duyệt. Tạo đơn nháp có thể tự chạy dưới ngưỡng giá trị bạn đặt. Bạn đổi được mức duyệt của từng công cụ.

Aura có thay thế KiotViet hay KiotViet CRM không?

Không. KiotViet vẫn là nơi lưu hàng hóa, đơn và khách hàng. Aura thêm lớp hội thoại và AI Agent để chăm sóc, tư vấn và chốt đơn trên kênh chat, dùng chính dữ liệu đó.

Gói KiotViet nào dùng được API?

Quyền dùng API phụ thuộc gói dịch vụ KiotViet bạn đang dùng và chính sách hiện hành của KiotViet. Đội Aura kiểm tra giúp trong buổi khảo sát trước khi triển khai.

Có thể kết nối n8n với KiotViet không?

Có, bằng node HTTP Request gọi KiotViet API. Cách này hợp với luồng đồng bộ cố định. Khi cần hiểu tin nhắn tự do của khách, nhớ ngữ cảnh và duyệt trước khi ghi, MCP server của Aura tiết kiệm nhiều công xây và bảo trì hơn.

Dữ liệu KiotViet có bị gửi cho bên thứ ba không?

Khóa API được mã hóa và chỉ dùng trên máy chủ Aura. AI Agent chỉ nhận phần dữ liệu cần cho câu trả lời, và mọi lần gọi đều được ghi nhật ký theo từng doanh nghiệp.

KiotViet là thương hiệu của chủ sở hữu tương ứng. Aura kết nối qua API do KiotViet cung cấp cho khách hàng của họ; tên công cụ trên trang này là tên trong MCP server của Aura.

Demo trên dữ liệu KiotViet của bạn

Để AI Agent trả lời khách bằng dữ liệu KiotViet

Xem AI Agent tra tồn kho, báo giá và tạo đơn nháp từ chính dữ liệu KiotViet của cửa hàng bạn, trên Zalo OA và Facebook.

Đặt lịch demo miễn phí Xem tất cả tích hợp