🛡️ Trạng thái kết nối Hệ thống
📊 Thống kê nghiệp vụ
📋 Hoạt động gần đây
📈 Thống kê lệnh
📅 Xu hướng đặt bàn 7 ngày
🔗 Kết nối GAS Backend
⚙️ Cấu hình Kết nối Render Bot
🤖 Cấu hình AI (Multi-Provider)
🔐 CukCuk POS
💬 Đăng nhập Zalo Bot (Session Cookie)
• zpsid: Đang tải...
• zpw_sek: Đang tải...
• User Agent: Đang tải...
• IMEI: Đang tải...
🔑 Hướng dẫn lấy Zalo Session (Cookie, User-Agent, IMEI)
Phần lớn lỗi mất kết nối Bot Zalo đều do Session bị nhập sai định dạng hoặc bị hết hạn. Chọn phương thức đồng bộ của sếp:
Hệ thống sẽ khởi tạo một trình duyệt ảo phía Server để kết nối đến Zalo Web và kết xuất mã QR. Sếp chỉ cần sử dụng điện thoại để quét mã QR và chọn Xác nhận/Đăng nhập trên Zalo điện thoại. Hệ thống sẽ tự động đồng bộ và khởi chạy Bot ngay sau đó!
🛡️ Trực quan hóa & Khôi phục Phiên (Session Steward)
Các tùy chọn nâng cao hỗ trợ quản lý bộ nhớ đệm, thu hồi phiên làm việc, khôi phục phiên cũ hoặc kiểm tra lịch sử hoạt động bảo mật.
📅 Lịch sử sao lưu Session (Backups) Tối đa 3 bản ghi
| Thời gian | Phiên bản | Nguồn | zpsid (Masked) |
|---|---|---|---|
| Đang tải dữ liệu... | |||
📋 Nhật ký hoạt động Admin (Audit Logs)
| Thời gian | Hành động | Chi tiết | Kết quả |
|---|---|---|---|
| Đang tải dữ liệu... | |||
🛠️ Bảng điều khiển quản trị Bot từ xa (Quick Actions)
📢 Bảng phát tin & Tương tác từ xa
💬 Mô phỏng lệnh Bot
📟 Khung Logs Render thực tế (Live Logs)
📡 Chẩn đoán & Gửi API thô (Chuyên sâu)
🗺️ Sơ đồ bàn ăn thực tế
📖 Cẩm Nang Vận Hành & Thiết Lập Hệ Thống
Phiên bản 2026.1🔥 CỰC KỲ QUAN TRỌNG: Quy trình Update Apps Script
Mỗi khi bạn thực hiện thay đổi code Apps Script (file .gs) hoặc AI tự động sửa bằng lệnh clasp push, bạn BẮT BUỘC phải thực hiện Deploy phiên bản mới trên giao diện Google Sheets của bạn:
- Mở Apps Script của Google Sheets lên ➔ Chọn nút Triển khai (Deploy) ➔ Quản lý tùy chọn triển khai (Manage deployments).
- Bấm nút hình chiếc bút Chỉnh sửa (✏️) ➔ Chọn **Cấu hình phiên bản** là "Phiên bản mới" (New version).
- Bấm nút Triển khai (Deploy) để lưu lại. Nếu không, các URL bên ngoài vẫn sẽ gọi tới phiên bản cũ và lỗi cũ sẽ không bao giờ được vá!
🔑 Hướng dẫn lấy Zalo Session (Cookie, User-Agent, IMEI)
Để cấu hình và đồng bộ Zalo Session (bằng Tampermonkey hoặc thủ công), vui lòng truy cập tab ⚙️ Cấu hình hệ thống. Hướng dẫn chi tiết đã được chuyển trực tiếp vào tab cấu hình để sếp dễ thao tác.
👥 Hướng dẫn phân quyền nhóm Zalo hoạt động (3 trạng thái)
Hệ thống phân quyền lệnh mới của chúng ta sử dụng cơ chế **3 trạng thái** cực kỳ thông minh nhằm loại bỏ triệt để lỗi "lệnh không được hỗ trợ tại nhóm":
| Trạng thái tick chọn | Cách hoạt động thực tế |
|---|---|
| ❌ Không tick nhóm nào | Lệnh sẽ bị tắt hoàn toàn ở tất cả các nhóm (không phản hồi). |
| ⚠️ Chỉ tick 1 vài nhóm | Lệnh chỉ chạy duy nhất trong các nhóm được chọn. Gõ ở nhóm khác bot sẽ nhắc nhở. |
| 🟢 Chọn tất cả / Tick full | Lệnh được mở quyền và hoạt động ở toàn bộ các nhóm kết nối. |
/kg id ➔ Bot sẽ tự động trả về Group ID của nhóm đó ➔ Copy dán vào tab **Nhóm Zalo** trên Dashboard để đăng ký nhóm mới.
🍳 Cấu hình Phân Bếp & Set Menu
Cấu hình phân loại món ăn thuộc bếp nào để lệnh /kg tonghopmon và /kg tonghopbep tự động tách ảnh và tổng hợp theo từng khu vực bếp độc lập:
| Bếp Nướng Sashimi | Các món nướng, Sashimi, lẩu sống, BBQ... |
| Bếp Chiên Xào | Các món chiên, xào, hấp, cơm mì... và các món ngoài Menu. |
📟 Bộ Điều Khiển Bot & Theo Dõi Logs
Tab 🧪 Điều khiển Bot là trung tâm kiểm soát từ xa của bạn:
- Theo dõi WebSocket Zalo: Cho biết bot có đang kết nối ổn định với máy chủ Zalo hay không. Nếu báo
OFFLINEhoặc bị ngắt, bạn có thể khởi động lại Render. - Xem Logs trực tiếp (Live Logs): Cho phép bạn xem trực tiếp những dòng logs lỗi hoặc log tin nhắn đang chạy trên Render. Tuyệt đối không cần phải mở bảng điều khiển Render phức tạp!
- Phát tin nhắn khẩn cấp (Broadcast): Bạn có thể gõ nội dung thông báo và chọn nhóm cần phát tin, bấm Phát tin nhắn ngay để bot gửi tin nhắn vào nhóm Zalo hộ bạn.
🚑 Cẩm nang xử lý sự cố khẩn cấp (Troubleshooting)
| Hiện tượng | Nguyên nhân & Cách xử lý nhanh |
|---|---|
| Bot không phản hồi lệnh /kg ping? | Do máy chủ Render đang ở trạng thái ngủ (Sleep do không có request) hoặc đã bị ngắt kết nối WebSocket Zalo. Chờ 30 giây để bot tự thức dậy, hoặc kiểm tra tab "Điều khiển Bot" xem trạng thái là Online hay Offline. |
| Lỗi: "Lệnh không được hỗ trợ tại nhóm..." | Do nhóm Zalo của bạn chưa được tick chọn trong mục Cấu hình lệnh. Hãy vào Cấu hình lệnh ➔ Sửa lệnh tương ứng ➔ Tick chọn nhóm của bạn ➔ Lưu lại. |
| Lỗi: "Another connection is opened" | Đang có một phiên bản bot khác đăng nhập cùng tài khoản Zalo trên máy tính khác hoặc máy chủ Render cũ chưa kịp tắt hẳn. Hệ thống tự động Reconnect sẽ tự giải quyết trong vòng 10 giây. |
| Lỗi: "CORS Blocked" hoặc không tải được dữ liệu | Kiểm tra xem bạn đã cấu hình đúng GAS Web App URL và API Token chưa. Đảm bảo Apps Script đã được deploy phiên bản mới nhất! |