Web Widget Settings
Learn how to configure your AI agent’s settings to optimize its performance and user experience.Core Settings
Enable/Disable Agent
Toggle your agent’s operational status. When disabled, the agent will
immediately stop working and won’t accept new queries.
Basic Configuration
Display Settings
Display Settings
- Scroll Animation - Enable/disable smooth scrolling during response generation
- Record Transcripts - Save interactions with the widget for future reference
- Enable Sound Effects - Play notification sounds when new messages arrive
- Forget Chat History - Prevent chat history from persisting on user devices
Startup Behavior
Startup Behavior
- Autostart With Popup - Automatically display the chat widget on page load - Proactive Message - Configure a welcome message that appears when the widget loads
Simple 1-line proactive message can be used instead of autostart widget
Message Configuration
Message Configuration
- Chat End Message - Customize the message shown when a chat session ends
- AI Introduction Message - Set the initial message users see when starting a chat
Advanced Settings
Interaction Controls
number
default:"1000"
Default delay between every message (Milliseconds)
number
default:"6000"
Time to wait before submitting final query to verify the user has finished
typing
Usage Limits
Monthly Interactions Limit
Set maximum number of interactions allowed per month (0 = unlimited)
Interactions Limit per User
Maximum interactions allowed per user or conversation session (0 = unlimited)
Monthly AI Tokens Limit
Set total monthly token limit for input and output (0 = unlimited)
Credits Limit
Set maximum credits consumption limit, monthly and annual periods (0 = unlimited)Setting limit for both periods will apply to both.
Technical Configuration
Connection Settings
Connection Settings
- Prefer HTTP instead of websockets - Advanced setting for connection method
- Does Know Threshold - Used for channels like Discord and Slack to determine AI response behavior
Handoff Settings
Handoff Settings
- Enable Handoff Popup - Toggle the top handoff popup display
- Fixed Handoff Popup - Requires organization assignment
- Always Show Handoff - Display handoff popup regardless of agent availability
Additional Features
Translation Options
- Enable AI Translation - Requires OpenAI API key in agency config
- Translate User Responses - Convert user messages to selected language
Input Methods
- Enable Speech-to-Text - Add voice input capability (1 credit per STT request)
- Enable Quick Upload Button - Allow file attachments with URL triggers
Custom Styling
Steps for locating and overriding CSS Properties.
- Right-click the element and choose Inspect.
- Identify the CSS Class in DevTools.
- Copy the class you are trying to change.
- Go to the dashboard.
- Paste the code into your Custom CSS section of your agent.
- Override the CSS.
CSS Customization
Best Practices
- Start with default settings and adjust based on user feedback - Monitor interaction limits to ensure optimal service availability - Test any custom CSS changes across different devices and browsers - Regularly review and update your AI introduction message
