Módulo PrestaShop
Última actualización:
Para administradores PrestaShop y responsables técnicos. Anterior: · Siguiente:
El módulo PrestaKick conecta PrestaShop con PrestaKick, sincroniza los datos y muestra las funciones orientadas al cliente en la página web.
Abre la sección de gestión de módulos
Después de instalar el módulo, abre PrestaKick AI en la PrestaShop Back Office. Las secciones principales son:
- Connection: conexión a la tienda y acceso a datos.
- Widget: configuración de tramas de chat.
- Features: activar la búsqueda y las sugerencias de productos.
- Cron Jobs: configurar tareas recurrentes y ver registros.
- AI Content y AI Translate: crear o traducir contenido en la Back Office.
- Support: ver información de soporte.
Después de cambiar la configuración, selecciona Save configuration. Si sales de la página antes de guardar, el cambio no tendrá efecto.
Conecta usando OAuth
OAuth es la forma recomendada de conectar:
- Abrir Connection.
- Selecciona Connect with PrestaKick.
- Iniciar sesión en el Panel de Control si es necesario.
- Selecciona la tienda adecuada y luego selecciona Confirm connection.
- Regresar al módulo y comprobar el estado Connected.
- Selecciona Save configuration.
Completa una conexión antes de abrir un nuevo flujo OAuth. Los enlaces OAuth tienen límite de tiempo y solo pueden usarse una vez.
Conexión manual
Usa Connect manually solo cuando no puedas conectar usando OAuth. Necesitas introducir los valores proporcionados por el Panel de Control, incluyendo:
- PrestaKick URL
- Module Secret
- API Base URL
- Widget Key
- Shop ID
- API Widget URL
Para una tienda activa, la API debe apuntar a https://api.prestakick.com y el servicio de chat a https://chat.prestakick.com.
Después de introducir, selecciona Save configuration y luego Test connection.
Permisos de acceso a datos
La sección Store API Key permite PrestaKick solicitar datos a la tienda. API Permissions especificar el tipo de datos que se van a leer, por ejemplo:
- Productos y categorías.
- Clientes y pedidos.
- Carrito de la compra.
- Guardar información.
- Páginas CMS.
Activa solo los tipos de datos que necesites. Si desactivas un permiso, pueden faltar funciones que dependen de ese tipo de datos.
Cuando creas una nueva clave de API, la clave antigua deja de funcionar. Selecciona Save configuration y luego actualiza cualquier sistema que aún use la clave antigua.
Habilitar búsqueda y sugerencias
Features abierto para gestionar:
- Image Search (Vision Search): buscar productos por imágenes.
- Semantic Search: encontrar productos por significado.
- Display Related Products: mostrar productos relacionados en ubicaciones seleccionadas.
Si la página muestra API connection required, completa la conexión primero. Algunas características requieren un plano adecuado; véase .
Cómo se sincronizan los datos
Cuando los datos cambian en PrestaShop, el módulo añade el cambio a una cola. Cron procesa la cola y envía los datos a PrestaKick.
También puedes solicitar una resincronización desde la página de Data sync en el Panel de Control. Cada tipo de dato tiene un límite manual de frecuencia de sincronización; Si ves un mensaje de límite, espera hasta que puedas intentarlo de nuevo.
Estado de la conexión
| Estado | Significado | Qué hacer |
|---|---|---|
| Healthy | Señal de actividad reciente y cola normal | No se requiere ninguna acción |
| Degraded | Señales antiguas o colas en crecimiento | Revisa el cron y los registros para ver si el estado persiste |
| Offline | No recibe señal reciente | Revisa el módulo, el cron y la conexión a Internet del servidor |
| Unknown | Datos de evaluación insuficientes | Espera unos minutos después de la primera conexión |
Connected solo confirma que los detalles de la conexión son válidos. Los estados anteriores reflejan la actividad reciente del módulo.
Configurar empleos cron
- Abrir trabajos → ajustes de cron.
- Copiar el comando o la URL proporcionada por el módulo.
- Añade al programador de tu hosting según la frecuencia que aparece en la pantalla.
- Usar Run now para una prueba si es necesario.
- Abre Cron Jobs → Logs para ver los resultados.
No compartas URLs cron porque contienen códigos de seguridad. Si los registros reportan Unauthorized: invalid or missing cron token., copia la nueva información del Settings y actualízala en el hosting.
Contenido con IA y traducción por IA
AI Content permite la creación de contenido. AI Translate permite la traducción a otros idiomas. Cada sección tiene sus propios escenarios e historia.
Revisa el contenido generado por IA antes de publicarlo. Consulta los nombres de los productos, especificaciones, políticas y terminología de marca.
Cuando se necesita apoyo
Envía a soporte:
- Nombre de la tienda y dominio de la tienda.
- Captura de pantalla completa del mensaje de error.
- Cuando ocurrió el error, con la zona horaria.
- Estado en la Connection y registros relacionados en Cron Jobs → Logs.
No envíes secretos de módulo, claves API, claves widget ni tokens cron.