Tích hợp Haravan

Kết nối Haravan với AI Agent: chăm khách như stylist riêng của thương hiệu

Thương hiệu thời trang, mỹ phẩm bán qua website Haravan và chuỗi cửa hàng cần tư vấn nhanh mà vẫn tinh tế. Aura thêm AI Agent đọc sản phẩm, tồn kho từng cửa hàng, đơn hàng và lịch sử khách trên Haravan qua MCP server có sẵn.

Hôm nay
Khách hỏi online, nhân viên gọi từng cửa hàng

Khách nhắn Fanpage hỏi mẫu còn ở cửa hàng gần nhà không. Nhân viên online gọi cửa hàng kiểm tra, khách chờ cả tiếng, khách VIP được trả lời như mọi người.

Với Aura
AI Agent biết hàng ở đâu và khách là ai

Trả lời ngay cửa hàng nào còn size, giữ hàng cho khách đến thử, nhận ra khách VIP để chuyển đúng tư vấn viên.

Haravan API kết nối với AI Agent như thế nào?

Haravan 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 theo địa điểm, đơn hàng, vận chuyển, khách hàng và khuyến mãi, kèm webhook khi dữ liệu thay đổi. Aura đóng gói các API này thành MCP server, để AI Agent tư vấn, giữ hàng và chăm sóc khách bằng dữ liệu Haravan thật.

Với thương hiệu bán lẻ có cả website và chuỗi cửa hàng, câu hỏi khó nhất của khách thường là "cửa hàng gần tôi còn không". Dữ liệu đó có trong Haravan theo từng địa điểm. AI Agent trả lời được ngay, và biết khách đang hỏi là khách mới hay khách đã mua mười lần. Đọc thêm về upsell và cross-sell từ lịch sử mua.

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

Khách nhắn tin

Khách nhắn Fanpage: "Váy mã V2318 size S còn ở cửa hàng Quận 3 không, chiều nay mình qua thử."

Orchestration Brain

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

MCP server Haravan

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

Haravan API

Tra biến thể, tồn kho theo địa điểm, khách hàng, đơn hàng; tạo đơn giữ hàng.

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

Báo còn hàng, giữ hàng tại cửa hàng, báo cửa hàng chuẩn bị, nhắc khách trước giờ hẹ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 Haravan 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ự: Aura MCP server, workflow engine và Haravan API

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

Công cụ MCP cho Haravan

Các công cụ AI Agent dùng nhiều nhất với Haravan. Aura nhận webhook đơn mới, đơn cập nhật và khách hàng mới từ Haravan để kích hoạt quy trình chăm sóc ngay khi có sự kiện.

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

API Haravan gồm những gì?

API Haravan cung cấp dữ liệu theo các nhóm: sản phẩm, biến thể và bộ sưu tập; tồn kho theo từng địa điểm (cửa hàng, kho); đơn hàng và vận chuyển; khách hàng; khuyến mãi. Ứng dụng xác thực qua ứng dụng riêng hoặc cấp quyền OAuth với phạm vi (scope) rõ ràng, và nhận webhook khi đơn hàng, sản phẩm hay khách hàng thay đổi.

Điểm cần chú ý khi tự làm với Haravan API là tồn kho nằm theo từng địa điểm, nên câu hỏi "cửa hàng gần tôi còn không" cần ghép dữ liệu tồn kho với danh sách địa điểm và vị trí khách. MCP server của Aura có sẵn công cụ cho việc này, cùng cơ chế thử lại, giới hạn số lần gọi và nhật ký. Đọc thêm: API là gì.

4 quy trình cho thương hiệu bán lẻ trên Haravan

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.

Còn hàng ở cửa hàng gần khách

Khách hỏi một mẫu, một size. Agent kiểm tra tồn kho tại từng cửa hàng, gợi ý cửa hàng gần nhất còn hàng kèm địa chỉ, giờ mở cửa, hoặc đề xuất giao tận nơi.

haravan.get_variantharavan.list_locationsharavan.get_inventory

Giữ hàng để khách đến thử

