Installer Dialog sur Prestashop

Ce guide couvre tout le flow d’install pour les merchants Prestashop. À la fin tu auras l’assistant Dialog actif sur tes pages produit avec ton catalogue synchronisé automatiquement.

Prérequis

• Accès admin à ton back office Prestashop.
• Un compte Dialog sur app.askdialog.com/sign-up.

Étape 1 : crée ton organisation Dialog

1. Inscris-toi sur app.askdialog.com/sign-up.
2. Pendant l’onboarding, choisis Prestashop comme plateforme e-commerce.
3. Donne un nom à ton organisation. Dialog génère une clé API publique et une clé API privée.

Garde les deux visibles — tu vas les coller dans le module Prestashop à l’étape 3.

Étape 2 : installe le module Dialog sur Prestashop

1. Télécharge le module Dialog Prestashop (fichier .zip) depuis le lien dans ton écran d’onboarding.
2. Dans ton back office Prestashop, va dans Modules → Gestionnaire de modules → Installer un module.
3. Dépose le .zip. Prestashop l’installe et l’enregistre.
4. Ouvre le module et clique sur Configurer.

Étape 3 : connecte le module à ton organisation Dialog

Dans l’écran d’admin du module :

1. Colle ta clé API publique dans le champ correspondant.
2. Colle ta clé API privée dans le champ correspondant.
3. Enregistre.

Le module est maintenant authentifié. Sous le capot, il expose une route interne que Dialog appelle pendant l’import du catalogue.

Étape 4 : finalise l’onboarding dans Dialog

De retour sur le dashboard Dialog :

1. Ajoute tes guidelines (10 à 15 règles courtes — voir Rédiger de bonnes guidelines).
2. Upload toute la documentation produit que tu veux faire connaître à l’assistant (guides de tailles, fiches d’ingrédients, politiques de retour — voir Entraîner Dialog).
3. Clique sur Save.

Ce qui se passe au moment du Save

Quand tu cliques sur Save, Dialog déclenche son pipeline d’import :

1. La Lambda StartImport de Dialog appelle la route exposée par ton module Prestashop.
2. Le module génère les fichiers JSON catalogue et contenu (catalog.json, pages.json).
3. Le module upload ces fichiers sur le bucket S3 de Dialog, authentifié par ta clé API privée.
4. La state machine d’import Dialog les mappe vers le schéma canonique, puis indexe les données dans le product store et le vector store.

Tu reçois un 200 OK rapide, puis l’ingestion tourne en async.

Combien de temps prend l’import

Taille du catalogue	Délai attendu
Jusqu’à quelques centaines de produits	De quelques secondes à quelques minutes
Quelques milliers de produits	Quelques minutes
20k+ produits	Plusieurs dizaines de minutes

Étape 5 : vérifie

Une fois l’import terminé, va sur ton storefront et ouvre une page produit. Le widget Dialog doit apparaître.

Parcours Vérifier ton installation pour confirmer que tout marche de bout en bout.

Troubleshooting

Problème	Cause probable	Solution
Le module affiche “API keys invalid”	Clés copiées avec un espace ou public/private inversées	Recolle les deux clés en vérifiant laquelle est laquelle
Save côté Dialog renvoie un 502	Route du module inaccessible (firewall, IP interne)	Vérifie que ton Prestashop est joignable publiquement et que le module est activé
Les fichiers catalogue n’apparaissent pas côté Dialog	Le module ne les a pas générés (erreur PHP pendant l’export)	Regarde les logs Prestashop et écris à support@askdialog.com avec l’operationId retourné par le statut d’import
Le widget n’apparaît pas sur les PDP	Module activé mais le thème override un ou plusieurs hooks que le module enregistre	Ton dev doit brancher les mêmes hooks que notre module. Le module Dialog enregistre : actionFrontControllerSetMedia (charge les assets du widget), displayProductAdditionalInfo (rend le widget sur la PDP), displayFooterAfter (rendering de fallback), displayOrderConfirmation (tracking purchase), actionCartUpdateQuantityBefore (events panier). Réimplémente les mêmes display hooks dans l’override de thème, ou supprime l’override

Besoin d’aide ?

Écris à support@askdialog.com avec le nom de ton organisation et le souci.