Intégration HubSpot Chat : installation et aide

Ce guide permet de connecter votre boutique à HubSpot. Vous avez besoin d'un compte de service existant et de la valeur de son champ ID du portail. Configurez les conversations et le widget visible dans ce compte.

L'action "Configure" du module ouvre Configuration de HubSpot Chat. Son contrôleur 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 votre identifiant numérique du portail HubSpot, aussi appelé Hub ID, depuis les détails du compte ou le code d'installation. Le panneau du module indique "Settings" > "Account Defaults" > "Account Info". Collez uniquement l'identifiant, pas une URL complète ni un script. La navigation du compte fournisseur est citée d'après les instructions du module et peut différer dans votre compte.

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

Renseignez ces champs dans Configuration de HubSpot Chat, 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 de règle URL personnalisée n'est proposé. Afficher sur mobile utilise la détection mobile de PrestaShop plutôt que la seule largeur du navigateur.

Champs client

Avant de charger le script, le template met en file _hsq.push(['identify', {email: 'customer@example.com'}]) pour un client connecté avec transmission des données activée. Il envoie uniquement l’adresse e-mail ; les noms des clients ne sont pas transmis. Le chargeur utilise hs-script-loader et n'insère pas de second élément avec cet ID.

Ce module ne transmet pas de champs d'identité client PrestaShop pour les visiteurs non connectés. 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 et les règles d'appareil et de page. Il place ensuite un chargeur différé près de 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 attentes ne s'additionnent pas. Avec la valeur d'installation 0, attendez 10 secondes avant de considérer une page sans interaction comme un échec de chargement.

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

//js.hs-scripts.com/{Portal ID}.js

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

Publiez et configurez votre chatflow dans HubSpot. Gérez l'apparence, le routage de la boîte de réception, les réunions et le comportement CRM dans HubSpot.

• Si aucun chargeur n'est inséré, vérifiez Activer HubSpot Chat, ID du portail, 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 console, le blocage des scripts, la Content Security Policy et les outils de consentement de votre boutique.
• Si le script se charge mais que le lanceur est absent, vérifiez la publication du widget, la disponibilité du compte et les règles d'affichage côté service.
• Si un champ client manque, connectez-vous et vérifiez que Transmettre les données client est sur Oui. Comparez avec les champs exacts indiqués plus haut.
• Si une autre intégration insère aussi le script du service, recherchez du code d'installation dupliqué ou conflictuel dans la page rendue.

Vérifier un thème personnalisé

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

{hook h='displayBeforeBodyClosingTag'}

Pour adapter le template du thème, copiez :

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

vers :

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

ENABLED
PORTAL_ID
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

La table utilise le préfixe de votre boutique ; ps_mpr_config n'est donc qu'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.

Réglez Activer HubSpot Chat sur Non et enregistrez en gardant 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" et confirmez. La désinstallation supprime la configuration du module 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.