AI Support Widget Documentation

window.aiSupportConfig = {
  // Required
  widgetKey: 'your-widget-key',
  
  // Appearance
  theme: 'auto', // 'light' | 'dark' | 'auto'
  primaryColor: '#3b82f6',
  borderRadius: '12px',
  
  // Position & Layout
  position: 'bottom-right', // 'bottom-right' | 'bottom-left'
  zIndex: 9999,
  minimized: false,
  
  // Behavior
  autoOpen: false,
  showBranding: true,
  soundEnabled: true,
  
  // Mobile
  mobileFullscreen: true,
  hideOnMobile: false,
  mobileBreakpoint: 768,
  
  // Custom Messages
  welcomeMessage: 'Hello! How can I help you today?',
  placeholderText: 'Type your message...',
  
  // User Info (optional)
  user: {
    id: 'user-123',
    name: 'John Doe',
    email: 'john@example.com'
  },
  
  // Custom CSS (optional)
  customCSS: `
    .ai-widget-bubble {
      box-shadow: 0 8px 32px rgba(0,0,0,0.1);
    }
  `
};

// Listen for widget events
document.addEventListener('ai-widget-ready', function() {
  console.log('AI Support widget is ready!');
});

document.addEventListener('ai-widget-opened', function() {
  // Track widget opens in analytics
  gtag('event', 'widget_opened', {
    event_category: 'ai_support'
  });
});

document.addEventListener('ai-message-sent', function(event) {
  console.log('Message sent:', event.detail.message);
});

// Programmatically control the widget
function openSupportChat() {
  window.AiSupport.open();
}

function sendWelcomeMessage() {
  window.AiSupport.sendMessage('Hello, I need help with my order');
}

// Open widget when user clicks a custom button
document.getElementById('help-button').addEventListener('click', function() {
  window.AiSupport.open();
});

// Update customer data dynamically
function updateCustomerData(customerData) {
  window.AiSupport.setCustomer(customerData);
}

// Example: Update customer after login
function onUserLogin(user) {
  updateCustomerData({
    customerId: user.id,
    name: user.name,
    email: user.email,
    metadata: {
      accountType: user.subscription,
      loginTime: new Date().toISOString()
    }
  });
}

// Add this to your page to debug widget issues
window.aiSupportDebug = true;

// Check if widget is loaded
setTimeout(function() {
  if (typeof window.AiSupport !== 'undefined') {
    console.log('✅ AI Support widget loaded successfully');
    console.log('Widget version:', window.AiSupport.version);
    console.log('Configuration:', window.aiSupportConfig);
  } else {
    console.error('❌ AI Support widget failed to load');
    console.log('Check script URL and widget key');
  }
}, 3000);

// Monitor for common issues
if (!document.getElementById('ai-support-chat')) {
  console.warn('⚠️ Widget container div not found');
}

if (!window.aiSupportConfig || !window.aiSupportConfig.widgetKey) {
  console.error('❌ Widget configuration missing or invalid');
}