Tích hợp Sapo

Kết nối Sapo với AI Agent: xác nhận đơn, tra vận đơn, chăm khách tự động

Shop bán đa kênh trên Sapo nhận đơn từ website, Facebook, sàn thương mại điện tử. Aura thêm AI Agent đọc đơn hàng, tồn kho và vận chuyển trên Sapo qua MCP server có sẵn, rồi xử lý phần hội thoại với khách trên Zalo và Facebook.

Hôm nay

Nhân viên gọi xác nhận từng đơn COD

Đơn COD đổ về từ nhiều kênh, nhân viên gọi xác nhận từng đơn, tra mã vận đơn cho khách hỏi, tỷ lệ hoàn hàng vẫn cao vì khách không nghe máy.

Với Aura

AI Agent xác nhận và trả lời qua chat

Đơn mới được xác nhận qua Zalo trong vài phút, khách tự hỏi được trạng thái giao hàng, nhân viên chỉ gọi những đơn chưa phản hồi.

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

Sapo API và AI Agent: kết nối để làm gì?

Sapo cung cấp API để ứng dụng khác đọc và ghi dữ liệu cửa hàng: sản phẩm, biến thể, tồn kho, đơn hàng, vận chuyển, khách hàng và khuyến mãi, kèm webhook khi có đơn mới hoặc đơn thay đổi. Aura đóng gói các API này thành MCP server, để AI Agent tự xác nhận đơn, tra vận đơn và tư vấn khách bằng dữ liệu Sapo thật.

Sapo gom đơn từ nhiều kênh về một nơi rất tốt. Phần còn lại là hàng trăm cuộc trò chuyện quanh những đơn đó: xác nhận địa chỉ, hỏi khi nào giao, xin đổi size. Đó là việc của AI Agent. Nếu bạn đang cân nhắc trợ lý AI có sẵn của Sapo, phần câu hỏi thường gặp bên dưới nói rõ khi nào Aura tạo thêm giá trị. Đọc thêm về AI bán hàng trên Facebook, Zalo.

Cách Aura kết nối Sapo 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 Sapo; nó chỉ gọi công cụ đã được cấp quyền.

Khách nhắn tin

Đơn COD mới từ website, hoặc khách nhắn Facebook: "Đơn SP10234 của mình bao giờ tới?"

Orchestration Brain

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

MCP server Sapo

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

Sapo API

Tra đơn, vận đơn, tồn kho biến thể, khách hàng; ghi chú và gắn nhãn đơn.

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

Xác nhận đơn qua Zalo, báo ngày giao dự kiến, ghi kết quả vào đơn trên Sapo.

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 Sapo 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 Sapo và Sapo 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 Sapo API. Credential Sapo chỉ được giải mã trong MCP server, không bao giờ đến LLM. Xem ảnh lớn.

Công cụ MCP cho Sapo

Các công cụ AI Agent dùng nhiều nhất với Sapo. Aura nhận webhook đơn mới, đơn cập nhật và trạng thái vận chuyển từ Sapo để kích hoạt quy trình ngay khi sự kiện xảy ra.

Công cụ	Agent dùng để	Loại	Duyệt
Sản phẩm và tồn kho
`sapo.search_products`	Tìm sản phẩm theo tên, SKU, mã vạch, danh mục	Đọc	Tự động
`sapo.get_variant`	Giá, thuộc tính (size, màu), hình ảnh của từng biến thể	Đọc	Tự động
`sapo.get_inventory`	Tồn kho theo kho hoặc chi nhánh	Đọc	Tự động
Đơn hàng và vận chuyển
`sapo.search_orders`	Tra đơn theo mã đơn, số điện thoại, kênh bán, trạng thái	Đọc	Tự động
`sapo.get_fulfillment`	Mã vận đơn, đơn vị vận chuyển, trạng thái giao hàng	Đọc	Tự động
`sapo.create_draft_order`	Tạo đơn nháp từ hội thoại	Ghi	Theo chính sách
`sapo.update_order_tags`	Gắn nhãn, ghi chú đơn (đã xác nhận, đổi địa chỉ, cần gọi)	Ghi	Tự động
`sapo.cancel_order`	Hủy đơn theo yêu cầu khách	Ghi	Cần duyệt
Khách hàng
`sapo.search_customers`	Tìm khách theo số điện thoại, email, tên	Đọc	Tự động
`sapo.get_customer_orders`	Lịch sử đơn, tổng chi tiêu, tỷ lệ hoàn hàng	Đọc	Tự động
`sapo.upsert_customer`	Tạo hoặc cập nhật khách và nhóm khách	Ghi	Theo chính sách
Khuyến mãi
`sapo.list_discounts`	Chương trình khuyến mãi và mã giảm giá đang chạy	Đọc	Tự động
`sapo.create_discount_code`	Tạo mã giảm giá riêng cho một khách	Ghi	Cần duyệt

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 Sapo gồm những gì?

