Aller au contenu
Retour à tous les articles d'assistance
Bien démarrer widgetscriptinstallationsite web

Installer le widget

Le widget se compose de deux balises script. L’une définit la configuration, l’autre charge Mikabot. Vous les collez une seule fois, dans un gabarit présent sur toutes les pages.

Étape 1 : copier votre code

  1. Ouvrez votre chatbot
  2. Allez dans Settings → Site info
  3. Descendez jusqu’à Install widget
  4. Choisissez votre plateforme : Static site, WordPress, Next.js, Magento ou More
  5. Cliquez sur le bouton de copie

Votre code contient déjà votre clé de chatbot et votre langue par défaut. Copiez-le — ne le recopiez pas à la main depuis un exemple.

Étape 2 : à quoi ressemble le code

<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://mikabot.studio-mikado.be",
    "store_id": "st_votre_cle_chatbot",
    "language": "fr"
};
</script>
<script src="https://mikabot.studio-mikado.be/js/mikabot-init.js"></script>
CléRôle
domainL’application Mikabot avec laquelle le widget communique. Déjà renseignée — n’y touchez pas.
store_idVotre clé de chatbot. Détermine le chatbot et le catalogue utilisés.
languageLa langue de départ. Doit faire partie des langues que vous avez activées.

Étape 3 : coller au bon endroit

Plateforme
Site statiqueDans le gabarit de pied de page commun, juste avant </body>
WordPressUne extension de scripts header/footer, dans le champ footer
MagentoContent → Design → Configuration → votre vue de magasin → Footer → Miscellaneous HTML
Next.jsUn composant client utilisant next/script, rendu en fin de <body> dans app/layout.tsx
AutreLa zone globale de HTML personnalisé ou de scripts de thème chargée sur chaque page

Étape 4 : vérifier

  1. Publiez la modification et videz les caches du thème, des extensions et du CDN
  2. Ouvrez votre site dans une fenêtre privée
  3. Testez une page produit et une page non-produit, sur ordinateur et sur mobile
  4. Envoyez un message de test et vérifiez que la réponse arrive

Si rien n’apparaît, vérifiez que le chatbot est activé : Settings → Chatbot settings → Active.

Erreurs fréquentes

  • Le code est installé deux fois — une fois globalement et une fois dans un gabarit de page. Supprimez-en un.
  • Seule la deuxième balise script a été copiée. Sans MIKADO_CHATBOT_CONFIG, le widget n’a pas de clé de chatbot et reste muet.
  • Un cache sert encore l’ancienne page. Videz le cache du thème, celui des extensions, puis le CDN.
  • Le domaine dans Site info ne correspond pas au site en ligne. Corrigez Settings → Site info → Domain pour qu’il corresponde exactement.
  • Le chatbot est désactivé. Dans ce cas rien ne s’affiche.

Étapes suivantes

Articles associés

Contactez-nous

Notre équipe d'assistance est prête à vous fournir une aide rapide et personnelle lorsque vous en avez besoin.