Installer et mettre à jour le module

Le module PrestaOne relie votre installation PrestaShop à l’application mobile. Installez-le d’abord sur la boutique, puis connectez chaque téléphone depuis la page Connexions et accès du module.

Il vous faut un compte administrateur PrestaShop autorisé à installer et configurer des modules. Le compte de l’application PrestaOne est un compte distinct : le mot de passe de votre back-office ne sert pas à vous connecter à l’application.

Avant l’installation

• Vérifiez que votre boutique utilise une version de PrestaShop prise en charge : 1.7.8 ou ultérieure (branche 1.7), 8 ou 9. Votre hébergement doit respecter les prérequis PHP de cette version de PrestaShop et le minimum du module, PHP 7.4, avec les extensions nécessaires, dont cURL, JSON, Mbstring et OpenSSL.
• Ouvrez votre boutique publique en HTTPS. L’adresse saisie dans l’application est l’adresse publique de la boutique, pas l’adresse privée de connexion au back-office.
• Sauvegardez les fichiers et la base de données de la boutique avant de modifier les modules installés. Conservez cette sauvegarde jusqu’à ce que l’installation ait été vérifiée.
• Travaillez dans un seul contexte de boutique. PrestaOne ne prend pas officiellement en charge le mode multiboutique de PrestaShop. Connecter plusieurs boutiques indépendantes dans l’application est une autre fonctionnalité : installez alors le module séparément sur chacune de ces boutiques.

Installer le fichier ZIP dans PrestaShop

1. Sur votre ordinateur, ouvrez la page Téléchargements PrestaOne et téléchargez le fichier ZIP du module. Si vous avez obtenu le module sur une marketplace, utilisez le paquet fourni avec votre achat. Ne modifiez pas le fichier ZIP.
2. Dans le back-office de votre boutique, ouvrez Modules → Gestionnaire de modules et choisissez Installer un module. L’intitulé des menus peut légèrement varier selon la version de PrestaShop.
3. Sélectionnez le fichier ZIP téléchargé et attendez que PrestaShop ait terminé l’envoi et l’installation. La fin de l’envoi n’est pas la vérification finale : PrestaShop doit indiquer que l’installation a réussi.
4. Recherchez PrestaOne Mobile Bridge dans le Gestionnaire de modules et choisissez Configurer. Vérifiez que le module est activé.
5. Dans le module, ouvrez Avancé et dépliez Server diagnostics. Contrôlez les prérequis serveur. Si l’un d’eux n’est pas disponible, transmettez ce prérequis précis à votre hébergeur avant d’essayer de connecter un téléphone.

Le module dispose de ses propres onglets dans PrestaShop. Repérez ces noms pour suivre le reste de la documentation. Agrandir ↗

À ce stade, l’état Non connectée est normal : l’installation crée le composant côté boutique, mais aucun téléphone n’a encore été associé. Passez ensuite à Connecter votre boutique à l’application.

Vérifier l’installation avant de connecter un téléphone

Rouvrez la configuration du module depuis le Gestionnaire de modules. La page doit charger ses onglets et proposer de connecter l’application mobile. JavaScript doit être activé dans le navigateur pour que les commandes d’association fonctionnent.

Ouvrez aussi une page ordinaire de votre boutique. L’installation du module ne doit pas empêcher les visiteurs de naviguer ni de passer commande. Une boutique qui s’affiche correctement ne prouve pas, à elle seule, que l’association du téléphone ou le chat en direct fonctionnent : ces éléments ont leurs propres étapes de vérification.

Si l’installation échoue, notez le message d’erreur exact. Une limite de taille d’envoi de fichier, une extension PHP manquante et un échec de configuration du module ne se corrigent pas de la même façon. Consultez Avancé → Server diagnostics si cette section est disponible ; sinon, transmettez l’erreur à votre hébergeur ou à l’assistance PrestaOne.

Mettre à jour une installation existante

La mise à jour conserve l’installation existante et exécute les étapes de mise à niveau du module. Ne désinstallez pas le module pour le mettre à jour. La désinstallation supprime les données du module, notamment les conversations de chat, l’historique des relances, les statistiques et les paramètres de connexion.

1. Notez la version installée dans le Gestionnaire de modules et sauvegardez les fichiers et la base de données de la boutique.
2. Téléchargez le fichier ZIP officiel le plus récent. Utilisez l’action de mise à jour ou d’envoi de module de PrestaShop sur l’installation PrestaOne existante.
3. Attendez le résultat de la mise à niveau, puis rouvrez Configurer. Vérifiez que vos connexions et les paramètres de vos services sont toujours là.
4. Dans l’application, actualisez la boutique connectée et ouvrez une commande ou un produit pour vérifier que les données de la boutique se chargent.
5. Si vous utilisez le chat en direct, vérifiez le widget sur la boutique. Si vous utilisez les relances, vérifiez la campagne enregistrée et l’état de son service. Une connexion de l’application ne suffit pas à valider ces services.

Si PrestaShop signale l’échec de la mise à niveau, conservez la sauvegarde et le détail de l’erreur. Ne désinstallez et ne réinstallez pas le module à plusieurs reprises. Si l’application indique explicitement que la version du module n’est plus prise en charge, mettez le module à jour avant de retenter la connexion.

Si le module est installé mais que la connexion échoue

Suivez Connecter votre boutique à l’application pour la procédure d’association complète. Pour un échec précis, consultez Résoudre les problèmes de connexion et de service.

Derrière un CDN ou un reverse proxy, la boutique publique peut être servie en HTTPS alors que PHP voit une connexion HTTP interne. Dans ce cas, suivez la page Configuration d’un reverse proxy. N’essayez pas de deviner les adresses du proxy et ne désactivez pas les protections HTTPS simplement pour faire disparaître une erreur.