API Sapo theo kiểu REST quen thuộc của các nền tảng thương mại điện tử: sản phẩm và biến thể, tồn kho theo kho, đơn hàng, vận chuyển, khách hàng, khuyến mãi. Ứng dụng xác thực bằng thông tin của ứng dụng riêng hoặc qua cấp quyền OAuth, chỉ được truy cập phạm vi dữ liệu đã cấp. Webhook báo ngay khi có đơn mới, đơn đổi trạng thái hay khách mới, để quy trình chạy theo thời gian thực thay vì quét định kỳ.

Khi tự lập trình với Sapo API, bạn cần xử lý phân trang, giới hạn số lần gọi, xác thực chữ ký webhook và chống xử lý trùng sự kiện. MCP server của Aura làm sẵn các phần này. Đọc thêm: webhook là gì.

Sapo CRM và lớp chăm sóc khách hàng trên chat

Sapo đã có hồ sơ khách hàng, nhóm khách và lịch sử đơn. Thứ chủ shop thường tìm khi gõ "Sapo CRM" là cách chăm sóc khách liên tục: biết khách đang nhắn đã mua gì, đang có đơn nào, có hay hoàn hàng không, và nhắc lại đúng lúc. Aura gắn hội thoại Zalo, Facebook vào đúng khách hàng trên Sapo, để AI Agent tư vấn theo lịch sử thật và nhân viên nhìn thấy toàn bộ ngữ cảnh khi tiếp nhận. Xem thêm CRM tích hợp AI.

4 quy trình cho shop bán đa kênh trên Sapo

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.

Xác nhận đơn COD qua Zalo

Có đơn COD mới, Agent gửi tin xác nhận kèm sản phẩm, địa chỉ, tổng tiền. Khách xác nhận thì đơn được gắn nhãn; khách sửa địa chỉ thì Agent cập nhật ghi chú; không phản hồi thì chuyển nhân viên gọi.

sapo.search_orderssapo.update_order_tags

Tra vận đơn trong chat

Khách hỏi đơn đang ở đâu. Agent tra đơn theo số điện thoại, lấy mã vận đơn và trạng thái từ Sapo, báo ngày giao dự kiến và đơn vị vận chuyển.

sapo.search_orderssapo.get_fulfillment

Tư vấn theo tồn kho thật

Khách hỏi mẫu, size, màu. Agent chỉ gợi ý biến thể còn hàng, báo giá đúng chương trình khuyến mãi đang chạy, và tạo đơn nháp khi khách đồng ý.

sapo.get_variantsapo.get_inventorysapo.list_discountssapo.create_draft_order

Đổi trả và giữ chân khách

Khách muốn đổi size. Agent kiểm tra điều kiện đổi trả, tồn kho size mới, ghi yêu cầu vào đơn. Với khách mua nhiều, Agent đề xuất mã giảm giá riêng chờ quản lý duyệt.

sapo.get_customer_orderssapo.update_order_tagssapo.create_discount_code

Ví dụ: Một shop mỹ phẩm bán qua website và Facebook có khoảng 300 đơn COD mỗi ngày, 2 nhân viên gọi xác nhận không kịp. Sau khi kết nối Sapo, AI Agent xác nhận đơn qua Zalo ngay khi đơn được tạo; nhân viên chỉ gọi các đơn chưa phản hồi sau 2 giờ và xử lý yêu cầu đổi trả.

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

