Agent Settings
Configure and customize your AI agent’s behavior and functionality
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
According to Meta’s requirements, you MUST declare that users will be interacting with an AI
Advanced Settings
Interaction Controls
Default delay between every message (Milliseconds)
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
Only modify if you understand the implications for UI rendering
- 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.
Use !important sparingly—only if you need to override higher-specificity rules.
CSS Customization
Custom CSS allows you to match your agent’s appearance to your brand and website design.
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
Always test significant setting changes in a development environment before applying them to your live agent.