Kênh bán & Chat Order

XCaphe hỗ trợ 6 kênh bán tích hợp sẵn. Đơn từ mọi kênh đổ về một dashboard duy nhất.

Kênh nền tảng ngoài (Gói chuỗi+, add-on): Shopee Food, GrabFood, TikTok Shop, Facebook Shop, Zalo OA
Cửa hàng Online riêng (Gói Nâng cao+, add-on 49K/tháng): [ten].xcaphe.vn — xem Cửa hàng Online

Kênh bán trực tuyến

XCaphe nhận đơn từ các nền tảng sau. Đơn hàng tự động chuyển vào hệ thống, không cần thao tác thủ công:

Nền tảng	Loại	Gói yêu cầu
Shopee Food	Structured order	Gói chuỗi + add-on kênh
GrabFood	Structured order	Gói chuỗi + add-on kênh
TikTok Shop	Structured order	Gói chuỗi + add-on kênh
Zalo OA	Chat → AI order	Gói chuỗi + add-on kênh
Facebook Messenger	Chat → AI order	Gói chuỗi + add-on kênh
Cửa hàng xcaphe.vn	Self-managed store	Gói Nâng cao + add-on 49K/tháng

Kết nối Shopee Food / GrabFood / TikTok

Thêm kênh

Vào Cài đặt → Kênh bán → + Thêm kênh, chọn nền tảng.

Nhập thông tin API

Điền API Key và Merchant ID lấy từ portal của từng nền tảng.

Mapping món

Ghép tên món trên nền tảng với món trong XCaphe. Ví dụ: "Cà phê đen đá" trên GrabFood ↔ "Black Coffee Ice" trong XCaphe.

Kiểm tra kết nối

Nhấn Test webhook — XCaphe gửi test event để xác nhận kết nối thành công.

Mapping món là bước quan trọng. Nếu đơn có item chưa mapping, đơn sẽ bị giữ lại ở trạng thái Cần xử lý thay vì tự động vào queue.

Luồng đơn hàng:

flowchart LR A["🛒 Khách đặt trên Shopee Food"] --> B["🔗 Webhook gửi đơn<br/>vào XCaphe"] B --> C["📊 Đơn xuất hiện<br/>trong dashboard<br/>tab Kênh ngoài"] C --> D["⚙️ Xử lý như<br/>đơn QR thông thường"] style A fill:#fff3e0 style D fill:#e8f5e9

Quy trình nhận đơn từ Shopee Food qua webhook

Zalo OA — Chatbot AI nhận đơn

Khách nhắn tin qua Zalo Official Account của quán → AI tự động nhận đơn, xác nhận, tạo đơn hàng.

Kết nối Zalo OA

Tạo Zalo App

Vào developers.zalo.me (opens in a new tab), tạo App mới, lấy App ID và App Secret.

Nhập thông tin vào XCaphe

Vào Cài đặt → Kênh bán → Zalo OA, điền:

App ID
App Secret
Webhook Secret (tự đặt, dùng để verify webhook)

Cấp quyền OAuth

Nhấn Kết nối Zalo OA → XCaphe redirect sang Zalo để quán cấp quyền quản lý OA. Sau khi cấp quyền, token được lưu tự động.

Đặt webhook URL

Trong Zalo Developer Console, cấu hình webhook URL:

https://api.xcaphe.vn/channels/webhook/zalo_oa?orgId=ORG_ID_CỦA_BẠN

Lấy Organization ID của bạn:

Vào Cài đặt → Webhooks trong XCaphe dashboard
Tìm mục "Organization Identifier" — đó chính là orgId cần dùng
Copy và dán vào URL webhook phía trên

Chọn event: user_send_text, user_send_image, follow.

Luồng chatbot AI

Khách nhắn: "cho mình 2 cà phê sữa đá và 1 trà đào size L"
    ↓
AI (Claude Haiku) phân tích menu của quán
    ↓
Bot reply:
  🛒 Đơn hàng của bạn:
  • 2× Cà Phê Sữa Đá — 70.000đ
  • 1× Trà Đào (Size L) — 45.000đ
  💰 Tổng: 115.000đ
  Xác nhận đặt không? (Trả lời "đúng" để đặt)
    ↓
Khách: "đúng"
    ↓
Đơn hàng được tạo tự động → bot gửi link theo dõi

Thời gian giữ trạng thái: Nếu khách không trả lời trong 10 phút, cuộc hội thoại reset. Khách cần nhắn lại từ đầu.

ZNS — Thông báo transactional

Zalo Notification Service (ZNS) cho phép gửi thông báo trạng thái đơn hàng với chi phí thấp hơn tin nhắn thường:

Sự kiện	Nội dung ZNS
Đơn được xác nhận	"Đơn hàng của bạn đã được nhận! 🎉"
Đang pha chế	"Đơn hàng đang được chuẩn bị 👨‍🍳"
Sẵn sàng giao	"Đồ uống của bạn sắp đến 🚀"
Hoàn thành	"Cảm ơn bạn đã ủng hộ! 🙏"

Để dùng ZNS, nhập ZNS Template ID vào cấu hình Zalo OA (lấy từ Zalo Console sau khi template được duyệt).

Facebook Messenger — Chatbot AI

Tương tự Zalo OA, khách nhắn tin qua Facebook Page → AI nhận đơn.

Kết nối Facebook

Tạo Facebook App tại developers.facebook.com (opens in a new tab)
Thêm sản phẩm Messenger vào app
Lấy Page Access Token và App Secret
Cấu hình trong XCaphe: Cài đặt → Kênh bán → Facebook
Webhook URL:
```
https://api.xcaphe.vn/channels/webhook/facebook?orgId=ORG_ID_CỦA_BẠN
```
Lấy Organization ID của bạn: Vào Cài đặt → Webhooks → Organization Identifier trong XCaphe
Nhập Verify Token (tự đặt) — dùng cho Facebook webhook challenge

Luồng chatbot (tương tự Zalo)

Khách nhắn tự do → AI extract đơn → confirm → tạo đơn → gửi link track qua Messenger.

Câu hỏi thường gặp

Q: Shopee Food huỷ đơn sau khi đã vào XCaphe thì sao?

Shopee Food gửi webhook huỷ. XCaphe tự động chuyển trạng thái sang "Đã huỷ". Kho không bị trừ nếu đơn chưa hoàn thành.

Q: Có thể tắt kênh tạm thời không?

Có. Vào Kênh bán → [Tên kênh] → Tắt kích hoạt. Đơn mới sẽ không được nhận vào trong thời gian tắt.

Q: Bot AI không nhận ra món, phải làm gì?

Đảm bảo tên món trong menu XCaphe rõ ràng và đúng tiếng Việt. AI tìm kiếm theo tên gần đúng (fuzzy matching). Nếu khách dùng biệt danh (ví dụ "bạc xỉu" thay vì "cà phê sữa nóng"), có thể thêm alias trong phần Cài đặt menu.

Q: Zalo token hết hạn thì sao?

XCaphe tự động làm mới token Zalo định kỳ. Nếu kết nối bị mất (thường do không dùng lâu ngày), vào Cài đặt → Kênh bán → Zalo OA và nhấn Kết nối lại để cấp quyền mới.

Giao hàng tận nơi Cửa hàng Online (xcaphe.vn)