Help Center
Get help and find answers to common questions about Minimal.
Browse by Category
Getting Started
Learn the basics and set up Minimal
Integration Guide
Platform-specific setup instructions
Customization
Personalize appearance and behavior
Analytics
Understanding your metrics
Best Practices
Writing effective conversations
Conversation Design
Design natural conversation flows
Troubleshooting
Common issues and solutions
Coming soonAPI Reference
Developer documentation
Getting Started with Minimal
Create Your Account
Sign up at minimal.lat with your email. You'll get access to the dashboard where you can manage all your sites.
Add Your Website
Click "Add New Site" in your dashboard, enter your website URL, and you'll receive a unique Site ID. This ID connects Minimal to your website.
Install the Script
Copy the provided script and paste it before the closing </body> tag on your website. The widget will appear automatically.
<script src="https://minimal.lat/embed.js" data-site-id="your-site-id"></script>Customize & Launch
From your dashboard, customize colors, position, greeting messages, and more. Changes apply instantly – no need to update your code!
Integration Guide
Choose your platform and follow the installation instructions. Need help? Check our detailed integration page.
Web Platforms
Install Minimal on any website with a simple one line script tag. Works with HTML, JavaScript, and all modern frameworks including React, Vue, Angular, and Next.js.
E-commerce & CMS
Native integrations for popular platforms with easy dashboard configuration.
- WordPress - Plugin from repository
- Webflow - Custom code integration
- Framer - Custom code component
- Wix - Custom code integration
- Squarespace - Code injection
Dashboard Customization
Customize your widget appearance directly from the Minimal dashboard - no code required.
Chat Button
Control where and how the chat button appears on your website.
- Button Position: Bottom Right, Bottom Left, Top Right, Top Left
- Button Color: Choose any color to match your brand
Brand Colors
Make the widget feel like a native part of your website.
- Primary Color: Main brand color for accents and highlights
- Secondary Color: Secondary brand color for additional styling
Features
Toggle features on or off to customize the user experience.
- Welcome Phrases: Display rotating welcome messages before user starts chatting
Easy to Use
All customization options are available in your dashboard under Widget Configuration. Changes are applied instantly - no need to update any code on your website.
Advanced Script Customization
For developers who need more control, advanced script configuration options will be available soon.
Data Attributes
Customize Minimal directly in the script tag using data attributes for position, theme, language, and more.
JavaScript API
Full programmatic control with JavaScript configuration objects for advanced use cases.
Understand Your Analytics
Get insights into how visitors interact with your conversational interface.
Key Metrics
Track your most important conversation metrics at a glance:
- Total Conversations: Number of chats in the last 30 days
- Active Conversations: Currently ongoing chats
- Total Messages: All messages exchanged over time
- Avg Messages per Conversation: Conversation depth indicator
Conversations Over Time
Visualize conversation trends with an interactive line chart showing daily conversation volume over the past month.
Status Distribution
See how your conversations end with a breakdown of:
- Completed: Successfully finished conversations
- Active: Ongoing conversations
- Abandoned: Conversations left without resolution
Sentiment Analysis
Understand user satisfaction through automatic sentiment detection:
- Positive: Happy and satisfied interactions
- Neutral: Informational exchanges
- Negative: Frustrated or unsatisfied users
Engagement Trend
Monitor your Average Engagement Score over time to see how well your AI is connecting with visitors.
Top Intents & Token Usage
Discover what users are asking about most and track your token consumption to manage usage effectively.
Writing Effective Conversations
Craft messages that engage users and drive conversions.
Best Practices
- ✓ Keep greetings warm and conversational, not corporate
- ✓ Ask open-ended questions to understand user needs
- ✓ Provide quick replies for common questions
- ✓ Use your brand's voice and personality
- ✓ Set expectations for response times
What to Avoid
- ✗ Generic greetings like "Hello" or "Welcome"
- ✗ Overly formal or robotic language
- ✗ Asking for information you already have
- ✗ Too many messages at once (overwhelming users)
- ✗ Unclear calls-to-action
Conversation Design
Design conversation flows that feel natural and guide users to their goals.
Natural Flow
Keep conversations feeling human and helpful. Use short messages, ask one question at a time, and acknowledge user responses before moving forward.
Quick Replies
Offer suggested responses for common questions. This speeds up interactions and helps users who aren't sure what to ask.
Smart Routing
Guide users to the right information based on their questions. Use context from previous messages to provide relevant follow-ups.
Clear CTAs
Every conversation should have a purpose. Make it easy for users to take the next step with clear, actionable suggestions.
Troubleshooting
Common issues and how to resolve them.
Widget Not Appearing
If the widget doesn't show up on your site:
- Verify the script is placed before the closing
</body>tag - Check that your Site ID is correct in the dashboard
- Ensure JavaScript is enabled in your browser
- Clear your browser cache and hard reload (Ctrl+Shift+R or Cmd+Shift+R)
- Check browser console for any error messages
Widget Position Issues
If the widget appears in the wrong position or overlaps other elements:
- Adjust the position setting in your dashboard (bottom-right, bottom-left, etc.)
- Check for CSS conflicts with high z-index values on your site
- Use custom CSS to override positioning if needed
- Try different offset values to avoid overlapping with other fixed elements
Conversations Not Saving
If conversations aren't appearing in your dashboard:
- Verify you're logged into the correct account
- Check that you're viewing the correct site in the dashboard
- Ensure your plan hasn't reached conversation limits
- Allow a few minutes for data synchronization
- Contact support if the issue persists after 15 minutes
Styling Not Applied
If custom colors or styles aren't showing:
- Changes in the dashboard apply instantly - no code updates needed
- Clear browser cache to see latest styling changes
- Check that custom CSS isn't overriding your settings
- Verify color values are in valid hex format (e.g., #10b981)
API Reference Coming soon
JavaScript API for advanced control and customization.
Widget Control Methods
// Open the widget
Minimal.open();
// Close the widget
Minimal.close();
// Toggle widget state
Minimal.toggle();
// Check if widget is open
const isOpen = Minimal.isOpen(); // returns boolean
// Destroy the widget instance
Minimal.destroy(); Event Tracking
// Track custom events
Minimal.trackEvent('event_name', {
customData: 'value',
userId: '12345'
});
// Set user context
Minimal.setContext({
userId: 'user_123',
email: 'user@example.com',
plan: 'premium'
});
// Identify user
Minimal.identify({
userId: 'user_123',
name: 'John Doe',
email: 'john@example.com'
}); Event Listeners
// Listen for widget events
window.addEventListener('minimal:open', () => {
console.log('Widget opened');
});
window.addEventListener('minimal:close', () => {
console.log('Widget closed');
});
window.addEventListener('minimal:message', (event) => {
console.log('Message sent:', event.detail);
});
window.addEventListener('minimal:ready', () => {
console.log('Widget initialized');
}); Configuration Updates
// Update configuration at runtime
Minimal.updateConfig({
theme: 'dark',
position: 'bottom-left',
greeting: 'New greeting message'
});
// Get current configuration
const config = Minimal.getConfig(); Need More Help?
Can't find what you're looking for? Our support team is here to help.