Skip to main content

Chatbot Version 2.0

📋 Select Chatbot Version:
Latest (v2.0)RECOMMENDED
Version 2.0STABLE
Version 1.0.0DEPRECATED
💡 Tip: Use the latest version for new integrations. Version-specific docs help with maintenance and troubleshooting.

🎨 Version 2.0 - Modern UI with advanced features (Latest: 2.0.22)

Overview​

Version 2.0 represents a major upgrade to the ept AI chatbot, featuring a completely redesigned interface and powerful new features. This version focuses on modern user experience, enhanced customization options, and improved developer integration.

Key Features​

🎨 Modern UI Design​

  • Completely redesigned interface - Clean, contemporary chat design
  • Improved visual hierarchy - Better message organization and readability
  • Enhanced animations - Smooth transitions and micro-interactions
  • Modern typography - Updated font styling and text rendering
  • Refined color palette - More accessible and visually appealing colors

🚀 Advanced Features​

  • File Upload Support - Upload documents and images
  • Advanced Welcome Messages - Rich welcome content with icons
  • Enhanced Header Customization - Custom icons and chat names
  • Show/Hide Controls - Programmatic widget visibility control
  • Initially Hidden Option - Start widget hidden by default
  • Maximize Button Control - Show/hide maximize button
  • Disclaimer Text - Custom disclaimer support
  • Enhanced Error Handling - Better error recovery and user feedback

Quick Start​

<script>
  // Configure the chatbot with v2.0 features
  window.eptAIConfig = {
    accessToken: 'your-access-token-from-backend',
    botName: 'Support Bot',
    defaultQuestions: ["What are your products?"],
    // v2.0 features
    headerIcon: '🤖',
    headerChatName: 'AI Support',
    enableFileUpload: true,
    initiallyHidden: false,
    showMaximizeButton: true,
    disclaimerText: 'This chat is powered by AI.',
    advancedWelcomeText: {
      icon: '👋',
      title: 'Welcome to Support',
      description: 'How can we help you today?'
    }
  };
</script>

<!-- Load latest 2.0 version -->
<script 
  src="https://assets.ept.ai/chatbot/loader.js" 
  data-version="2.0.22"
  async>
</script>

Version Targeting​

<!-- Latest 2.x version -->
<script src="https://assets.ept.ai/chatbot/loader.js" data-version="2.0.22" async></script>

Track-Based​

<!-- Stable track (recommended for production) -->
<script src="https://assets.ept.ai/chatbot/loader.js" data-track="stable" async></script>

<!-- Beta track (early access) -->
<script src="https://assets.ept.ai/chatbot/loader.js" data-track="beta" async></script>

Specific Patch​

<!-- Pin to exact patch version -->
<script src="https://assets.ept.ai/chatbot/loader.js" data-version="2.0.13" async></script>

Configuration Parameters​

Core Parameters​

ParameterTypeDefaultDescription
accessTokenstring-Required. Authentication token from your backend
botNamestring'AI'Display name for the bot
defaultQuestionsstring[][]Suggested questions to display

UI & Appearance​

ParameterTypeDefaultDescription
darkModebooleanfalseEnable dark theme
hideLogobooleanfalseHide ept AI branding
fullWindowbooleanfalseFull browser window mode
inlinebooleanfalseInline embedding mode
parentDivstringnullContainer element for inline mode
botImagestringdefaultCustom bot avatar image URL
userImagestringdefaultCustom user avatar image URL
headerIconstring'💬'Custom header icon
headerChatNamestring'Chat'Custom header chat name
showMaximizeButtonbooleantrueShow/hide maximize button
initiallyHiddenbooleanfalseStart widget hidden by default

Text & Messages​

