Aller au contenu
Mikabot

Installation

Mikabot s’installe comme un widget de chat sur votre site. Il n’y a pas de serveur à configurer : vous collez un seul code dans un template présent sur toutes les pages.

Prérequis

  • Un compte Mikabot actif (créer un compte gratuit)
  • Un chatbot créé dans votre tableau de bord, dont le champ Domain correspond au site où vous l’installez
  • L’accès à un template ou à une zone de scripts chargée sur chaque page

Copiez votre code

  1. Ouvrez votre chatbot dans le tableau de bord
  2. Allez dans Site info
  3. Descendez jusqu’à Install widget
  4. Choisissez votre type de site : Static site, WordPress, Next.js, Magento ou More
  5. Copiez le code affiché

Le code contient déjà la clé de votre chatbot, l’URL de l’application et votre langue par défaut. Copiez-le plutôt que de le retaper depuis un exemple.

Ce que contient 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>
  • Le premier script définit la configuration.
  • Le second charge le widget une fois votre page entièrement chargée, sans jamais retarder votre propre contenu.

Où le coller

  • Site statique : dans le template de pied de page partagé, juste avant </body>
  • WordPress : dans le champ footer d’une extension de scripts header/footer
  • Next.js : dans un composant client rendu en fin de body dans votre layout racine
  • Magento : sous Content > Design > Configuration, dans Footer > Miscellaneous HTML de la vue boutique active
  • Autre plateforme : le pied de page global, le HTML personnalisé ou la zone de gestionnaire de balises chargée sur chaque page

Collez-le une seule fois. Un code présent sur deux templates charge le widget deux fois.

Vérifiez l’installation

  1. Ouvrez votre site et cherchez la bulle de chat en bas à droite
  2. Envoyez un message de test et attendez la réponse
  3. Ouvrez les journaux de chat du chatbot et vérifiez que la conversation s’y trouve

En cas de problème

  • Pas de bulle : le code est absent de ce template, ou un cache sert encore l’ancienne page. Videz le cache et rechargez.
  • La bulle s’ouvre mais ne répond pas : le champ Domain du chatbot doit correspondre au nom d’hôte où tourne le widget, et le chatbot doit être actif.
  • Content-Security-Policy en place : autorisez le domaine de votre application Mikabot pour les scripts, les styles et les connexions, ainsi que cdnjs.cloudflare.com pour la feuille de style des icônes.

Pour l’affichage intégré, les gestionnaires de balises et les applications monopage, voir Placement avancé du widget.

À lire ensuite