Aller au contenu

Installer le widget

Ce guide explique comment ajouter le widget de chat Voxum à votre site web. Le processus consiste à copier un petit morceau de code et à le coller dans votre site web.

Obtenir votre code de widget

  1. Allez à Widget dans le menu de gauche
  2. Faites défiler jusqu'à la section Code d'intégration
  3. Vous verrez un code qui ressemble à ceci :
<script src="https://app.voxum.ai/widget.js"
        data-property="your-property-id">
</script>
  1. Cliquez sur Copier dans le presse-papiers

Code d'intégration du widget

Installation par plateforme

Choisissez votre plateforme de site web ci-dessous pour des instructions spécifiques.

WordPress

  1. Allez à Apparence → Éditeur de thème dans l'admin WordPress
  2. Sélectionnez votre thème actif
  3. Trouvez et cliquez sur footer.php
  4. Collez le code du widget juste avant </body>
  5. Cliquez sur Mettre à jour le fichier
  1. Installez l'extension « Insert Headers and Footers » (ou similaire)
  2. Allez à Réglages → Insert Headers and Footers
  3. Collez le code du widget dans la section Pied de page
  4. Cliquez sur Enregistrer

Pourquoi utiliser une extension ?

Utiliser une extension garde votre code en sécurité quand vous mettez à jour votre thème.

Shopify

  1. Allez à Boutique en ligne → Thèmes
  2. Cliquez sur Actions → Modifier le code sur votre thème actuel
  3. Dans le dossier Layout, cliquez sur theme.liquid
  4. Trouvez </body> près du bas
  5. Collez le code du widget juste avant </body>
  6. Cliquez sur Enregistrer

Squarespace

  1. Allez à Paramètres → Avancé → Injection de code
  2. Collez le code du widget dans la section Pied de page
  3. Cliquez sur Enregistrer

Note

L'injection de code nécessite un forfait Squarespace Business ou supérieur.

Wix

  1. Allez à votre éditeur Wix
  2. Cliquez sur Ajouter (+) → Intégrer → Intégrations personnalisées → Intégrer un widget
  3. Cliquez sur Entrer le code
  4. Collez le code du widget
  5. Positionnez le widget (il apparaîtra dans le coin quoi qu'il en soit)
  6. Cliquez sur Appliquer

Alternativement :

  1. Allez à Paramètres → Code personnalisé
  2. Cliquez sur + Ajouter du code personnalisé
  3. Collez le code
  4. Définissez l'emplacement sur Corps - fin
  5. Appliquez à Toutes les pages
  6. Cliquez sur Appliquer

Webflow

  1. Allez à Paramètres du projet → Code personnalisé
  2. Collez le code du widget dans la section Code du pied de page
  3. Cliquez sur Enregistrer les modifications
  4. Publiez votre site

HTML personnalisé / Autres plateformes

Pour toute plateforme qui vous permet de modifier le HTML :

  1. Trouvez votre modèle HTML principal ou fichier de pied de page
  2. Localisez la balise fermante </body>
  3. Collez le code du widget immédiatement avant </body>
  4. Enregistrez et publiez

Exemple de placement :

    <!-- Votre contenu de page au-dessus -->

    <script src="https://app.voxum.ai/widget.js"
            data-property="your-property-id">
    </script>
</body>
</html>

Vérifier l'installation

Après avoir ajouté le code :

  1. Visitez votre site web dans un nouvel onglet de navigateur
  2. Cherchez la bulle de chat dans le coin inférieur droit
  3. Cliquez dessus pour ouvrir le chat
  4. Tapez un message de test
  5. Vérifiez que vous recevez une réponse

Widget sur le site web

Afficher le widget sur des pages spécifiques

Par défaut, le widget apparaît sur toutes les pages. Pour l'afficher uniquement sur certaines pages :

WordPress avec extension

Utilisez une extension comme « Widget Logic » ou configurez votre extension d'en-tête/pied de page pour afficher le code uniquement sur des pages spécifiques.

Code conditionnel (Avancé)

Enveloppez le code du widget dans une condition basée sur le langage de template de votre plateforme :

Exemple WordPress :

<?php if (is_page('contact') || is_page('tarifs')): ?>
<script src="https://app.voxum.ai/widget.js"
        data-property="your-property-id">
</script>
<?php endif; ?>

Pages spécifiques seulement

Si vous pouvez modifier des pages individuelles, ajoutez le code du widget uniquement aux sections de code personnalisé de ces pages.

Dépannage

Le widget n'apparaît pas

Vérifiez ces éléments :

  1. Placement du code - Est-il avant </body> ?
  2. Publié - Avez-vous enregistré et publié vos modifications ?
  3. Cache - Essayez de vider le cache de votre navigateur
  4. Bloqueurs de publicités - Désactivez temporairement les bloqueurs de publicités
  5. Erreurs console - Vérifiez les outils de développement du navigateur pour les erreurs

Le widget apparaît mais ne fonctionne pas

  1. ID de propriété - Vérifiez que votre ID de propriété est correct
  2. Domaine - Assurez-vous que votre domaine est enregistré dans Voxum
  3. JavaScript - Vérifiez les erreurs JavaScript dans la console

Le widget est à la mauvaise position

Le widget est conçu pour apparaître dans le coin inférieur droit. C'est intentionnel et ne peut pas être modifié.

Le widget chevauche du contenu

Si le widget couvre du contenu important :

  1. Ajoutez du rembourrage à votre pied de page : padding-bottom: 80px;
  2. Assurez-vous que la zone du widget est libre d'éléments critiques

Plusieurs widgets apparaissent

Vous avez peut-être ajouté le code plus d'une fois. Cherchez le code du widget sur votre site et supprimez les doublons.

Besoin d'aide ?

Si vous n'êtes pas à l'aise pour modifier le code de votre site web :

  1. Copiez votre code de widget depuis le panneau d'administration
  2. Envoyez-le à votre développeur web ou équipe informatique
  3. Dites-leur : « Veuillez ajouter ce code avant la balise body fermante sur notre site web »

La plupart des développeurs sauront exactement quoi faire avec cette instruction.

Tester sur différents appareils

Après l'installation, testez sur :

  • [ ] Ordinateur de bureau (Chrome, Firefox, Safari)
  • [ ] Téléphone mobile
  • [ ] Tablette
  • [ ] Différentes tailles d'écran

Le widget devrait fonctionner de manière cohérente sur tous les appareils.

Prochaines étapes