ParameterTypeDefaultDescription
introTextstring"Hi, I'm {botName}..."Welcome message displayed when chat loads
placeholderTextstring'Type your message here...'Input field placeholder text
loadingTextstring''Text shown while AI is processing
networkErrorTextstring'Connection Lost...'Network error message
disclaimerTextstring''Custom disclaimer text
tooltipCopyTextstring'Copy'Tooltip text for copy button
tooltipLikeTextstring'Like'Tooltip text for like/thumbs up button
tooltipDislikeTextstring'Dislike'Tooltip text for dislike/thumbs down button

Advanced Features​

ParameterTypeDefaultDescription
enableFileUploadbooleanfalseEnable file upload functionality
enableChatPersistencebooleantrueEnable/disable chat persistence in localStorage
advancedWelcomeTextobjectnullAdvanced welcome message with icon, title, and description
eptMetaDataobjectnullOptional metadata for advanced use cases
versionstring'1.2.7'Widget version identifier

Widget Control​

// Show/hide widget programmatically
window.eptAIConfig.show();
window.eptAIConfig.hide();

// Toggle dark mode programmatically
window.eptAIConfig.setDarkMode(true);  // Enable dark mode
window.eptAIConfig.setDarkMode(false); // Disable dark mode

// Token refresh (24-hour expiry)
window.eptAIConfig.accessToken = 'new-token';

Recent Updates​

Version 2.0.22 (Latest)​

🐛 Bug Fixes​

  • New Chat Session Streaming Fix - Resolved issue where old stream content could mix with new chat messages
    • Implemented WebSocket streaming state reset when starting new chat sessions
    • Clears accumulated messages, resets timers, and updates UI to idle state
    • Ensures clean conversation starts without residual streaming content

🎨 Typography & Customization​

  • Line Height Variables - New CSS variables for precise line spacing control

    • --ept-line-height-base (1.6) - Base line height for body text
    • --ept-line-height-tight (1.4) - Tighter spacing for compact layouts
    • --ept-line-height-relaxed (1.8) - Relaxed spacing for readability
    • --ept-line-height-h1 through --ept-line-height-h6 - Individual heading control
    • --ept-line-height-p and --ept-line-height-li - Paragraph and list item spacing

  • Tooltip Customization Variables - Full control over tooltip appearance

    • --ept-tooltip-font-family - Customize tooltip font (defaults to main font)
    • --ept-tooltip-font-size - Tooltip text size (default: 12px)
    • --ept-tooltip-font-weight - Tooltip font weight (default: 500)
    • --ept-tooltip-background - Tooltip background color
    • --ept-tooltip-text-color - Tooltip text color
    • --ept-tooltip-border-radius - Tooltip corner rounding
    • See Design Configuration for complete usage examples

  • Layout Improvements - Adjusted margins for bot message elements for improved layout

Version 2.0.21​

✨ Animation Enhancements​

  • Widget Entrance Animation - New entrance animation for chat widget visibility
    • Smooth animation when chat widget becomes visible for the first time
    • Animation class removed after duration to prevent Safari re-triggers
    • Improved performance and compatibility across browsers
    • Better user experience with polished visual feedback

Version 2.0.20​

🌙 Dark Mode Improvements​

  • Enhanced Dark Mode Handling - Improved CSS transitions and animations for dark mode
    • Prevent unnecessary re-animation when switching between light/dark modes
    • Removed hover effect inconsistencies in dark mode
    • Better default question animation control in dark mode

🔧 Message Rendering​

  • Dynamic Configuration - Enhanced message rendering with fresh config values
    • Bot and user images now fetched from current config for each render
    • Bot and user names dynamically updated from configuration
    • Ensures avatar and name changes reflect immediately without refresh

Version 2.0.19​

🔌 Connection Management​

  • Connection Status Indicator - New visual indicator for WebSocket connection state

    • Real-time connection status display
    • Clear visual feedback when connection is lost or reconnecting
    • Improved user awareness of chat availability

  • Refresh Suggestion System - Smart refresh prompts for better user experience

    • Automatic detection of connection errors and token expiration
    • User-friendly refresh suggestion banner
    • Enhanced error recovery guidance
    • Updated CSS for better visibility of connection states

