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
- Ouvrez votre chatbot
- Allez dans Settings → Site info
- Descendez jusqu’à Install widget
- Choisissez votre plateforme : Static site, WordPress, Next.js, Magento ou More
- 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://app.mikabot.chat",
"store_id": "st_votre_cle_chatbot",
"language": "fr"
};
</script>
<script src="https://app.mikabot.chat/js/mikabot-init.js"></script>| Clé | Rôle |
|---|---|
domain | L’application Mikabot avec laquelle le widget communique. Déjà renseignée — n’y touchez pas. |
store_id | Votre clé de chatbot. Détermine le chatbot et le catalogue utilisés. |
language | La langue de départ. Pré-remplie avec la langue principale de votre chatbot. |
Étape 3 : coller au bon endroit
| Plateforme | Où |
|---|---|
| Site statique | Dans le gabarit de pied de page commun, juste avant </body> |
| WordPress | Une extension de scripts header/footer, dans le champ footer |
| Magento | Content → Design → Configuration → votre vue de magasin → Footer → Miscellaneous HTML |
| Next.js | Un composant client utilisant next/script, rendu en fin de <body> dans app/layout.tsx |
| Autre | La zone globale de HTML personnalisé ou de scripts de thème chargée sur chaque page |
Étape 4 : vérifier
- Publiez la modification et videz les caches du thème, des extensions et du CDN
- Ouvrez votre site dans une fenêtre privée
- Testez une page produit et une page non-produit, sur ordinateur et sur mobile
- Envoyez un message de test et vérifiez que la réponse arrive
Si rien n’apparaît, vérifiez d’abord Settings → General settings → Active. Les nouveaux chatbots sont créés inactifs.
Erreurs fréquentes
- Le code est installé deux fois — une fois globalement et une fois dans un gabarit de page. Supprimez-en un. Le loader vérifie si le script principal est déjà présent et ne le charge pas deux fois, mais un second bloc de configuration écrase le premier et peut changer la langue de départ.
- 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.
- La limite mensuelle de messages est atteinte. Le widget cesse alors complètement de se charger jusqu’au changement de mois. Voir Forfaits et limites d’utilisation.
Étapes suivantes
- Placement avancé du widget — conteneurs intégrés, gestionnaires de balises et applications monopage
- Apparence et image de marque — couleurs, avatar, nom du bot
- Dépannage — si le widget ne s’affiche toujours pas
Articles associés
Configuration du compte
Créez votre compte Mikabot, vérifiez votre e-mail et prenez vos repères dans le tableau de bord.
Créer votre premier chatbot
Parcourez l'assistant en cinq étapes et obtenez un chatbot fonctionnel en quelques minutes.
Placement avancé du widget
Intégrez le chat dans la page, chargez-le via un gestionnaire de balises ou faites-le tourner dans une application monopage.
Contactez-nous
Notre équipe d'assistance est prête à vous fournir une aide rapide et personnelle lorsque vous en avez besoin.