Installation

Installation in 3 steps

1. Add this code before `</body>`

<script>
  window.taubotConfig = {
    appId: 'YOUR_APP_ID' // Replace with your appId
  };

  (function() {
    var loadWidget = function() {
      var script = document.createElement('script');
      script.type = 'text/javascript';
      script.async = true;
      script.src = 'https://app.taubot.ai/widget/widget.js';
      document.getElementsByTagName('head')[0].appendChild(script);
    };
    if (document.readyState === 'complete') {
      loadWidget();
    } else {
      window.addEventListener('load', loadWidget);
    }
  })();
</script>

2. Replace `YOUR_APP_ID`

Swap YOUR_APP_ID with your assistant's unique identifier, available in the TAU dashboard under Widget Settings.

3. Test and publish

Preview your site to see the widget in action, then publish your changes.

Custom installation

Example with the most commonly used parameters:

window.taubotConfig = {
  appId: 'YOUR_APP_ID',

  // Button appearance
  chatbotButtonBackground: '#4834D4',
  chatbotButtonForeground: '#FFFFFF',
  chatbotButtonSize: 60,
  showChatbotButton: true,

  // Positioning
  chatbotButtonBottom: 20,
  chatbotButtonRight: 20,

  // Behavior
  autoOpen: false,
  mode: 'default',        // 'default' or 'cool'
  defaultRoute: 'home',   // 'home' or 'chat'
  defaultMessage: 'Hi! How can I help you?',
  closeChatOnOutsideClick: false,

  // Dimensions
  chatWidth: 400,
  maxChatHeight: 700,

  // WhatsApp
  enableWhatsApp: false,
  whatsAppNumber: '+15551234567',
  whatsAppMessage: 'Hi! I came from your website and need help.'
};

You don't need to define all parameters. The widget works perfectly with just the appId. See the full parameter reference.

CDN and loading

The widget is served from the official CDN at app.taubot.ai, ensuring maximum performance and automatic security updates.

Asynchronous loading (recommended)

The default method uses asynchronous loading so it doesn't block page rendering:

(function() {
  var loadWidget = function() {
    var script = document.createElement('script');
    script.type = 'text/javascript';
    script.async = true;
    script.src = 'https://app.taubot.ai/widget/widget.js';
    document.getElementsByTagName('head')[0].appendChild(script);
  };
  if (document.readyState === 'complete') {
    loadWidget();
  } else {
    window.addEventListener('load', loadWidget);
  }
})();

Direct loading

For specific cases where synchronous loading is required:

<script src="https://app.taubot.ai/widget/widget.js"></script>

Direct loading may impact page performance. Use only when necessary.

Compatibility

Supported browsers:

Browser	Minimum version
Chrome	60+
Firefox	55+
Safari	12+
Edge	79+
Opera	47+
Mobile (modern)	✅

Technical requirements:

JavaScript enabled
ES6 support (ECMAScript 2015)
Internet connection to load the widget

Security and privacy

✅ Secure HTTPS connection
✅ GDPR compliant
✅ Does not collect personal data without consent
✅ CSP (Content Security Policy) friendly
✅ Loads in isolation (iframe)

Installation

On this page