Version 2.0.18​

🔧 Code Quality & Maintainability​

  • Vendor-Prefixed Property Handling - Improved WebKit compatibility
    • Refactored webkitBackdropFilter handling with type assertions
    • Better TypeScript compatibility for vendor-specific properties
    • Enhanced code maintainability and type safety

🦊 Enhanced Safari Rendering​

  • Optimized Repaint Handling - Further improvements to Safari rendering performance
    • Refactored ConfigManager for better Safari repaint optimization
    • Enhanced WebSocketManager with improved rendering reliability
    • More efficient backdrop-filter handling in Safari/WebKit
  • Dependency Updates - Added new Babel plugins for improved compatibility
    • Enhanced transpilation support for modern JavaScript features
    • Better cross-browser compatibility
  • Dark Mode Improvements - Enhanced CSS for better dark mode support
    • Improved color transitions and theme switching
    • More reliable dark mode rendering across browsers

Version 2.0.17​

🎨 UI Improvements​

  • Typing Animation Refinement - Improved visual display of typing indicator
    • Changed typing animation dots from horizontal to vertical stack layout
    • Better spacing with 4px margin between dots
    • Enhanced visual clarity during loading states
  • Message Content Display - Improved message rendering
    • Added line-height property (1.5) for better readability
    • Enhanced text spacing and layout consistency
    • Cleaner message content initialization

Version 2.0.16​

🌙 Dark Mode Enhancements​

  • Programmatic Dark Mode Control - New method to toggle dark mode dynamically
    • window.eptAIConfig.setDarkMode(true/false) - Toggle dark mode programmatically
    • Real-time dark mode switching without page reload
    • Automatic class management for styling updates
  • System Appearance Listener - Automatic detection of OS theme changes
    • Listens for system color scheme changes
    • Automatically updates widget appearance when OS theme changes
    • Seamless synchronization with system preferences

🦊 Safari/WebKit Improvements​

  • Enhanced Safari Rendering - Fixed rendering issues specific to Safari browser
    • Resolved backdrop-filter rendering bug in Safari
    • Fixed CSS custom properties not updating until user interaction
    • Multiple repaint techniques to ensure consistent rendering
    • Hardware acceleration optimizations for smoother performance
    • Improved rendering reliability across all WebKit-based browsers

Version 2.0.15​

🎨 Enhanced Customization​

  • Customizable Tooltip Text - New configuration options for personalizing tooltip messages
    • tooltipCopyText - Customize the copy button tooltip (default: 'Copy')
    • tooltipLikeText - Customize the like button tooltip (default: 'Like')
    • tooltipDislikeText - Customize the dislike button tooltip (default: 'Dislike')
    • Allows for better localization and brand voice alignment
    • Tooltips now configurable throughout all interactive elements (copy buttons, feedback buttons, code blocks)

Version 2.0.14​

🎨 UI Polish​

  • Improved Tooltip Text - Enhanced tooltip readability for feedback buttons
    • Updated tooltip text to use proper capitalization ('Like' and 'Dislike')
    • Better visual consistency across the interface

Version 2.0.13​

✅ Input Validation & Quality​

  • Enhanced Message Validation - Improved input handling for better user experience
    • Automatic whitespace trimming from chat messages
    • Prevents sending of empty or whitespace-only messages
    • Allows file uploads without text when files are attached
    • Improved message quality and reduced accidental submissions

🔧 Maintenance & Performance​

  • Dependency Updates - Updated core dependencies for improved security and compatibility
    • Upgraded esbuild and body-parser to latest versions
    • Enhanced overall stability and performance

Version 2.0.12​

🎨 Enhanced UI/UX​

  • Improved Tooltip Positioning - Tooltips now display below feedback icons instead of above
    • Better visibility and user experience for copy and feedback buttons
    • Removed tooltip arrow/caret for cleaner appearance
    • Smoother tooltip animations and positioning

