Boutique PrestaShop

La source Boutique PrestaShop permet à Relancia de lire les commandes de votre boutique PrestaShop. Vous pouvez ainsi relancer les clients qui n’ont pas finalisé un achat.

Cette page vous guide pas à pas, depuis l’activation du service web jusqu’à l’import des premières commandes dans Relancia.

Ce que cette source permet de faire

• voir les nouvelles commandes dans Relancia
• détecter les paniers abandonnés
• relancer les clients qui n’ont pas converti
• suivre les changements de statut (paiement, expédition, livraison)
• garder une trace de l’activité de votre boutique

Ce dont vous avez besoin

Avant de commencer, préparez :

• une boutique PrestaShop en ligne (versions 1.7 et 8 supportées)
• un accès administrateur au back-office
• l’URL publique de votre boutique (par exemple https://boutique.atelier-martin.fr)

Comprendre le parcours en 5 étapes

Pour brancher PrestaShop dans Relancia, vous allez suivre ce parcours :

1. Activer le service web dans le back-office PrestaShop
2. Créer une clé d’API pour Relancia
3. Configurer les droits sur les ressources nécessaires
4. Créer un webhook (optionnel) pour les événements en temps réel
5. Copier les identifiants dans Relancia

Étape 1 : activer le service web

1. connectez-vous au back-office de votre boutique PrestaShop
2. dans le menu de gauche, ouvrez Paramètres avancés
3. cliquez sur Service web
4. si le service web n’est pas activé, cliquez sur Activer (en haut à droite)
5. l’URL du service web s’affiche, par exemple https://boutique.atelier-martin.fr/api

Notez cette URL : c’est votre URL de la boutique dans Relancia (sans /api à la fin).

Étape 2 : créer une clé d’API

1. toujours dans la page Service web, ouvrez l’onglet Clés
2. cliquez sur Ajouter une clé (ou Ajouter nouveau)
3. dans Description, entrez un nom clair (par exemple Relancia)
4. dans Statut, laissez Activé
5. cliquez sur Générer pour créer la clé

PrestaShop affiche alors deux informations cruciales :

• la clé d’API (une longue chaîne aléatoire) : c’est votre Clé API
• un lien de configuration des droits

La clé d’API ne s’affiche qu’une seule fois. Copiez-la immédiatement et stockez-la en lieu sûr.

Étape 3 : configurer les droits (permissions)

1. sur la page de la clé créée, ouvrez l’onglet Permissions (ou Droits)
2. pour chaque ressource, choisissez le niveau d’accès :
   • orders (commandes) : GET (lecture)
   • customers (clients) : GET (lecture)
   • addresses (adresses) : GET (lecture)
   • products (produits) : GET (lecture, optionnel)
   • categories (catégories) : GET (lecture, optionnel)
3. cliquez sur Enregistrer pour chaque ressource

Relancia n’a besoin que de droits de lecture. N’accordez jamais de droits d’écriture (POST, PUT, DELETE) sur votre boutique.

Étape 4 : configurer le webhook (optionnel mais recommandé)

Pour que Relancia reçoive les événements PrestaShop en temps réel :

Vérifier que le module de webhooks est installé

1. dans le menu de gauche, ouvrez Modules
2. cherchez Notifications ou Webhooks
3. si un module de webhooks est disponible, installez-le

Créer un webhook

1. dans le module de webhooks, cliquez sur Créer un webhook
2. dans Nom, entrez Relancia
3. dans URL, collez l’URL fournie par Relancia (zone Liens à copier)
4. dans Événements, cochez au minimum :
   • order.created : nouvelle commande
   • order.updated : commande mise à jour
   • cart.abandoned : panier abandonné (si votre version le supporte)
5. activez le webhook
6. copiez le secret fourni par PrestaShop : c’est votre Secret webhook

Étape 1 : ouvrir la source dans Relancia

Une fois votre service web PrestaShop configuré :

1. connectez-vous à app.relancia.pro
2. dans le menu de gauche, ouvrez Sources
3. cliquez sur Ajouter un service
4. dans la liste, choisissez Boutique PrestaShop

Étape 2 : remplir les informations

• URL de la boutique : l’URL publique de votre boutique (par exemple https://boutique.atelier-martin.fr), sans /api à la fin
• Secret webhook : le secret récupéré lors de la configuration du webhook (laisser vide si vous n’utilisez pas les webhooks)

Étape 3 : ajouter la clé API

Dans la zone Clés privées :

• Clé API : collez la clé d’API générée par PrestaShop

Cette clé est sensible. Ne la partagez jamais.

Étape 4 : enregistrer et tester

1. dans Relancia, cliquez sur Enregistrer
2. cliquez sur Tester
3. Relancia contacte l’API PrestaShop et vérifie la connexion
4. si tout est bon, le statut passe à Prêt

Vérifier l’import des commandes

Une fois la source active :

1. ouvrez la page Contacts dans Relancia
2. les clients PrestaShop devraient apparaître
3. les commandes et leurs statuts devraient remonter

Les premières commandes peuvent mettre quelques minutes à apparaître.

Que faire si la source reste en À vérifier

Vérifiez les points suivants dans l’ordre :

• l’URL de la boutique est correcte et accessible depuis un navigateur
• la Clé API est correcte (régénérez-la dans PrestaShop si vous avez un doute)
• les droits GET sont activés sur les ressources orders, customers et addresses
• le service web est bien activé dans PrestaShop
• votre boutique utilise bien HTTPS (obligatoire pour les webhooks)
• aucune extension de sécurité ne bloque les appels de Relancia

Que faire si PrestaShop retourne une erreur 401

• vérifiez que la clé d’API est correcte
• vérifiez que la clé est bien activée dans PrestaShop

Que faire si PrestaShop retourne une erreur 403

• vérifiez que les droits GET sont activés sur les ressources nécessaires
• vérifiez que la clé est bien rattachée à votre boutique

Que faire si PrestaShop retourne une erreur 404

• vérifiez l’URL de la boutique : pas de /api à la fin
• vérifiez que le service web est activé
• vérifiez que la boutique est bien en ligne

Bonnes pratiques

• limitez les droits de la clé API à la lecture seule
• utilisez HTTPS pour votre boutique (obligatoire pour les webhooks)
• vérifiez que votre boutique est bien à jour
• relancez PrestaShop seulement après avoir configuré WhatsApp ou Emails
• testez l’import avec une commande réelle avant d’activer des relances
• faites une sauvegarde de la clé API dans un gestionnaire de mots de passe

Aller plus loin

• Boutique Shopify : si vous utilisez Shopify plutôt que PrestaShop
• Emails : pour envoyer des relances aux clients PrestaShop
• Import et relance : pour relancer une base importée

Documentation officielle PrestaShop

Pour aller plus loin, voici les liens directs vers la documentation PrestaShop :

• Site officiel PrestaShop
• Documentation PrestaShop 8
• Documentation PrestaShop 1.7
• Guide des services web
• Aide PrestaShop

Accès rapides au back-office

Une fois le service web configuré, voici les chemins utiles dans le back-office PrestaShop :

• Tableau de bord : page d’accueil
• Ventes > Commandes : pour voir vos commandes
• Catalogue > Produits : pour gérer vos produits
• Clients > Clients : pour gérer vos clients
• Paramètres avancés > Service web : pour gérer les clés d’API
• Paramètres avancés > Webhooks : pour gérer les webhooks (modules)

Si vous ne voyez pas la section Webhooks, vous devez installer un module compatible depuis la marketplace PrestaShop.