Try Free

Guides & Documentation

Everything you need to master Minimal and maximize your website's conversions.

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.