Intégration JivoChat : installation et aide

Connectez votre boutique à JivoChat. Vous devez disposer d'un compte existant auprès du service et de son identifiant ID du widget. Configurez les conversations et le widget visible dans le compte du service.

L'action "Configure" du module ouvre Configuration JivoChat. La page de configuration affiche aussi un avis de configuration requise et une bannière d’intégrité. Utilisez les pages Paramètres, "Integrity", Licence, Assistance et Mettre à jour du module pour les opérations de maintenance correspondantes.

Trouver la valeur de connexion

Copiez l'identifiant ID du widget depuis le code d'installation de votre canal de site web dans JivoChat. Le panneau de configuration renvoie vers "Manage" > "Channels" > "Website widget". Collez uniquement l'identifiant. Ne collez pas une URL ou un script complet.

La valeur par défaut est vide. Pour les identifiants nouveaux ou modifiés, le module attend 5 à 128 lettres ou chiffres. Un identifiant rejeté laisse la configuration précédemment enregistrée intacte. Corrigez la valeur et enregistrez à nouveau.

Renseignez ces champs dans Configuration JivoChat, puis cliquez sur Enregistrer.

Groupes de pages

Le ciblage utilise les noms des contrôleurs. Un contrôleur de commande personnalisé absent de cette liste n'est pas inclus par Pages de commande uniquement. Aucun champ ne permet de définir des règles d'URL personnalisées. Afficher sur mobile utilise la détection mobile de PrestaShop, et pas uniquement la largeur du navigateur.

Champs client

Lorsque Transmettre les données client est activé et que le client est connecté, le module enregistre window.jivo_onLoadCallback avant de charger le widget. Quand JivoChat l’appelle et que jivo_api est disponible, il transmet le nom et l’e-mail via jivo_api.setContactInfo. Choisissez Non pour omettre cette transmission.

Les visiteurs non connectés ne reçoivent aucun champ d'identité client PrestaShop de ce module. Le service peut toujours recueillir des informations via son propre widget. Ce module ne synchronise ni l'historique des commandes ni le contenu du panier.

Exemple de configuration

Pour les pages de commande sur ordinateur, choisissez Pages de commande uniquement, réglez Afficher sur mobile sur Non et "Fallback Delay (seconds)" sur 2. Le chargeur démarre à la première interaction ou après deux secondes sans interaction.

Le module enregistre displayBeforeBodyClosingTag. Il vérifie d'abord l'activation, la valeur de connexion, la règle d'appareil et la règle de page. Il insère ensuite un chargeur différé vers la fin de la page.

Faites défiler, cliquez, touchez la page ou appuyez sur une touche pour déclencher le chargeur. Sans interaction, attendez le délai de secours configuré. Le chargeur partagé supprime le délai interne du template, les deux délais ne s'additionnent donc pas. Avec la valeur par défaut d'installation 0, attendez 10 secondes avant de considérer qu'une page sans interaction présente un échec de chargement.

Dans les outils de développement du navigateur, recherchez une requête correspondant à :

//code.jivosite.com/widget/{Widget ID}

Ouvrez le widget et envoyez un message de test. Vérifiez qu'il arrive dans la boîte de réception du service. Enfin, testez les pages et appareils mobiles exclus.

Gérez les opérateurs, les canaux, le routage, les formulaires hors ligne et l'automatisation dans JivoChat. Ce module fournit le chargeur du widget de la boutique et les règles d'affichage.

• Si aucun chargeur n'est généré, vérifiez Activer JivoChat, ID du widget, Afficher sur les pages et Afficher sur mobile.
• Si la page reste sans interaction, attendez le délai de secours ou interagissez avec elle. "Fallback Delay (seconds)" à 0 ne signifie pas un chargement immédiat.
• Si l'enregistrement échoue, gardez l'identifiant renseigné, vérifiez son format, rechargez la page de configuration et réessayez. N'utilisez pas d'identifiants fictifs pour un test réel.
• Si la requête externe échoue, vérifiez les erreurs de la console du navigateur, le blocage des scripts, la Content Security Policy et les outils de consentement de votre boutique.
• Si le script se charge mais que le bouton d'ouverture est absent, vérifiez la publication du widget côté service, la disponibilité du compte et les règles d'affichage.
• Si le nom ou l’e-mail du client connecté est absent, vérifiez Transmettre les données client, rechargez la page et recherchez des erreurs ou une autre intégration qui remplace window.jivo_onLoadCallback.
• Si une autre intégration insère aussi le script du service, recherchez dans la page générée un code d'installation en double ou conflictuel.

Vérifier un thème personnalisé

Votre thème doit exécuter le hook de fermeture du corps de page. Un développeur peut rétablir cet appel avant </body> s'il manque dans le thème :

{hook h='displayBeforeBodyClosingTag'}

Pour modifier le template du thème, copiez :

modules/mprjivochat/views/templates/hook/displayBeforeBodyClosingTag.tpl

vers :

themes/your-theme/modules/mprjivochat/views/templates/hook/displayBeforeBodyClosingTag.tpl

Conservez les variables Smarty du module et l'échappement de l'identifiant. L'enveloppe d'interaction partagée s'applique toujours à ce template de hook.

Le formulaire utilise le préfixe MPRJIVO_ pour les noms des champs envoyés. Le stockage actuel utilise le module mprjivochat dans la table partagée mpr_config, avec des clés courtes :

ENABLED
WIDGET_ID
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

La table de base de données utilise le préfixe des tables de votre boutique ; ps_mpr_config est donc seulement un exemple de nom. Utilisez le formulaire de configuration pour les modifications courantes. Ne considérez pas les noms des champs du formulaire comme les clés actuelles de la base de données.

Réglez Activer JivoChat sur Non et enregistrez en laissant l'identifiant renseigné pour suspendre l'affichage de ce module. Vous pouvez aussi désactiver le module dans "Module Manager".

Pour le supprimer, utilisez "Uninstall" dans "Module Manager", puis confirmez. La désinstallation supprime sa configuration et ses entrées de menu d'administration. Elle ne ferme pas le compte du service externe et ne supprime pas le code inséré par un autre module ou thème.