1. Installer le module
Back-office > Modules > Téléverser un module, choisissez le fichier modunia-1.1.0.zip reçu par e-mail. L'installation ajoute une entrée Modunia IA dans le menu de gauche.
2. Activer votre clé
Ouvrez Modunia IA, collez la clé reçue par e-mail, cliquez sur Activer. Sur une copie de test, aucune clé n'est demandée.
3. Connecter n8n
- Dans n8n, créez un workflow et ajoutez un bloc Webhook, méthode POST.
- Dans le bloc, choisissez l'authentification Header Auth, nom
X-Modunia-Secret, et une valeur d'au moins 12 caractères. - Activez le workflow et copiez son adresse de production.
- Dans Modunia, collez l'adresse, saisissez le même mot de passe, cochez la case d'information sur les données, puis cliquez sur Tester et enregistrer.
4. Choisir ce qui part
Cochez les événements utiles à vos workflows. Laissez l'option « Ignorer les modifications faites par l'API » activée : c'est elle qui empêche les boucles quand votre IA réécrit dans la boutique.
5. Envoyer l'existant
La section « Envoyer vos données existantes » envoie une fois ce qui est déjà dans la boutique : produits, catégories, clients, commandes. Vous pouvez arrêter et reprendre à tout moment.
6. Vérifier
La section Activité liste les derniers envois, avec le résultat et le détail des erreurs. Le bouton CSV exporte cette liste.
Que faire si n8n ne répond plus
Les événements sont gardés dans une liste d'attente. Après cinq échecs de suite, l'envoi se met en pause et un bandeau l'indique dans le back-office. Corrigez le workflow, puis cliquez sur « Envoyer les événements en attente et reprendre ».
Format des messages
Une requête POST par événement, en JSON. En-têtes : X-Modunia-Secret, X-Modunia-Timestamp et X-Modunia-Signature, cette dernière étant un HMAC-SHA256 de « horodatage.corps » signé avec votre mot de passe. Le corps contient le type d'événement et les identifiants concernés ; les détails se lisent avec l'API PrestaShop.
Besoin d'aide
Écrivez à contact@modunia.com en indiquant votre version de PrestaShop et de PHP.