Chatbot Version 2.0

📋 Select Chatbot Version:Latest (v2.0)Version 2.0Version 1.0.0

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.49)

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
• Stop Generating - Users can stop an in-flight reply and keep partial text
• Localized Loading Messages - Server loading copy in English, German, French, Chinese, Japanese, and Korean
• Detailed Loading Step Stack - Default branding shows stacked generation steps from the server
• 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.49"
  async>
</script>

Version Targeting

Major Version (Recommended)

<!-- Latest 2.x version -->
<script src="https://assets.ept.ai/chatbot/loader.js" data-version="2.0.49" 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

Parameter	Type	Default	Description
accessToken	string	-	Required. Authentication token from your backend
botName	string	'AI'	Display name for the bot
defaultQuestions	string[]	[]	Suggested questions to display

UI & Appearance

Parameter	Type	Default	Description
darkMode	boolean	false	Enable dark theme
hideLogo	boolean	false	Hide ept AI branding
fullWindow	boolean	false	Full browser window mode
inline	boolean	false	Inline embedding mode
parentDiv	string	null	Container element for inline mode
botImage	string	default	Custom bot avatar image URL
userImage	string	default	Custom user avatar image URL
headerIcon	string	'💬'	Custom header icon
headerChatName	string	'Chat'	Custom header chat name
showMaximizeButton	boolean	true	Show/hide maximize button
initiallyHidden	boolean	false	Start widget hidden by default
branding	string	''	Customer-specific branding (alphanumeric and hyphens)

Text & Messages

Parameter	Type	Default	Description
introText	string	"Hi, I'm {botName}..."	Welcome message displayed when chat loads
placeholderText	string	'Type your message here...'	Input field placeholder text
loadingText	string	''	Fallback loading text (server loading messages are localized separately)
networkErrorText	string	'Connection Lost...'	Network error message
disclaimerText	string	''	Custom disclaimer text
disconnectRetryMessage	string	'Connection lost. Please try again.'	Message shown when a stream is interrupted
retryLastMessageButtonText	string	'Retry last message'	Retry button label after an interrupted stream
tooltipCopyText	string	'Copy'	Tooltip text for copy button
tooltipLikeText	string	'Like'	Tooltip text for like/thumbs up button
tooltipDislikeText	string	'Dislike'	Tooltip text for dislike/thumbs down button

Advanced Features

Parameter	Type	Default	Description
enableFileUpload	boolean	false	Enable file upload functionality
enableChatPersistence	boolean	true	Enable/disable chat persistence in localStorage
advancedWelcomeText	object	null	Advanced welcome message with icon, title, and description
eptMetaData	object	null	Optional metadata for language, page context, and other use cases
includeCurrentPageUrl	boolean	false	When true, each message includes eptMetaData.current_page_url as the full page URL (query string included). A host-set current_page_url is kept.
version	string	'1.2.7'	Widget version identifier

Localization

Loading status during AI generation and the rest of the widget chrome use two different mechanisms.

Server-Side Loading Messages

Loading messages shown while the AI is generating a response are sent by the server. Set the language on eptMetaData:

window.eptAIConfig = {
  accessToken: 'your-token',
  eptMetaData: {
    knowledge_configuration: {
      language: 'ko'  // ISO 639-1 language code
    }
  }
};

Supported Languages:

Language	ISO 639-1 Code
English	en (default)
German	de
French	fr
Chinese	zh
Japanese	ja
Korean	ko

This is not the same as eptMetaData.locale used for context-aware chat.

Client-Side UI Strings

All other user-facing strings are not auto-translated from knowledge_configuration.language. Set them on window.eptAIConfig:

Parameter	Default	Description
tooltipCopyText	'Copy'	Copy button tooltip
tooltipLikeText	'Like'	Like button tooltip
tooltipDislikeText	'Dislike'	Dislike button tooltip
connectionStatusConnecting	'Connecting...'	Connection status label
connectionStatusConnected	'Connected'	Connection status label
connectionStatusDisconnected	'Disconnected'	Connection status label
connectionStatusError	'Error'	Connection status label
errorNoAccessToken	'Authentication required. Please refresh the page.'	Error message
errorConnectionLost	'Connection lost. Your message could not be sent.'	Error message
errorConnectionFailed	'Unable to connect. Please check your internet connection and refresh the page.'	Error message
errorSessionExpired	'Session expired. Please refresh the page to continue.'	Error message
errorReconnectionTimeout	'Connection timed out. Please try again.'	Error message
errorInvalidInput	'Invalid input. Please check your message and try again.'	Error message
errorGeneratorFailed	'Something went wrong while generating the response. Please try again.'	Error message
errorFeedbackFailed	'Failed to send feedback. Please try again.'	Error message
errorConfigurationFailed	'Configuration error. Please contact support.'	Error message
errorGeneric	'An unexpected error occurred. Please try again.'	Error message
refreshButtonText	'Refresh Page'	Refresh banner button text
refreshSessionExpiredText	'Your session has expired. Please refresh the page to get a new session.'	Refresh banner message
refreshAuthFailedText	'Authentication failed. Please refresh the page to reconnect.'	Refresh banner message
refreshTimeoutText	'The connection timed out. Please check your internet and refresh the page.'	Refresh banner message
refreshDefaultText	'Unable to establish connection after multiple attempts. Please check your internet connection and refresh the page.'	Refresh banner message
connectingTitle	'Connecting...'	Connecting overlay title

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';

Add ?chatbot_state=open to any page URL to auto-open the widget, including when initiallyHidden is true.

Recent Updates

Jump to versionSelect a version...Version 2.0.49 (Latest)Version 2.0.48Version 2.0.47Version 2.0.46Version 2.0.38Version 2.0.28Version 2.0.27Version 2.0.26Version 2.0.24Version 2.0.23Version 2.0.22Version 2.0.21Version 2.0.20Version 2.0.19Version 2.0.18Version 2.0.17Version 2.0.16Version 2.0.15Version 2.0.14Version 2.0.13Version 2.0.12Version 2.0.11Version 2.0.10Version 2.0.9Version 2.0.8Version 2.0.7Version 2.0.6Version 2.0.5Previous VersionsSearch releases

✨ New Features

• Current Page URL (opt-in) - New includeCurrentPageUrl parameter (default false)
  • When true, each message includes eptMetaData.current_page_url set to the full page URL, including the query string
  • A current_page_url already set on eptMetaData is kept

window.eptAIConfig = {
  accessToken: 'your-token',
  includeCurrentPageUrl: true
};

🐛 Bug Fixes

• Inline Math After Punctuation - KaTeX $...$ and \(...\) now render when they follow punctuation (em dash, en dash, slash, closing parenthesis, or closing quote), not only when surrounded by spaces

🔒 Security

• Updated prosemirror-view to 1.42.6 to address GHSA-c8x8-7fp4-3x9w

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