Version 2.0.11​

💬 Advanced Welcome Message​

  • Enhanced Welcome Message Handling - Improved display logic for advanced welcome messages
    • Support for image icons or emoji in welcome messages via advancedWelcomeText.icon
    • Better persistence of welcome messages when chat is cleared
    • Automatic detection of image paths vs. emoji characters
  • Custom Tooltip System - New custom tooltip functionality for interactive elements
    • Tooltips for copy, like, and dislike buttons
    • Smooth fade-in/fade-out animations
    • Auto-positioning with scroll and resize handling

Version 2.0.10​

💾 Chat Persistence Control​

  • enableChatPersistence Parameter - New configuration option to enable/disable chat persistence
    • Allows users to control whether conversations are saved to localStorage
    • When disabled, chat history is not persisted across page refreshes
    • Default: true (enabled)

Version 2.0.9​

🎨 UI Improvements​

  • Enhanced visual design and user interface refinements
  • Optimized rendering performance

Version 2.0.8​

  • Minor bug fixes and stability improvements

Version 2.0.7​

🎨 Enhanced Customization​

  • 80+ CSS Variables - Comprehensive design customization system
    • New color variables for links, code blocks, tables, notifications, badges, and loading states
    • Enhanced dark mode variables including JSON messages, progress bars, and scrollbars
    • Complete typography control with heading sizes (h1-h6), paragraph, and list text
    • 17 font size variables for granular text control across all UI components
  • High Specificity CSS - Better style override support for advanced customization
  • See Design Configuration for complete variable reference

💬 Improved User Experience​

  • Type While Streaming - Users can now type in the input field while AI responses are streaming
    • No more waiting for the response to complete before composing the next message
    • Smoother, more natural conversation flow
  • Enhanced Input Responsiveness - Better textarea behavior during message streaming

💾 Conversation Persistence​

  • LocalStorage Integration - Conversations are now automatically saved to browser localStorage
    • Chat history persists across page refreshes and browser sessions
    • Automatic 24-hour retention period
    • Seamless restoration of conversation context on return visits
  • Improved User Continuity - Users can pick up where they left off within 24 hours

🐛 Bug Fixes & Performance​

  • Performance optimizations for message rendering
  • Improved error handling and recovery
  • Enhanced accessibility and keyboard navigation

Version 2.0.6​

  • UI refinements and bug fixes

Version 2.0.5​

  • Margin adjustments - Improved content spacing and layout
  • Bug fixes and performance improvements

Previous Versions​

  • Version 2.0.4 - File upload, advanced features, and UI improvements

Migration​

If you're upgrading from version 1.0.x, see our Migration Guide for step-by-step instructions.

Breaking Changes from 1.0.x​

  • New UI design may affect custom CSS
  • Some configuration parameter names updated
  • Enhanced error handling may change error messages

Next Steps​

After successfully integrating version 2.0:

  1. Configure the Design - Customize the visual appearance
  2. Context-Aware Chat - Make your chatbot intelligent about user context
  3. Set up Continuous Improvement - Monitor performance and optimize responses
  4. Explore Advanced Integrations - Connect with CRM, support systems, and other platforms

📧 Stay Updated on Chat Widget Releases​

Get notified when we release new versions of the ept AI chat widget with new features, improvements, and bug fixes.

What you'll receive:

  • ✨ Early access to new features
  • 🐛 Important bug fixes and security updates
  • 📚 Detailed release notes and migration guides
  • 🎯 No spam - only version updates

📧 Get Release Notifications

Stay up to date with the latest chat widget releases. Subscribe to receive email notifications when new versions are available with new features, improvements, and bug fixes.

  • ✨ Early access to new features
  • 🐛 Important bug fixes and security updates
  • 📚 Detailed release notes and migration guides
  • 🎯 No spam - only version updates