Solución de problemas
Problemas comunes y soluciones para el módulo AI SmartTalk de PrestaShop.
Instalación
El módulo no se instala
- Verifica tu versión de PrestaShop: El módulo requiere PrestaShop 8 o 9
- Verifica la memoria del servidor: Asegúrate de que tu servidor tenga suficiente memoria para instalar módulos
- Verifica los permisos de archivos: El directorio
modules/debe ser escribible por el servidor web - Desactiva módulos en conflicto: Intenta desactivar otros módulos temporalmente si hay conflictos
El módulo se instaló pero no aparece en el menú
- Limpia la caché de PrestaShop: Parámetros Avanzados > Rendimiento > Limpiar caché
- Intenta cerrar sesión y volver a iniciar sesión en tu administración de PrestaShop
Conexión
El botón "Conectar con AI SmartTalk" no funciona
- Verifica HTTPS saliente: Tu servidor debe permitir conexiones HTTPS salientes a
aismarttalk.tech - Verifica bloqueadores de ventanas emergentes: El flujo de OAuth se abre en una nueva ventana; asegúrate de que tu navegador no lo esté bloqueando
- Verifica tu firewall: Asegúrate de que los puertos 443 (HTTPS) no estén bloqueados
La conexión redirige pero no pasa nada
- El token de OAuth es válido por 10 minutos. Si esperaste demasiado, intenta desconectar y volver a conectar
- Limpia las cookies de tu navegador y vuelve a intentarlo
Multi-sitio: un sitio aparece como "Desconectado"
- Cada sitio necesita su propia conexión OAuth. Ve a la instancia de PrestaShop afectada y haz clic en Conectar nuevamente
- Asegúrate de que cada sitio tenga un nombre de dominio o puerto distinto
Chatbot
El chatbot no aparece en mi tienda
- Verifica el estado del módulo: Asegúrate de que el chatbot esté habilitado en la pestaña Chatbot del módulo
- Verifica la selección del asistente: Asegúrate de que un asistente de IA esté seleccionado y guardado
- Verifica la conexión: El módulo debe estar conectado a AI SmartTalk (insignia de estado verde)
- Limpia las cachés: Limpia tanto la caché de PrestaShop (Parámetros Avanzados > Rendimiento) como la caché de tu navegador
- Verifica la posición del hook: Intenta cambiar entre "Pie de página" y "Antes del pie de página" en la configuración de Apariencia
El chatbot aparece pero no responde
- Verifica que tu suscripción a AI SmartTalk esté activa
- Asegúrate de que el asistente seleccionado esté correctamente configurado en tu panel de control de AI SmartTalk
- Revisa la consola de desarrollador de tu navegador en busca de errores de JavaScript
API y acciones de IA
Las acciones de IA fallan con "permiso denegado" o "no autorizado"
- Verifica tu clave de Webservice: Asegúrate de que esté habilitada y tenga los permisos correctos (ver Permisos de API)
- Verifica que la clave esté ingresada: El token de Webservice debe ser transmitido durante la conexión OAuth. Si falta, actualízalo en tu panel de control de AI SmartTalk en la configuración de integración de PrestaShop
Las actualizaciones de productos no funcionan
- Asegúrate de que
productstenga permisos GET y PUT en tu clave de Webservice - Verifica que el ID del producto exista y que el producto no esté bloqueado por otro módulo
Los cambios de estado de pedido fallan
- Asegúrate de que
order_historiestenga permisos GET y POST - Verifica que el ID del estado del pedido sea válido para tu tienda (los IDs de estado varían según la configuración de PrestaShop)
La búsqueda de clientes no devuelve resultados
- Asegúrate de que
customerstenga permiso GET - Verifica que la dirección de correo electrónico sea correcta y coincida con un cliente existente
Sincronización
La sincronización de productos no comienza o falla
- Verifica la configuración de tiempo de espera de PHP de tu servidor: los catálogos grandes pueden necesitar más tiempo
- Verifica que tu conexión a Internet sea estable
- Revisa los registros de errores de PrestaShop en Parámetros Avanzados > Registros
Solo algunos productos se sincronizan
- Verifica si los filtros de sincronización están activos (aparece una insignia "Filtrado" en la pestaña Sincronizar)
- Revisa los filtros de categoría y tipo de producto para asegurarte de que coincidan con tus expectativas
La sincronización de clientes no funciona
- Asegúrate de que la sincronización de clientes esté habilitada en la pestaña Sincronizar
- Los clientes se exportan en lotes de 50; las bases de datos grandes pueden tardar varios minutos
Webhooks
Los webhooks no se activan
- Verifica que los activadores de webhook estén habilitados en la pestaña Webhooks
- Asegúrate de que tu servidor permita solicitudes HTTP salientes a AI SmartTalk
- Asegúrate de tener un flujo de trabajo SmartFlow configurado para recibir el activador del webhook
- Revisa los registros de PrestaShop en busca de errores durante la ejecución del hook
Los webhooks se activan pero no pasa nada en SmartFlow
- Verifica que tu flujo de trabajo SmartFlow esté publicado y activo
- Asegúrate de que el tipo de activador del flujo de trabajo coincida con el evento de webhook de PrestaShop
- Revisa los registros de ejecución de SmartFlow en tu panel de control de AI SmartTalk
Rendimiento
El módulo ralentiza mi tienda
- Desactiva los activadores de webhook no utilizados para reducir las solicitudes salientes
- Asegúrate de que la caché esté funcionando correctamente: el módulo utiliza una caché incorporada para la configuración de incrustación
- Verifica que tu servidor tenga recursos adecuados (CPU, memoria)
La administración es lenta después de instalar el módulo
- El módulo solo se ejecuta en su propia página de configuración y en hooks específicos; no debería afectar el rendimiento general de la administración
- Si experimentas problemas, verifica si hay conflictos con otros módulos
¿Aún necesitas ayuda?
Si tu problema no está cubierto aquí:
- Revisa el panel de control de AI SmartTalk en busca de mensajes de error o alertas
- Revisa los registros de errores de PrestaShop (Parámetros Avanzados > Registros)
- Contacta a nuestro equipo de soporte en contact+support@aismarttalk.tech