Instalar Dialog en Prestashop

Esta guía cubre el flow de instalación completo para merchants Prestashop. Al final tendrás el asistente Dialog activo en tus páginas de producto con tu catálogo sincronizado automáticamente.

Prerrequisitos

• Acceso admin a tu back office de Prestashop.
• Una cuenta Dialog en app.askdialog.com/sign-up.

Paso 1: crea tu organización Dialog

1. Regístrate en app.askdialog.com/sign-up.
2. Durante el onboarding, elige Prestashop como plataforma de e-commerce.
3. Dale un nombre a tu organización. Dialog genera una API key pública y una API key privada.

Mantén ambas a la vista, vas a pegarlas en el módulo Prestashop en el paso 3.

Paso 2: instala el módulo Dialog en Prestashop

1. Descarga el módulo Dialog Prestashop (archivo .zip) desde el link en tu pantalla de onboarding.
2. En tu back office de Prestashop, ve a Módulos → Gestor de módulos → Subir un módulo.
3. Suelta el .zip. Prestashop lo instala y lo registra.
4. Abre el módulo y haz clic en Configurar.

Paso 3: conecta el módulo a tu organización Dialog

En la pantalla de admin del módulo:

1. Pega tu API key pública en el campo correspondiente.
2. Pega tu API key privada en el campo correspondiente.
3. Guarda.

El módulo está autenticado. Por debajo, expone una ruta interna que Dialog llama durante el import del catálogo.

Paso 4: termina el onboarding en Dialog

De vuelta en el dashboard Dialog:

1. Añade tus guidelines (de 10 a 15 reglas cortas: ver Guías por sector para plantillas listas para usar).
2. Sube toda la documentación de producto que quieras que el asistente conozca (guías de talla, fichas de ingredientes, políticas de devolución: ver Entrenar Dialog).
3. Haz clic en Save.

Qué pasa cuando guardas

Cuando haces clic en Save, Dialog dispara su pipeline de import:

1. La Lambda StartImport de Dialog llama a la ruta que tu módulo Prestashop expone.
2. El módulo genera los archivos JSON de catálogo y contenido (catalog.json, pages.json).
3. El módulo sube esos archivos al bucket S3 de Dialog, autenticado con tu API key privada.
4. La state machine de import de Dialog los mapea al schema canónico y luego indexa los datos en el product store y el vector store.

Recibes un 200 OK rápido y la ingesta corre en async.

Cuánto tarda el import

Tamaño del catálogo	Tiempo esperado
Hasta unos cientos de productos	De unos segundos a un par de minutos
Unos miles de productos	Unos minutos
20k+ productos	Decenas de minutos

Paso 5: verifica

Una vez completado el import, ve a tu storefront y abre una página de producto. El widget Dialog debe aparecer.

Recorre Verificar la instalación para confirmar que todo funciona de extremo a extremo.

Comprueba que Dialog puede acceder a tu tienda

Dialog importa tu catálogo llamando a tu tienda desde sus propios servidores, por HTTPS: no desde tu navegador. Una tienda que se carga perfectamente para ti puede seguir siendo inaccesible para Dialog.

Antes de terminar el onboarding, comprueba que:

• Tu tienda se sirve por HTTPS en un dominio resoluble públicamente.
• El certificado TLS corresponde a ese dominio exacto. Un certificado emitido para otro dominio, el de un hosting compartido, por ejemplo, se rechaza.
• El endpoint del módulo responde: https://tu-tienda.com/module/askdialog/api?action=getLanguageData debe devolver JSON, no una página de mantenimiento ni un error.

Tiendas de staging y tiendas no accesibles públicamente

Las tiendas de test o preproducción suelen estar protegidas por el modo mantenimiento de Prestashop, autenticación HTTP Basic, una contraseña o una restricción por IP. Dialog recibe entonces una página de mantenimiento (HTTP 503) o un 401/403 en lugar de la respuesta del módulo, y el import falla.

