Skip to content
Mikabot
Back to all support articles
Troubleshooting troubleshootingerrorswidgetfeeds

Troubleshooting

Find the symptom you see, then work through the checks from top to bottom. The first checks are the ones that fail most often.

The widget does not appear

  1. View the page source and search for MIKADO_CHATBOT_CONFIG. If it is missing, the snippet was never published — see Install the widget.
  2. Check that Settings → Chatbot settings → Active is switched on.
  3. Confirm store_id in the snippet matches the Chatbot key on Settings → Chatbot settings.
  4. Clear theme, plugin, and CDN caches, then reload in a private window.
  5. Open the browser console and look for errors from mikabot-init.js.
  6. Check that the widget is not inside a container the theme hides by default.

The widget opens but does not reply

  1. Check your monthly message count on Account. When the plan limit is reached, replies stop until the period resets or you upgrade.
  2. Look for a red or orange banner at the top of the dashboard — it reports usage limits and AI provider downtime.
  3. Send a test message from the Demo page link on Settings → Chatbot settings. If the demo works but your site does not, the problem is in the embed.
  4. Check Chat conversations for the failed message. The stored response payload usually names the cause.

No products are suggested

  1. Confirm Settings → Chatbot settings → Enable ecommerce is on. Without it, product search is disabled entirely.
  2. Open Ecommerce → Products. If the list is empty, no feed has imported successfully.
  3. Check that products exist for the language the visitor is using. Products are stored per language.
  4. Review Ecommerce → AI configuration → Search Strategy. Category Only returns nothing when your categories are empty.

A product feed import fails

  1. Open the feed URL in a private browser window. It must be publicly reachable without a login.
  2. Match the feed type to the file: Google Shopping Feed for XML, Custom CSV Feed for CSV.
  3. Every item needs a unique id. Items without one are skipped and reported as missing id.
  4. For Google Shopping XML, add product_type to every item. Without it Mikabot cannot build categories, and you will see a warning naming the number of affected products.
  5. Import one language at a time and check the counters — Products in Feed versus Products in DB.

Full field list: Product feed field reference.

The bot replies in the wrong language

  1. Check the language value in your embed snippet. It sets the starting language.
  2. Confirm that language is activated under Settings → Site info → Website Languages.
  3. Add a lang attribute to your site’s <html> tag so automatic detection has something to work with.
  4. Check that AI responses exist in that language under Settings → AI responses.

Chat transcripts are not emailed

  1. Turn on Settings → Chatbot settings → Enable chat e-mail to contact.
  2. Fill in Email Recipients, separating multiple addresses with semicolons (;), not commas.
  3. The transcript is sent only after a visitor provides their email address in the chat.

Still stuck?

  1. Email [email protected]
  2. Include your chatbot key, the affected page URL, and the exact symptom
  3. Attach screenshots and any browser console errors

We respond within 24 hours on business days.

Related articles

Human handoff

Route visitors to your team when the bot should step aside, and capture the conversation.

Account setup

Create your Mikabot account, verify your email, and find your way around the dashboard.

AI responses explained

The difference between canned and smart responses, and how the bot decides which to use.

Contact us

Our support team is ready to give you fast, personal help when you need it.

Contact us Back to all support articles