Skip to content

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 Settings → 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 primary language. Copy it rather than retyping it from an example.

What the snippet contains

<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://app.mikabot.chat",
    "store_id": "st_your_chatbot_key",
    "language": "en"
};
</script>
<script src="https://app.mikabot.chat/js/mikabot-init.js"></script>
  • The first script sets the configuration.
  • The second script is a small loader. It waits for the window load event before fetching the widget, 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. The loader checks whether the widget script is already on the page and will not load it twice, but a second MIKADO_CHATBOT_CONFIG block overwrites the first — which is how a page ends up starting in the wrong language.

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 Chat conversations in your dashboard and confirm the conversation is there

If something is wrong

  • No bubble: the chatbot is inactive — new chatbots are created that way, so switch Settings → General settings → Active on. Otherwise the snippet is missing on that template, or a cache is still serving the old page.
  • No bubble, and it used to work: the account’s monthly message limit is reached, or Mikabot is temporarily unavailable. In both cases the widget stops loading entirely rather than answering with an error.
  • Bubble opens but never answers: the chatbot’s Domain must match the hostname the widget runs on. The comparison is exact, so www.yourshop.com and yourshop.com are different values.
  • Content-Security-Policy in place: allow your Mikabot app domain in script-src, style-src, and connect-src, and cdnjs.cloudflare.com in style-src and font-src for the icon font.

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