Placement avancé du widget

L’installation standard place une bulle flottante dans le coin de chaque page. Ces options couvrent les cas où ce n’est pas ce que vous voulez.

Options de configuration

window.MIKADO_CHATBOT_CONFIG accepte quatre clés :

Intégrer le chat dans la page

Utilisez container lorsque le chat doit vivre dans une section de la page — page conseil, page support, configurateur produit.

<div id="mikabot-inline" style="height: 600px;"></div>
<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://mikabot.studio-mikado.be",
    "store_id": "st_votre_cle_chatbot",
    "language": "fr",
    "container": "#mikabot-inline"
};
</script>
<script src="https://mikabot.studio-mikado.be/js/mikabot-init.js"></script>

Règles importantes :

• L’élément conteneur doit exister dans le DOM avant l’exécution du loader. Si le sélecteur ne correspond à rien, le widget ne s’affiche pas du tout.
• Donnez une hauteur explicite au conteneur. Le chat remplit son parent.
• En mode conteneur, il n’y a pas de bouton d’ouverture — le chat est toujours ouvert.

Gestionnaires de balises

Le code fonctionne dans Google Tag Manager comme balise HTML personnalisée :

1. Créez une balise Custom HTML
2. Collez les deux balises script, la configuration en premier
3. Déclenchez sur All Pages
4. Laissez Support document.write décoché
5. Publiez, puis vérifiez en navigation privée

Ne placez pas aussi le code dans votre thème. Une seule installation.

Applications monopage

Le loader s’accroche à window load et le widget survit à la navigation côté client : vous ne le montez qu’une fois.

• Next.js — utilisez le code Next.js de Settings → Site info → Install widget. Il rend les deux scripts avec strategy="afterInteractive" depuis un composant client dans votre layout racine.
• Autres frameworks — montez les deux balises script dans votre layout racine ou votre app shell, pas dans un composant de route. Le montage par route crée des doublons.

Si votre application change de langue côté client, rechargez la page après le changement. language est lue à l’initialisation du widget.

Journalisation de débogage

Ajoutez "debugLogging": true à la configuration pour écrire l’activité du widget dans la console du navigateur. Utile lorsqu’une CSP ou un bloqueur de publicité interfère.

Désactivez-la avant la mise en ligne — elle est bavarde et visible par quiconque ouvre la console.

Mise en cache

Le loader demande le script principal avec un paramètre de version : une nouvelle version de Mikabot s’invalide donc d’elle-même. Si votre CDN met le HTML en cache de façon agressive, c’est votre propre page qu’il faut purger après avoir collé le code, pas le widget.

Voir aussi

• Installer le widget
• Dépannage