Naar de inhoud
Mikabot

Installatie

Mikabot installeert als chatwidget op je website. Er is geen server op te zetten: je plakt één code in een template dat op elke pagina draait.

Vereisten

  • Een actief Mikabot-account (gratis account aanmaken)
  • Een chatbot in je dashboard, met het veld Domain ingesteld op de site waarop je installeert
  • Toegang tot een template of scriptveld dat op elke pagina laadt

Kopieer je code

  1. Open je chatbot in het dashboard
  2. Ga naar Site info
  3. Scroll naar Install widget
  4. Kies je type website: Static site, WordPress, Next.js, Magento of More
  5. Kopieer de getoonde code

De code bevat al je chatbotsleutel, je app-URL en je standaardtaal. Kopieer hem, typ hem niet over uit een voorbeeld.

Wat de code bevat

<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://mikabot.studio-mikado.be",
    "store_id": "st_jouw_chatbotsleutel",
    "language": "nl"
};
</script>
<script src="https://mikabot.studio-mikado.be/js/mikabot-init.js"></script>
  • Het eerste script zet de configuratie.
  • Het tweede laadt de widget zodra je pagina klaar is met laden, zodat je eigen inhoud nooit wordt vertraagd.

Waar je hem plakt

  • Statische site: in het gedeelde footertemplate, vlak voor </body>
  • WordPress: in het footerveld van een header/footer-scriptsplugin
  • Next.js: in een clientcomponent die je onderaan de body van je root layout rendert
  • Magento: bij Content > Design > Configuration, in Footer > Miscellaneous HTML van de actieve store view
  • Ander platform: de globale footer, custom HTML of tagmanager die op elke pagina laadt

Plak hem één keer. Een code op twee templates laadt de widget dubbel.

Controleer de installatie

  1. Open je website en zoek de chatbubbel rechtsonder
  2. Stuur een testbericht en wacht op een antwoord
  3. Open de chatlogs van de chatbot in je dashboard en controleer of het gesprek erin staat

Als er iets misgaat

  • Geen bubbel: de code ontbreekt op dat template, of een cache serveert nog de oude pagina. Leeg de cache en herlaad.
  • Bubbel opent maar antwoordt niet: het veld Domain van de chatbot moet overeenkomen met de hostnaam waarop de widget draait, en de chatbot moet actief zijn.
  • Content-Security-Policy actief: sta je Mikabot-appdomein toe voor scripts, stijlen en verbindingen, en cdnjs.cloudflare.com voor de stylesheet met iconen.

Voor inline plaatsing, tagmanagers en single-page apps, zie Geavanceerde widgetplaatsing.

Lees verder