Guides & Documentation
Everything you need to master Minimal and maximize your website's conversions.
Browse Guides by Topic
Quick Start
Get up and running in minutes with our step-by-step installation guide.
Customization
Make Minimal match your brand with custom colors, positions, and messages.
Content & Copy
Write effective messages that drive engagement and conversions.
Conversation Design
Design conversation flows that feel natural and helpful.
Analytics & KPIs
Track what matters and make data-driven improvements.
Advanced Features
Unlock powerful integrations and programmatic control.
Quick Start Guide
Follow these three simple steps to add Minimal to your website:
Step 1: Sign Up & Create Project
Visit minimal.lat and create a free account. Once logged in, click "Add New Site" and enter your website URL. You'll instantly receive a unique Site ID.
Step 2: Install the Script
Copy the installation script from your dashboard and paste it before the closing </body> tag on your website:
<script src="https://minimal.lat/embed.js" data-site-id="your-site-id"></script> Step 3: Customize & Launch
The widget appears automatically! Customize its appearance, greeting message, and behavior from your dashboard. All changes apply instantly without touching your code.
Customization Options
Personalize Minimal to match your brand perfectly:
Basic Configuration
Configure Minimal directly in the script tag using data attributes:
<script
src="https://minimal.lat/embed.js"
data-site-id="your-site-id"
data-position="bottom-right"
data-theme="auto"
data-primary-color="#10b981"
></script> Advanced JavaScript Configuration
For more control, use the JavaScript API:
window.MinimalConfig = {
siteId: 'your-site-id',
position: 'bottom-right',
theme: 'auto',
greeting: 'Hi! How can we help you today?',
placeholder: 'Type your message...',
// Visual customization
customColors: {
primary: '#10b981',
background: '#ffffff',
text: '#1f2937'
},
// Behavior options
autoOpen: false,
autoOpenDelay: 5000,
hideOnPages: ['/checkout'],
collectEmail: true
}; 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.
Tracking Key Metrics
Monitor these essential KPIs to measure success:
Engagement Rate
Percentage of visitors who interact with the widget
15-25%
Industry benchmark
Conversation Quality
Average messages per conversation
4-6
Optimal range
Lead Capture
Percentage of conversations that collect contact info
30-40%
Good performance
User Satisfaction
Post-conversation rating scores
4.5+
Out of 5 stars
Advanced Integration
Unlock powerful features with the JavaScript API:
Widget Control Methods
Control the widget programmatically:
// 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 Event Tracking
Track custom events and set user context:
// 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 to widget events in your application:
// Listen for widget open
window.addEventListener('minimal:open', () => {
console.log('Widget opened');
gtag('event', 'chat_opened');
});
// Listen for widget close
window.addEventListener('minimal:close', () => {
console.log('Widget closed');
});
// Listen for messages
window.addEventListener('minimal:message', (event) => {
console.log('Message sent:', event.detail);
});
// Widget ready
window.addEventListener('minimal:ready', () => {
console.log('Widget initialized');
}); Need More Help?
Our documentation covers everything from basic setup to advanced integrations.