Documentation

๐Ÿš€ Install Bot On Site

Add the Bot On Site script to your website in just a few minutes

๐Ÿ› ๏ธ Choose Your Platform

Click on your platform for step-by-step installation instructions.

โœ… Verify Installation

Quick Check

  1. Open your live website
  2. Do a hard refresh (Cmd/Ctrl+Shift+R)
  3. Look for the Bot On Site chat bubble
  4. Test the chat functionality

Technical Check

  1. Right-click โ†’ View Page Source
  2. Search for "botonsite.com/v1/bos.js"
  3. Check browser console for errors
  4. Verify script loads successfully

๐ŸŽ‰ Success Indicators

Chat Bubble: Visible in bottom corner
Script Loaded: No console errors
Functional: Chat responds to interactions

๐Ÿ”ง Troubleshooting

Common Issues

  • โ€ข Chat bubble not appearing
  • โ€ข Script not loading
  • โ€ข Console errors
  • โ€ข Chat not responding
  • โ€ข Mobile display issues

Quick Fixes

  • โ€ข Clear all caches and republish
  • โ€ข Check script placement (before </body>)
  • )
  • โ€ข Disable ad-blockers temporarily
  • โ€ข Verify domain in Bot On Site settings
  • โ€ข Test in incognito/private mode

๐Ÿ” Detailed Troubleshooting

Cache Issues: Clear platform cache, hosting cache, CDN cache, and browser cache. Many platforms have multiple cache layers.
Script Placement: Ensure the script is placed right before the closing </body> tag, not in the <head> section.
Content Security Policy: If you have a strict CSP, ensure cdn.botonsite.com is allowed in script-src.
Domain Verification: Check that your domain is properly configured in your Bot On Site dashboard settings.

๐Ÿ’ก Still Need Help?

If you're still experiencing issues, contact our support team with: your website URL, platform type, and any console error messages.