Dos formas de resolverlo:

• Deja pasar los servidores de Dialog. Mantén la tienda restringida y añade la dirección IP de salida de Dialog a la lista de autorizadas: en Prestashop es Parámetros de la tienda → General → Mantenimiento → IP de mantenimiento (lista separada por comas). Pide la dirección a usar a support@askdialog.com. No uses tu propia IP, la de tu oficina o la de tu agencia: no son las direcciones desde las que Dialog se conecta.
• O abre únicamente los endpoints del módulo. Deja el resto de la tienda protegido y autoriza /module/askdialog/feed y /module/askdialog/api. Ambos exigen tu API key privada, así que abrirlos no expone tu tienda.

Si después de esto el endpoint sigue devolviendo una página de mantenimiento o un 401/403, ese es el bloqueo a corregir antes de reintentar el onboarding.

Recuperar un onboarding cuando se saltó el paso del módulo

Si tu organización Dialog se creó pero el módulo Prestashop nunca se conectó, guardar el onboarding o elegir un plan falla.

Síntomas:

• Guardar el onboarding o seleccionar un plan devuelve PRESTASHOP_ORGANIZATION_NOT_FOUND.
• Volver a crear la organización devuelve ORGANIZATION_ALREADY_REGISTERED.

La organización existe, pero todavía no tiene ninguna conexión Prestashop asociada: se saltó el paso del módulo y las API keys (pasos 2 y 3 anteriores).

No vuelvas a crear la organización. Ya existe, así que un segundo intento fallará siempre con ORGANIZATION_ALREADY_REGISTERED. Tampoco es un problema de facturación ni de plan, cambiar de plan no ayudará.

Para recuperarlo:

1. Vuelve al paso de conexión Prestashop de tu onboarding en lugar de crear una organización nueva.
2. Instala y configura el módulo con tus API keys pública y privada (pasos 2 y 3).
3. Comprueba que tu tienda es accesible, ver Comprueba que Dialog puede acceder a tu tienda.
4. Reintenta guardar el onboarding y seleccionar tu plan.

Si no consigues volver al paso de conexión Prestashop, escribe a support@askdialog.com con el nombre de tu organización y podemos reabrirte el paso.

Troubleshooting

Problema	Causa probable	Solución
El módulo muestra “API keys invalid”	Keys copiadas con espacios o públicas/privadas intercambiadas	Vuelve a pegar ambas keys verificando cuál es cuál
El onboarding falla con PRESTASHOP_ORGANIZATION_NOT_FOUND	Organización creada pero módulo nunca conectado	Ver Recuperar un onboarding cuando se saltó el paso del módulo
El import falla y el endpoint del módulo devuelve una página de mantenimiento o un 401/403	Tienda en modo mantenimiento, protegida por contraseña o restringida por IP	Ver Tiendas de staging y tiendas no accesibles públicamente
Save en Dialog devuelve un 502	Ruta del módulo inaccesible (firewall, IP interna)	Verifica que tu Prestashop es accesible públicamente y que el módulo está activado
Los archivos de catálogo no aparecen en Dialog	El módulo no los generó (error PHP durante el export)	Revisa los logs de Prestashop y escribe a paul@askdialog.com con el operationId que muestra el estado del import
El widget no aparece en las PDP	Módulo activado pero el theme override uno o más hooks que el módulo registra	Tu developer debe enganchar los mismos hooks que nuestro módulo. El módulo Dialog registra: actionFrontControllerSetMedia (carga los assets del widget), displayProductAdditionalInfo (renderiza el widget en la PDP), displayFooterAfter (renderizado de fallback), displayOrderConfirmation (tracking del purchase), actionCartUpdateQuantityBefore (eventos del carrito). Reimplementa los mismos display hooks en el override del theme, o quita el override

¿Necesitas ayuda?

Escribe a paul@askdialog.com con el nombre de tu organización y el problema.