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 Escribir buenas directrices).
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.

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
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 support@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 support@askdialog.com con el nombre de tu organización y el problema.