Try Free

Help Center

Get help and find answers to common questions about Minimal.

Getting Started with Minimal

1

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.

2

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.

3

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>
4

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.

Coming soon

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.

Coming soon

Data Attributes

Customize Minimal directly in the script tag using data attributes for position, theme, language, and more.

Coming soon

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.