Intégration Freshchat : installation et aide

Connectez votre boutique à Freshchat avec un compte de service existant et son jeton. Configurez les conversations et le widget visible dans ce compte.

L'action "Configure" du module ouvre Configuration Freshchat. La page 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 le Jeton depuis votre code d'installation Freshchat Web Messenger. Le module vous renvoie vers "Settings" > "Web Messenger". 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 un UUID contenant des chiffres hexadécimaux au format 8-4-4-4-12. Un identifiant rejeté laisse la configuration précédemment enregistrée intacte. Corrigez la valeur et enregistrez à nouveau.

Renseignez ces champs dans Configuration Freshchat, 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

Le widget utilise le jeton enregistré et se connecte à https://wchat.freshchat.com. Lorsque Transmettre les données client est activé, il envoie l'e-mail du client connecté comme identifiant client et adresse e-mail, ainsi que son nom complet comme prénom.

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 chargeur du widget apparaît vers la fin des pages autorisées de la boutique lorsque le module est activé, que la valeur de connexion est renseignée et que la règle d'appareil l'autorise.

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é. 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 à :

https://wchat.freshchat.com/js/widget.js

Ouvrez le widget et envoyez un message de test. Vérifiez qu'il arrive dans la boîte de réception du service. Testez avec un compte connecté si vous avez activé Transmettre les données client, et vérifiez les champs d'identité reçus par le service. Enfin, testez les pages et appareils mobiles exclus.

Ce module ne propose pas de paramètre "Host". Un hôte régional ou personnalisé nécessite une modification du template par un développeur. Gérez les messages d'accueil, les couleurs, les bots, les campagnes, les agents et les règles de boîte de réception dans Freshchat.

• Si aucun chargeur n'est généré, vérifiez Activer Freshchat, Jeton, 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 un champ client manque, connectez-vous et confirmez que Transmettre les données client est sur Oui. Comparez avec les champs précis énumérés ci-dessus.
• 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/mprfreshchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

vers :

themes/your-theme/modules/mprfreshchat/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 MPRFCHAT_ pour les noms des champs envoyés. Le stockage actuel utilise le module mprfreshchat dans la table partagée mpr_config, avec des clés courtes :

ENABLED
TOKEN
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 Freshchat 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.