Khách hẹn chiều qua thử. Agent tạo đơn giữ hàng nhận tại cửa hàng, báo cửa hàng chuẩn bị và nhắc khách trước giờ hẹn qua Zalo.

haravan.create_draft_orderharavan.update_order_tags

Nhận diện và chăm khách VIP

Khi khách nhắn, Agent tra lịch sử mua. Khách hạng cao được chuyển đúng tư vấn viên quen kèm tóm tắt sở thích; ưu đãi riêng được đề xuất chờ quản lý duyệt.

haravan.search_customersharavan.get_customer_ordersharavan.create_discount_code

Nhắc mua lại theo chu kỳ

Mỹ phẩm, chăm sóc da có chu kỳ dùng. Agent tìm khách đến thời điểm mua lại, gợi ý sản phẩm bổ trợ theo đơn trước và gửi tin qua Zalo OA trong khung cho phép.

haravan.get_customer_orderszalo_oa.send_template

Ví dụ: Một thương hiệu thời trang nữ có website Haravan và 9 cửa hàng ở Hà Nội, TP.HCM. Phần lớn tin nhắn Fanpage hỏi mẫu còn ở cửa hàng nào. Sau khi kết nối Haravan, AI Agent trả lời theo tồn kho từng cửa hàng, tạo đơn giữ hàng cho khách hẹn đến thử, và chuyển khách VIP cho stylist quen kèm tóm tắt các lần mua trước.

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

Cùng một kết nối Haravan, 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 Haravan 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: "Tuần này khách VIP nào chưa quay lại mua, họ thường mua dòng sản phẩm nào?"

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

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.

  1. Cấp quyền truy cập Haravan API

    Chủ cửa hàng tạo ứng dụng riêng hoặc cấp quyền cho ứng dụng trong trang quản trị Haravan, chọn phạm vi quyền theo danh sách Aura gửi (sản phẩm, tồn kho, đơn hàng, khách hàng), rồi chia sẻ thông tin kết nối qua kênh bảo mật.

  2. 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 Haravan của bạn.

  3. 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).

  4. 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.

  5. 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 Haravan API hay dùng MCP server có sẵn?

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

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

Đọc thêm

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

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

Haravan có API không?

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

Đã dùng công cụ chat đa kênh cho Haravan, Aura khác gì?

Công cụ chat đa kênh gom tin nhắn để nhân viên trả lời. Aura thêm AI Agent hiểu câu hỏi, tự tra tồn kho từng cửa hàng, lịch sử khách và hành động trên Haravan, chỉ chuyển cho người khi cần. Aura cũng kết nối được các hệ thống khác cùng lúc, như phần mềm kế toán và Zalo OA.

AI Agent có tự tạo mã giảm giá không?

Không. Tạo mã ưu đãi và hủy đơn luôn chờ người duyệt. Tạo đơn giữ hàng có thể tự chạy theo ngưỡng bạn đặt, ví dụ tối đa 2 sản phẩm mỗi khách.

Aura có kết nối được cả Haravan và Sapo cùng lúc không?

Được. Mỗi nền tảng có MCP server riêng. Doanh nghiệp dùng nhiều hệ thống có thể bật nhiều MCP server, Orchestration Brain chọn đúng công cụ theo từng câu hỏi.

Aura có thay thế Haravan không?

Không. Haravan vẫn là nơi quản lý website, 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 Haravan.

Dữ liệu khách VIP 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 cho từng tác vụ, mỗi doanh nghiệp được tách biệt và mọi lần gọi đều có nhật ký để kiểm tra.

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

Thường vài ngày làm việc. Phần cần thời gian nhất là thống nhất quy tắc giữ hàng, cách nhận diện khách VIP và giọng văn tư vấn của thương hiệu.

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

Để AI Agent tư vấn bằng dữ liệu Haravan của thương hiệu

Xem AI Agent kiểm tra hàng tại từng cửa hàng, giữ hàng cho khách đến thử và nhận diện khách VIP từ dữ liệu Haravan của bạn.

Thank you for your interest!