Installer Dialog sur Prestashop

Ce guide couvre tout le flow d’install pour les merchants Prestashop. À la fin vous aurez l’assistant Dialog actif sur vos pages produit avec votre catalogue synchronisé automatiquement.

Prérequis

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

Étape 1 : créez votre organisation Dialog

1. Inscrivez-vous sur app.askdialog.com/sign-up.
2. Pendant l’onboarding, choisissez Prestashop comme plateforme e-commerce.
3. Donnez un nom à votre organisation. Dialog génère une clé API publique et une clé API privée.

Gardez les deux visibles : vous allez les coller dans le module Prestashop à l’étape 3.

Étape 2 : installez le module Dialog sur Prestashop

1. Téléchargez le module Dialog Prestashop (fichier .zip) depuis le lien dans votre écran d’onboarding.
2. Dans votre back office Prestashop, allez dans Modules → Gestionnaire de modules → Installer un module.
3. Déposez le .zip. Prestashop l’installe et l’enregistre.
4. Ouvrez le module et cliquez sur Configurer.

Étape 3 : connectez le module à votre organisation Dialog

Dans l’écran d’admin du module :

1. Collez votre clé API publique dans le champ correspondant.
2. Collez votre clé API privée dans le champ correspondant.
3. Enregistrez.

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

Étape 4 : finalisez l’onboarding dans Dialog

De retour sur le dashboard Dialog :

1. Ajoutez vos guidelines (10 à 15 règles courtes : voir Guides par secteur pour des templates prêts à l’emploi).
2. Uploadez toute la documentation produit que vous voulez faire connaître à l’assistant (guides de tailles, fiches d’ingrédients, politiques de retour : voir Entraîner Dialog).
3. Cliquez sur Save.

Ce qui se passe au moment du Save

Quand vous cliquez sur Save, Dialog déclenche son pipeline d’import :

1. La Lambda StartImport de Dialog appelle la route exposée par votre 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 votre 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.

Vous recevez 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érifiez

Une fois l’import terminé, allez sur votre storefront et ouvrez une page produit. Le widget Dialog doit apparaître.

Parcourez Vérifier votre installation pour confirmer que tout marche de bout en bout.

Vérifiez que Dialog peut joindre votre boutique

Dialog importe votre catalogue en appelant votre boutique depuis ses propres serveurs, en HTTPS : pas depuis votre navigateur. Une boutique qui s’affiche très bien chez vous peut rester injoignable pour Dialog.

Avant de finaliser l’onboarding, vérifiez que :

• Votre boutique est servie en HTTPS sur un domaine résolvable publiquement.
• Le certificat TLS correspond à ce domaine exact. Un certificat émis pour un autre domaine (celui d’un hébergement mutualisé, par exemple) est rejeté.
• L’endpoint du module répond : https://votre-boutique.com/module/askdialog/api?action=getLanguageData doit renvoyer du JSON, pas une page de maintenance ni une erreur.

Boutiques de staging et boutiques non accessibles publiquement

Les boutiques de test ou de préproduction sont souvent protégées par le mode maintenance de Prestashop, une authentification HTTP Basic, un mot de passe ou une restriction par IP. Dialog reçoit alors une page de maintenance (HTTP 503) ou un 401/403 au lieu de la réponse du module, et l’import échoue.

Deux façons de régler ça :

• Laissez passer les serveurs de Dialog. Gardez la boutique restreinte et ajoutez l’adresse IP de sortie de Dialog à la liste d’autorisation : dans Prestashop c’est Paramètres de la boutique → Général → Maintenance → IP de maintenance (liste séparée par des virgules). Demandez l’adresse à utiliser à support@askdialog.com. N’utilisez pas votre propre IP, celle de votre bureau ou de votre agence : ce ne sont pas les adresses depuis lesquelles Dialog se connecte.
• Ou n’ouvrez que les endpoints du module. Laissez le reste de la boutique protégé et autorisez /module/askdialog/feed et /module/askdialog/api. Les deux exigent votre clé API privée, donc les ouvrir n’expose pas votre boutique.

Si après ça l’endpoint renvoie encore une page de maintenance ou un 401/403, c’est le blocage à corriger avant de relancer l’onboarding.

Récupérer un onboarding quand l’étape du module a été sautée

Si votre organisation Dialog a été créée mais que le module Prestashop n’a jamais été connecté, l’enregistrement de l’onboarding ou le choix d’un plan échoue.

Symptômes :

• L’enregistrement de l’onboarding ou le choix d’un plan renvoie PRESTASHOP_ORGANIZATION_NOT_FOUND.
• Recréer l’organisation renvoie ORGANIZATION_ALREADY_REGISTERED.

L’organisation existe, mais aucune connexion Prestashop n’y est encore rattachée : l’étape du module et des clés API (étapes 2 et 3 ci-dessus) a été sautée.

Ne recréez pas l’organisation. Elle existe déjà, donc une deuxième tentative échouera toujours avec ORGANIZATION_ALREADY_REGISTERED. Ce n’est pas non plus un problème de facturation ou de plan : changer de plan n’y changera rien.

Pour récupérer :

1. Revenez à l’étape de connexion Prestashop de votre onboarding plutôt que de créer une nouvelle organisation.
2. Installez et configurez le module avec vos clés API publique et privée (étapes 2 et 3).
3. Vérifiez que votre boutique est joignable : voir Vérifiez que Dialog peut joindre votre boutique.
4. Relancez l’enregistrement de l’onboarding et le choix du plan.

Si vous n’arrivez pas à revenir à l’étape de connexion Prestashop, écrivez à support@askdialog.com avec le nom de votre organisation : l’étape peut être rouverte pour vous.

Troubleshooting

Problème	Cause probable	Solution
Le module affiche “API keys invalid”	Clés copiées avec un espace ou public/private inversées	Recollez les deux clés en vérifiant laquelle est laquelle
L’onboarding échoue avec PRESTASHOP_ORGANIZATION_NOT_FOUND	Organisation créée mais module jamais connecté	Voir Récupérer un onboarding quand l’étape du module a été sautée
L’import échoue et l’endpoint du module renvoie une page de maintenance ou un 401/403	Boutique en mode maintenance, protégée par mot de passe ou restreinte par IP	Voir Boutiques de staging et boutiques non accessibles publiquement
Save côté Dialog renvoie un 502	Route du module inaccessible (firewall, IP interne)	Vérifiez que votre 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)	Regardez les logs Prestashop et écrivez à paul@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	Votre 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émentez les mêmes display hooks dans l’override de thème, ou supprimez l’override

Besoin d’aide ?

Écrivez à paul@askdialog.com avec le nom de votre organisation et le souci.