Skip to content
Mikabot

Installation

Mikabot installs as a chat widget on your website. There is no server to set up: you paste one snippet into a template that runs on every page.

Requirements

  • An active Mikabot account (sign up free)
  • A chatbot created in your dashboard, with its Domain set to the site you are installing on
  • Access to a template or script area that loads on every page

Copy your snippet

  1. Open your chatbot in the dashboard
  2. Go to Site info
  3. Scroll to Install widget
  4. Choose your website type: Static site, WordPress, Next.js, Magento, or More
  5. Copy the code shown

The snippet already contains your chatbot key, your app URL, and your default language. Copy it rather than retyping it from an example.

What the snippet contains

<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://mikabot.studio-mikado.be",
    "store_id": "st_your_chatbot_key",
    "language": "en"
};
</script>
<script src="https://mikabot.studio-mikado.be/js/mikabot-init.js"></script>
  • The first script sets the configuration.
  • The second script loads the widget once your page has finished loading, so it never delays your own content.

Where to paste it

  • Static site: in the shared footer template, just before </body>
  • WordPress: in the footer field of a header/footer scripts plugin
  • Next.js: in a client component rendered near the end of the body in your root layout
  • Magento: under Content > Design > Configuration, in Footer > Miscellaneous HTML for the active store view
  • Anything else: the global footer, custom HTML, or tag manager area that loads on every page

Paste it once. A snippet on two templates loads the widget twice.

Verify the install

  1. Open your website and look for the chat bubble in the bottom-right corner
  2. Send a test message and wait for an answer
  3. Open the chatbot’s chat logs in your dashboard and confirm the conversation is there

If something is wrong

  • No bubble: the snippet is missing on that template, or a cache is still serving the old page. Clear your cache and reload.
  • Bubble opens but never answers: the chatbot’s Domain must match the hostname the widget runs on, and the chatbot must be active.
  • Content-Security-Policy in place: allow your Mikabot app domain for scripts, styles, and connections, and cdnjs.cloudflare.com for the icon stylesheet.

For inline placement, tag managers, and single-page apps, see Advanced widget placement.