Install Dialog on Prestashop

This guide covers the full install flow for Prestashop merchants. By the end you’ll have the Dialog assistant running on your product pages with your catalog automatically synced.

Prerequisites

• Admin access to your Prestashop back office.
• A Dialog account at app.askdialog.com/sign-up.

Step 1: Create your Dialog organization

1. Sign up at app.askdialog.com/sign-up.
2. During onboarding, pick Prestashop as your e-commerce platform.
3. Give your organization a name. Dialog generates a public API key and a private API key for it.

Keep both keys visible — you’ll paste them into the Prestashop module in Step 3.

Step 2: Install the Dialog module on Prestashop

1. Download the Dialog Prestashop module (.zip file) from the link in your onboarding screen.
2. In your Prestashop back office, go to Modules → Module Manager → Upload a module.
3. Drop the .zip file. Prestashop installs and registers it.
4. Open the module and click Configure.

Step 3: Connect the module to your Dialog organization

In the module’s admin screen:

1. Paste your public API key in the corresponding field.
2. Paste your private API key in the corresponding field.
3. Save.

The module is now authenticated. Behind the scenes it exposes an internal route that Dialog calls during catalog import.

Step 4: Finish onboarding in Dialog

Back in the Dialog dashboard:

1. Add your guidelines (10 to 15 short rules — see Writing good guidelines).
2. Upload any product documentation you want the assistant to know about (size guides, ingredient sheets, return policies — see Train Dialog).
3. Click Save.

What happens when you save

When you click Save, Dialog triggers its import pipeline:

1. Dialog’s StartImport Lambda calls the route your Prestashop module exposes.
2. The module generates the catalog and content JSON files (catalog.json, pages.json).
3. The module uploads those files to Dialog’s S3 bucket, authenticated by your private API key.
4. Dialog’s import state machine maps them into the canonical schema, then indexes the data into the product store and the vector store.

You get a quick 200 OK back, then ingestion runs asynchronously.

How long the import takes

Catalog size	Expected time
Up to a few hundred products	A few seconds to a couple of minutes
A few thousand products	A few minutes
20k+ products	Tens of minutes

Step 5: Verify

Once the import completes, go to your storefront and open a product page. The Dialog widget should appear.

Run through Verify your install to confirm everything works end to end.

Troubleshooting

Issue	Likely cause	Solution
Module shows “API keys invalid”	Keys copied with whitespace or swapped public/private	Re-paste both keys, verifying which is which
Save in Dialog returns 502	Module route unreachable (firewall, internal IP)	Check that your Prestashop is publicly reachable and the module is enabled
Catalog files don’t appear in Dialog	Module didn’t generate them (PHP error during export)	Check Prestashop’s logs and ask support@askdialog.com with the operationId shown in the import status
Widget doesn’t appear on PDP	Module enabled but the theme overrides one or more hooks the module registers	Your developer should branch the same hooks as our module. The Dialog module registers: actionFrontControllerSetMedia (loads the widget assets), displayProductAdditionalInfo (renders the widget on the PDP), displayFooterAfter (fallback rendering), displayOrderConfirmation (purchase tracking), actionCartUpdateQuantityBefore (cart events). Re-implement the same display hooks in the theme override, or remove the override

Need help?

Email support@askdialog.com with your organization name and the issue.