Module PrestaShop

Cập nhật lần cuối: 14 tháng 7, 2026

Module PrestaKick kết nối PrestaShop với PrestaKick, đồng bộ dữ liệu và hiển thị các tính năng dành cho khách trên website.

Mở phần quản lý module

Sau khi cài module, mở PrestaKick AI trong PrestaShop Back Office. Các mục chính gồm:

• Connection: kết nối cửa hàng và phân quyền dữ liệu.
• Widget: cấu hình khung chat.
• Features: bật tìm kiếm và gợi ý sản phẩm.
• Cron Jobs: cấu hình tác vụ định kỳ và xem nhật ký.
• AI Content và AI Translate: tạo hoặc dịch nội dung trong Back Office.
• Support: xem thông tin hỗ trợ.

Sau khi thay đổi cấu hình, chọn Save configuration. Nếu rời trang trước khi lưu, thay đổi sẽ không có hiệu lực.

Kết nối bằng OAuth

OAuth là cách kết nối được khuyến nghị:

1. Mở Connection.
2. Chọn Connect with PrestaKick.
3. Đăng nhập Dashboard nếu được yêu cầu.
4. Chọn đúng shop rồi chọn Confirm connection.
5. Quay lại module và kiểm tra trạng thái Connected.
6. Chọn Save configuration.

Hãy hoàn tất một lần kết nối trước khi mở quy trình OAuth mới. Liên kết OAuth có thời hạn và chỉ dùng được một lần.

Kết nối thủ công

Chỉ dùng Connect manually khi không thể kết nối bằng OAuth. Bạn cần nhập các giá trị do Dashboard cung cấp, gồm:

• PrestaKick URL
• Module Secret
• API Base URL
• Widget Key
• Shop ID
• API Widget URL

Trên cửa hàng thật, API phải trỏ đến https://api.prestakick.com và dịch vụ chat phải trỏ đến https://chat.prestakick.com.

Sau khi nhập, chọn Save configuration rồi Test connection.

Quyền đọc dữ liệu

Phần Store API Key cho phép PrestaKick yêu cầu dữ liệu từ cửa hàng. API Permissions quy định loại dữ liệu được đọc, chẳng hạn:

• Sản phẩm và danh mục.
• Khách hàng và đơn hàng.
• Giỏ hàng.
• Thông tin cửa hàng.
• Trang CMS.

Chỉ bật những loại dữ liệu cần dùng. Nếu tắt một quyền, các tính năng phụ thuộc vào loại dữ liệu đó có thể thiếu thông tin.

Khi tạo API Key mới, khóa cũ ngừng hoạt động. Chọn Save configuration ngay sau khi tạo và cập nhật các hệ thống đang dùng khóa cũ.

Bật tìm kiếm và gợi ý

Mở Features để quản lý:

• Image Search (Vision Search): tìm sản phẩm bằng hình ảnh.
• Semantic Search: tìm sản phẩm theo ý nghĩa.
• Display Related Products: hiển thị sản phẩm liên quan tại các vị trí được chọn.

Nếu trang hiển thị API connection required, hãy hoàn tất kết nối trước. Một số tính năng yêu cầu gói dịch vụ phù hợp; xem .

Cách dữ liệu được đồng bộ

Khi dữ liệu thay đổi trong PrestaShop, module đưa thay đổi vào hàng đợi. Cron xử lý hàng đợi và gửi dữ liệu sang PrestaKick.

Bạn cũng có thể yêu cầu đồng bộ lại từ trang Data sync trên Dashboard. Mỗi loại dữ liệu có giới hạn tần suất đồng bộ thủ công; nếu thấy thông báo giới hạn, hãy chờ đến thời điểm được phép thử lại.

Tình trạng kết nối

Connected chỉ xác nhận thông tin kết nối. Tình trạng ở bảng trên phản ánh hoạt động gần đây của module.

Thiết lập Cron Jobs

1. Mở Cron Jobs → Settings.
2. Sao chép lệnh hoặc URL do module cung cấp.
3. Thêm vào bộ lập lịch của hosting theo tần suất hiển thị trên màn hình.
4. Dùng Run now để chạy thử nếu cần.
5. Mở Cron Jobs → Logs để xem kết quả.

Không chia sẻ URL cron vì URL chứa mã bảo mật. Nếu nhật ký báo Unauthorized: invalid or missing cron token., hãy sao chép lại thông tin mới từ Settings và cập nhật trên hosting.

AI Content và AI Translate

AI Content hỗ trợ tạo nội dung. AI Translate hỗ trợ dịch nội dung sang ngôn ngữ khác. Mỗi nhóm có phần cài đặt và lịch sử riêng.

Hãy đọc lại nội dung do AI tạo trước khi đăng. Kiểm tra tên sản phẩm, thông số, chính sách và thuật ngữ thương hiệu.

Khi cần hỗ trợ

Gửi cho bộ phận hỗ trợ:

• Tên shop và tên miền cửa hàng.
• Ảnh chụp đầy đủ thông báo lỗi.
• Thời điểm xảy ra lỗi, kèm múi giờ.
• Trạng thái trong Connection và bản ghi liên quan trong Cron Jobs → Logs.

Không gửi Module Secret, API Key, Widget Key hoặc cron token.

Bước tiếp theo