📋 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 AI (Multi-Provider)
🔐 CukCuk POS
💬 Đăng nhập Zalo Bot (Session Cookie)
📢 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)
📖 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)
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. Hãy làm chính xác theo 6 bước dưới đây trên trình duyệt máy tính của bạn:
Truy cập chat.zalo.me trên trình duyệt máy tính (Chrome/Edge) và đăng nhập tài khoản Zalo của Bot.
Nhấn phím F12 (hoặc Ctrl + Shift + I, trên Mac dùng Cmd + Option + I) ➔ Chọn tab Application (Ứng dụng) ở thanh công cụ phía trên.
Trong cột bên trái của tab Application, mở rộng mục Cookies ➔ Click chọn dòng https://chat.zalo.me. Tìm và copy giá trị của 2 khóa sau:
| zpsid | Giá trị dạng chuỗi dài. Copy và dán vào ô zpsid trên Dashboard. |
| zpw_sek | Giá trị dạng chuỗi dài. Copy và dán vào ô zpw_sek trên Dashboard. |
Vẫn trong tab Application của F12, mở rộng mục Local Storage (Bộ nhớ cục bộ) ở bên trái ➔ Click chọn dòng https://chat.zalo.me. Tìm khóa có tên là z_uuid. Copy chính xác giá trị của nó (VD: 2a5cd4a7-b040...) và dán vào ô IMEI trên Dashboard.
Chuyển sang tab Console trong bảng F12 ➔ Gõ lệnh dưới đây và nhấn Enter ➔ Copy chuỗi kết quả thu được dán vào ô User-Agent trên Dashboard:
Bấm 💾 Lưu Zalo Session trên Dashboard. Sau đó, truy cập trang quản lý Render Bot của bạn và bấm Restart Service để bot tiến hành đăng nhập bằng session mới.
👥 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! |