Naar de inhoud

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 Settings → Site info
  3. Scroll naar Install widget
  4. Kies je websitetype: Static site, WordPress, Next.js, Magento of More
  5. Kopieer de getoonde code

De code bevat al je chatbotsleutel, je app-URL en je primaire taal. Kopieer hem in plaats van hem uit een voorbeeld over te typen.

Wat de code bevat

<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://app.mikabot.chat",
    "store_id": "st_your_chatbot_key",
    "language": "nl"
};
</script>
<script src="https://app.mikabot.chat/js/mikabot-init.js"></script>
  • Het eerste script zet de configuratie.
  • Het tweede script is een kleine loader. Hij wacht op het load-event van het venster voor hij de widget ophaalt, dus hij vertraagt je eigen content nooit.

Waar je hem plakt

  • Statische site: in het gedeelde footer-template, vlak vóór </body>
  • WordPress: in het footer-veld van een header/footer-scriptsplugin
  • Next.js: in een client component onderaan de body van je root layout
  • Magento: onder Content → Design → Configuration, in Footer → Miscellaneous HTML voor de actieve store view
  • Iets anders: het globale footer-, custom-HTML- of tagmanagerveld dat op elke pagina laadt

Plak hem één keer. De loader controleert of het widgetscript al op de pagina staat en laadt het niet twee keer, maar een tweede MIKADO_CHATBOT_CONFIG-blok overschrijft het eerste — zo begint een pagina in de verkeerde taal.

Controleer de installatie

  1. Open je website en kijk naar de chatbubbel rechtsonder
  2. Stuur een testbericht en wacht op antwoord
  3. Open Chat conversations in je dashboard en controleer of het gesprek er staat

Als er iets misgaat

  • Geen bubbel: de chatbot staat inactief — nieuwe chatbots worden zo aangemaakt, dus zet Settings → General settings → Active aan. Anders ontbreekt de code op dat template, of serveert een cache nog de oude pagina.
  • Geen bubbel, terwijl het eerder wel werkte: de maandelijkse berichtenlimiet van het account is bereikt, of Mikabot is tijdelijk onbeschikbaar. In beide gevallen laadt de widget helemaal niet meer, in plaats van met een fout te antwoorden.
  • De bubbel opent maar antwoordt nooit: het veld Domain van de chatbot moet overeenkomen met de hostnaam waarop de widget draait. De vergelijking is exact, dus www.jouwshop.be en jouwshop.be zijn verschillende waarden.
  • Content-Security-Policy actief: sta je Mikabot-appdomein toe in script-src, style-src en connect-src, en cdnjs.cloudflare.com in style-src en font-src voor het icoonlettertype.

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

Zie ook