Aller au contenu

Installation

Mikabot s’installe sous forme de widget de chat sur votre site. Aucun serveur à configurer : vous collez un seul extrait de code dans un gabarit chargé sur chaque page.

Prérequis

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

Copier votre code

  1. Ouvrez votre chatbot dans le tableau de bord
  2. Allez dans Settings → 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à votre clé de chatbot, l’URL de l’application et votre langue principale. Copiez-le plutôt que de le retaper depuis un exemple.

Ce que contient le code

<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://app.mikabot.chat",
    "store_id": "st_your_chatbot_key",
    "language": "fr"
};
</script>
<script src="https://app.mikabot.chat/js/mikabot-init.js"></script>
  • Le premier script définit la configuration.
  • Le second script est un petit loader. Il attend l’événement load de la fenêtre avant de récupérer le widget : il ne retarde donc jamais votre propre contenu.

Où le coller

  • Site statique : dans le gabarit de pied de page commun, 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 pour la vue de magasin active
  • Autre : la zone globale de pied de page, de HTML personnalisé ou de gestionnaire de balises chargée sur chaque page

Collez-le une seule fois. Le loader vérifie si le script du widget est déjà présent et ne le charge pas deux fois, mais un second bloc MIKADO_CHATBOT_CONFIG écrase le premier — c’est ainsi qu’une page démarre dans la mauvaise langue.

Vérifier l’installation

  1. Ouvrez votre site et cherchez la bulle de chat en bas à droite
  2. Envoyez un message de test et attendez une réponse
  3. Ouvrez Chat conversations dans votre tableau de bord et vérifiez que la conversation s’y trouve

En cas de problème

  • Pas de bulle : le chatbot est inactif — les nouveaux chatbots le sont par défaut, activez donc Settings → General settings → Active. Sinon, le code manque sur ce gabarit, ou un cache sert encore l’ancienne page.
  • Pas de bulle alors que cela fonctionnait : la limite mensuelle de messages du compte est atteinte, ou Mikabot est temporairement indisponible. Dans les deux cas, le widget cesse complètement de se charger au lieu de répondre par une erreur.
  • La bulle s’ouvre mais ne répond jamais : le champ Domain du chatbot doit correspondre au nom d’hôte sur lequel tourne le widget. La comparaison est exacte : www.votreboutique.com et votreboutique.com sont deux valeurs différentes.
  • Content-Security-Policy en place : autorisez le domaine de votre application Mikabot dans script-src, style-src et connect-src, et cdnjs.cloudflare.com dans style-src et font-src pour la police d’icônes.

Pour l’intégration en ligne, les gestionnaires de balises et les applications monopage, voir Placement avancé du widget.

À voir aussi