Khắc phục sự cố
Cập nhật lần cuối:
Dành cho người vận hành cửa hàng và người phụ trách kỹ thuật.
Trước:
Tìm đúng thông báo đang hiển thị, sau đó thực hiện lần lượt các bước trong bảng. Tên thông báo được giữ nguyên tiếng Anh để dễ đối chiếu.
Kiểm tra nhanh
Trước khi xử lý chi tiết:
- Kiểm tra đang thao tác trên đúng shop.
- Mở PrestaKick AI → Connection trong module.
- Kiểm tra trạng thái Connected.
- Nếu vừa thay đổi cấu hình, chọn Save configuration.
- Mở Cron Jobs → Logs và kiểm tra lần chạy gần nhất.
- Trên Dashboard, kiểm tra trạng thái Healthy, Degraded, Offline hoặc Unknown.
- Thử lại bằng cửa sổ ẩn danh để loại trừ dữ liệu cũ trong trình duyệt.
Lỗi kết nối module
| Thông báo hoặc hiện tượng | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
| API connection required | Module chưa kết nối hoặc không gọi được API | Mở Connection, kết nối lại và chọn Save configuration |
| Not connected | Chưa hoàn tất OAuth hoặc đã ngắt kết nối | Chọn Connect with PrestaKick, chọn đúng shop và xác nhận |
| Connected nhưng Features vẫn báo lỗi | Thông tin chưa lưu, URL sai hoặc máy chủ không gọi được Internet | Lưu cấu hình, kiểm tra https://api.prestakick.com, rồi dùng Test connection |
| Connection failed / Connection test failed | Thiếu thông tin hoặc API không truy cập được | Kiểm tra Module Secret, API Base URL, Shop ID và kết nối mạng |
| Invalid API Base URL format | URL sai định dạng |
Không gửi Module Secret hoặc API Key trong yêu cầu hỗ trợ.
Lỗi OAuth
| Thông báo | Cách xử lý |
|---|---|
| Invalid connection request | Đóng trang hiện tại và bắt đầu lại bằng Connect with PrestaKick trong module |
| OAuth connection token has expired | Bắt đầu lại từ module; liên kết cũ đã hết hạn |
| OAuth connection token has already been used | Không mở lại liên kết cũ; tạo một quy trình kết nối mới |
| Shop is already connected to another PrestaShop URL | Kiểm tra URL cũ và mới trước khi chọn kết nối lại |
| Only the shop owner can connect this shop | Đăng nhập bằng tài khoản owner hoặc nhờ owner thực hiện |
| No unconnected shops | Tạo shop mới hoặc chọn kết nối lại shop hiện có nếu đúng mục đích |
Chỉ mở một quy trình OAuth tại một thời điểm.
Module Offline hoặc đồng bộ thiếu dữ liệu
| Hiện tượng | Cách xử lý |
|---|---|
| Module báo Offline | Kiểm tra module đang bật, cron đang chạy và máy chủ có Internet |
| Module báo Degraded | Mở Cron Jobs → Logs, kiểm tra lỗi lặp và hàng đợi; theo dõi xem trạng thái có phục hồi không |
| Module báo Unknown sau khi mới kết nối | Chờ vài phút và chạy thử cron |
| Dữ liệu trên Dashboard cũ hoặc thiếu | Kiểm tra trạng thái module rồi mở Data sync để yêu cầu đồng bộ lại |
| Manual sync is rate limited to once per hour per entity type | Chờ hết thời gian giới hạn trước khi chạy lại loại dữ liệu đó |
| Công việc đồng bộ báo Failed | Mở chi tiết để xem lý do, xử lý nguyên nhân rồi chạy lại |
| Unauthorized: Invalid or missing API Key | Kiểm tra Store API Key, chọn Save configuration hoặc kết nối lại bằng OAuth |
| Unauthorized: invalid or missing cron token. | Sao chép lại cron token từ Cron Jobs → Settings và cập nhật trên hosting |
Widget không hiển thị
Kiểm tra theo thứ tự:
- Show Widget đã bật, hoặc IP thử nghiệm nằm trong Preview IPs.
- Đã chọn Save configuration.
- Tên miền hiện tại nằm trong Allowed storefront domains.
- Module không ở trạng thái Offline.
- Trình duyệt không dùng bản JavaScript cũ; thử tải lại mạnh hoặc cửa sổ ẩn danh.
- Nếu kiểm tra trên điện thoại, Show on Mobile đã bật.
| Thông báo | Cách xử lý |
|---|---|
| Widget origin is not allowed for this shop | Owner thêm đúng tên miền tại Settings → Domains & Access, sau đó chọn Save rules |
| Invalid widget key | Kết nối lại OAuth hoặc cập nhật Widget Key mới trong cấu hình đang dùng |
| Failed to save widget configuration | Kiểm tra kết nối, quyền và giới hạn gói; sau đó lưu lại |
| Upgrade to Starter or higher to allow image uploads | Nâng lên Starter trở lên hoặc tắt Allow image uploads |
Chat và trợ lý AI
| Thông báo hoặc hiện tượng | Cách xử lý |
|---|---|
| Chat mở nhưng AI không trả lời | Kiểm tra hạn mức, trạng thái module, dữ liệu đồng bộ và thông báo dịch vụ |
| You are sending messages too fast... | Chờ vài giây rồi gửi lại |
| AI credits have been exhausted | Owner mua thêm credits, nâng gói hoặc chờ kỳ hạn mức mới |
| Too many requests. Please try again later | Chờ rồi thử lại; nếu xảy ra thường xuyên với lưu lượng thật, liên hệ hỗ trợ |
| Service is temporarily unavailable | Thử lại sau; nhân viên có thể tiếp quản hội thoại nếu Chat inbox vẫn hoạt động |
| Trợ lý trả lời chung chung | Kiểm tra mô tả sản phẩm, trang chính sách, đồng bộ và Assistant instructions |
| Message could not be sent. | Kiểm tra kết nối và thử lại |
| Could not send the image. | Kiểm tra định dạng, kích thước ảnh và quyền tải ảnh của gói |
Đăng nhập và bảo mật
| Thông báo | Cách xử lý |
|---|---|
| Invalid credentials | Kiểm tra email, mật khẩu và Caps Lock; dùng Forgot password nếu cần |
| Account is not verified | Mở email xác minh hoặc yêu cầu gửi lại liên kết |
| Account is suspended or locked | Liên hệ bộ phận hỗ trợ qua kênh chính thức |
| TOTP code is required | Nhập mã sáu số từ ứng dụng xác thực |
| TOTP code is invalid | Chờ mã mới và kiểm tra đồng hồ điện thoại đang tự động cập nhật |
| Refresh token has expired | Đăng nhập lại Dashboard |
| Không hoàn tất thao tác nhạy cảm | Kiểm tra vai trò và hoàn tất bước xác thực lại |
| You need an active shop membership... | Kiểm tra shop đang chọn và trạng thái thành viên |
Nếu mất thiết bị xác thực, dùng recovery code chưa sử dụng. Không gửi mã TOTP hoặc recovery code cho người khác.
Gói cước và hạn mức
| Thông báo | Cách xử lý |
|---|---|
| Image search is not available on the current plan | Nâng lên Starter trở lên hoặc tắt tính năng |
| Recommendations are not available on the current plan | Nâng lên Launch trở lên hoặc tắt gợi ý sản phẩm |
| The monthly recommendation request quota has been reached | Chờ kỳ mới hoặc nâng gói |
| Current usage exceeds the selected plan limits | Giảm mức sử dụng xuống dưới giới hạn hoặc chọn gói khác |
| Your current plan does not allow connecting another shop | Nâng gói hoặc sử dụng một shop trong giới hạn hiện tại |
| Image storage quota exceeded | Xóa dữ liệu không cần thiết nếu có tùy chọn phù hợp, hoặc nâng gói |
Khi cần liên hệ hỗ trợ
Chuẩn bị:
- Tên shop và tên miền website.
- Ảnh chụp đầy đủ thông báo lỗi.
- Thời điểm xảy ra, kèm múi giờ.
- Các bước vừa thực hiện.
- Lỗi xảy ra với mọi người hay chỉ một tài khoản, thiết bị hoặc IP.
- Bản ghi liên quan trong Cron Jobs → Logs, nếu có.
Không gửi mật khẩu, mã TOTP, recovery code, Module Secret, API Key, Widget Key hoặc cron token.