FAQ — Frequently Asked Questions

Installation and configuration

How do I install the TAU widget on my website?

Add this code before </body>:

<script>
  window.taubotConfig = { appId: 'YOUR_APP_ID' };

  (function() {
    var script = document.createElement('script');
    script.src = 'https://app.taubot.ai/widget/widget.js';
    script.async = true;
    document.head.appendChild(script);
  })();
</script>

Replace YOUR_APP_ID with the ID provided in the TAU dashboard.

Where do I find my App ID?

In the TAU dashboard, under Widget Settings. It is usually your site's domain (e.g., mysite.com).

Does the widget work on mobile devices?

Yes. It is fully responsive and automatically adapts to the screen size.

Customization

How do I customize the widget colors?

window.taubotConfig = {
  appId: 'your-app-id',
  chatbotButtonBackground: '#FF5722',
  chatbotButtonForeground: '#FFFFFF'
};

What is the difference between default and cool mode?

• default: chat near the button, subtle design, ideal for corporate sites
• cool: centered chat with a dark overlay, more eye-catching, ideal for modern sites

How do I make the chat open automatically?

window.taubotConfig = {
  appId: 'your-app-id',
  autoOpen: true           // opens on all devices
  // alwaysOpenOnMobile: true  // mobile only
};

WhatsApp

How do I enable WhatsApp mode?

window.taubotConfig = {
  appId: 'your-app-id',
  enableWhatsApp: true,
  whatsAppNumber: '+15551234567',
  whatsAppMessage: 'Hi! I came from your website and need help.'
};

Can I use WhatsApp and the chat at the same time?

Not directly — the widget operates in one mode at a time. However, you can switch programmatically using window.myChatbot.updateConfig() based on conditions (time of day, page, etc.).

Technical issues

The widget is not showing on my site. What should I do?

Check:

• ✅ appId is correct
• ✅ Script is before </body>
• ✅ No errors in the console (F12)
• ✅ showChatbotButton: true is configured
• ✅ Domain is authorized in the TAU dashboard

How do I debug widget issues?

Open the console (F12) and check:

console.log(window.myChatbot);    // widget loaded?
console.log(window.taubotConfig); // correct configuration?

The widget is slow to load. How do I optimize?

The widget already loads asynchronously. To optimize:

• ✅ Use the official CDN (app.taubot.ai)
• ✅ Do not modify the default loading code
• ✅ Set autoOpen: false if not needed

Security and privacy

Is the widget safe to use on my site?

Yes:

• ✅ Secure HTTPS connection
• ✅ CSP (Content Security Policy) compatible
• ✅ Loads in an isolated iframe
• ✅ GDPR compliant

How do I configure authenticated users securely?

Use HMAC generated on the server — see the full guide at Authenticated Area.

Analytics

How do I integrate with Google Analytics?

window.addEventListener('message', function(event) {
  if (event.origin !== 'https://app.taubot.ai') return;

  if (event.data.type === 'Opened chat window') {
    gtag('event', 'chat_opened', { event_category: 'engagement' });
  }
  if (event.data.type === 'conversion') {
    gtag('event', 'conversion', { event_category: 'lead_generation' });
  }
});

See more integrations at Events.