Cùng một kết nối Sapo, 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 Sapo 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: "Từ sáng tới giờ có bao nhiêu đơn COD chưa xác nhận, đơn nào giá trị cao nhất?"

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 Sapo đượ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 Sapo 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 Sapo.

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 Sapo API
Chủ cửa hàng tạo thông tin kết nối API (ứng dụng riêng hoặc cấp quyền cho ứng dụng) trong trang quản trị Sapo, chọn phạm vi quyền theo danh sách Aura gửi, rồi chia sẻ qua kênh bảo mật. Quyền dùng API có thể phụ thuộc gói Sapo bạn đang dùng.
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 Sapo 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 Sapo API hay dùng MCP server có sẵn?

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

Tiêu chí	Tự lập trình với Sapo 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 Sapo	Độ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 Sapo đổ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 Sapo, MCP và AI Agent.

AI bán hàng

Chatbot tư vấn và chốt đơn trên Facebook, Zalo, website.

ZNS là gì

Thông báo xác nhận đơn, giao hàng qua Zalo theo mẫu.

Chatbot Facebook AI

Tự động trả lời Fanpage và Messenger 24/7.

Webhook là gì

Cách phần mềm báo sự kiện cho nhau theo thời gian thực.

MCP là gì

Chuẩn mở để AI Agent gọi công cụ của phần mềm khác.

Chăm sóc khách hàng

Quy trình 6 bước và chỉ số cần đo.

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

Sapo có API không?

Có. Sapo cung cấp API (API Sapo) để ứng dụng khác đọc và ghi sản phẩm, tồn kho, đơn hàng, vận chuyển, khách hàng, khuyến mãi, và gửi webhook khi có sự kiện. Aura dùng API này để xây MCP server cho AI Agent.

Sapo đã có trợ lý AI, cần Aura để làm gì?

Nếu bạn chỉ bán trên các kênh Sapo hỗ trợ và cần trả lời cơ bản, trợ lý có sẵn của Sapo có thể đủ. Aura phù hợp khi bạn cần kết hợp nhiều hệ thống (Sapo với phần mềm kế toán, Zalo OA, CRM), cần nhiều Agent phối hợp, duyệt theo chính sách cho từng thao tác, hoặc muốn dùng cùng dữ liệu từ Claude, ChatGPT.

AI Agent có tự hủy đơn trên Sapo không?

Không. Hủy đơn và tạo mã giảm giá luôn chờ người duyệt. Gắn nhãn và ghi chú đơn có thể chạy tự động vì không làm thay đổi giá trị đơn.

Xác nhận đơn COD qua Zalo có cần khách quan tâm Zalo OA không?

Tin xác nhận đơn có thể gửi qua ZNS đến số điện thoại khách, không cần khách quan tâm OA. Khi khách trả lời, hội thoại về Zalo OA và AI Agent xử lý tiếp.

Aura có thay thế Sapo không?

Không. Sapo vẫn là nơi quản lý sản phẩm, kho và đơn hàng. Aura là lớp AI Agent xử lý hội thoại với khách dựa trên dữ liệu Sapo.

Dữ liệu khách hàng trên Sapo có an toàn không?

Thông tin kết nối được mã hóa trên máy chủ Aura, AI Agent chỉ nhận dữ liệu cần thiết cho từng câu trả lời, mỗi doanh nghiệp được tách biệt và mọi lần gọi đều có nhật ký.

Triển khai mất bao lâu?

Thường vài ngày làm việc. Đội Aura cấu hình kết nối, bạn chốt mẫu tin xác nhận đơn, ngưỡng tự động và người duyệt.

Sapo là thương hiệu của chủ sở hữu tương ứng. Aura kết nối qua API do Sapo 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 Sapo của bạn

Để AI Agent xử lý hội thoại quanh mỗi đơn Sapo

Xem AI Agent xác nhận đơn COD, tra vận đơn và tư vấn theo tồn kho thật từ dữ liệu Sapo của shop bạn.

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