Troubleshooting ⏱️ 12 min read

Common Issues & Troubleshooting

Quick solutions to the most frequently encountered issues with YogaBot Live. Use the search box below to find specific problems, or browse by category.

⚡ Quick Fixes

Try these common solutions first - they resolve 80% of issues:

Refresh Your Browser

Clear cache and refresh the page. This fixes widget loading issues and display problems.

Check Your API Keys

Verify your Studio ID and API keys are correct in your dashboard settings.

Test in Incognito Mode

Open your site in incognito/private browsing to rule out browser extension conflicts.

Wait 5 Minutes

Recent configuration changes may take 2-5 minutes to propagate across our system.

Chat Widget Issues

Problems with the YogaBot chat widget appearing or functioning on your website.

  • The most common issue new users face. The chat widget should appear as a floating button on your website.

    🔧 Solution Steps:

    1. Verify the installation code: Check that the YogaBot script is properly installed before the closing </body> tag.
    2. Confirm your Studio ID: Make sure you're using the correct Studio ID from your dashboard.
    3. Check browser console: Open Developer Tools (F12) and look for any JavaScript errors.
    4. Test on different pages: Try visiting different pages on your website to see if the widget loads.
    5. Clear cache: Clear your browser cache and reload the page.
    ✅ Correct Installation:
    <script>
    (function() {
      var script = document.createElement('script');
      script.src = 'https://widget.yogabot.live/widget.js';
      script.setAttribute('data-studio-id', 'YOUR_ACTUAL_STUDIO_ID');
      document.head.appendChild(script);
    })();
    </script>
    ⚠️ Common Mistake: Make sure to replace 'YOUR_STUDIO_ID' with your actual Studio ID, not the placeholder text.

  • The widget appears but clicking it doesn't open the chat window.

    🔧 Solution Steps:

    1. Check for CSS conflicts: Another element might be covering the widget.
    2. Inspect z-index issues: The widget should have a high z-index (usually 999999).
    3. Disable other chat widgets: Temporarily disable other chat tools to test for conflicts.
    4. Test different browsers: Try Chrome, Firefox, and Safari to isolate browser-specific issues.
    🛠️ Quick CSS Fix:
    .yogabot-widget {
      z-index: 999999 !important;
      pointer-events: auto !important;
    }

  • The widget is positioned incorrectly on your website.

    🔧 Solution Steps:

    1. Set position attribute: Add data-position="bottom-right" to your script tag.
    2. Adjust with CSS: Override positioning with custom CSS if needed.
    3. Check mobile display: Test on different screen sizes.
    💡 Available Positions: bottom-right, bottom-left, top-right, top-left

Booking System Issues

Problems with class bookings, cancellations, and integration with booking systems.

  • Bookings made through YogaBot aren't appearing in your booking system.

    🔧 Solution Steps:

    1. Check API credentials: Verify your booking system API keys are current and have proper permissions.
    2. Test connection status: Go to Integrations → [Your System] and check connection status.
    3. Review sync logs: Check the sync log for error messages.
    4. Verify permissions: Ensure your API user has booking creation permissions.
    5. Check rate limits: Your booking system may be throttling requests.
    ⚠️ Important: Sync delays of 1-2 minutes are normal. Real-time sync requires webhook setup.

  • YogaBot says classes are full when your booking system shows available spots.

    🔧 Solution Steps:

    1. Force sync: Go to Classes → Sync Now to update availability.
    2. Check cache settings: Availability cache may be outdated.
    3. Verify class capacity: Ensure capacity limits are set correctly.
    4. Review waitlist settings: Check if waitlist is enabled and configured properly.