Getting Started with Liverick

Liverick is a complete customer communication platform that combines live chat, email ticketing, and intelligent bug tracking. Manage all your brands from a single dashboard.

Quick Start Guide

Get up and running with Liverick in just a few minutes. Follow these steps:

Create a Brand

Brands are the core of Liverick's multi-brand system. Each brand represents a separate website or client that you want to manage.

Brand Settings

Customize your brand to match your identity and configure how it works.

Switch Between Brands

If you manage multiple brands or websites, you can easily switch between them.

Click on the brand dropdown in the top navigation bar and select the brand you want to work with. All data (conversations, tickets, bugs) will update to show the selected brand's information.

Live Chat Overview

Live Chat allows you to communicate with your website visitors in real-time. Answer questions, provide support, and convert visitors into customers.

Chat Widgets

Chat widgets are the embeddable components that appear on your website, allowing visitors to start conversations.

Creating a Chat Widget

1. 1 Go to Settings > Chat Widgets
2. 2 Click "Create New Widget"
3. 3 Configure the widget settings (name, language, messages)
4. 4 Customize the welcome message and offline message
5. 5 Save the widget

Embedding the Widget

After creating a widget, copy the embed code and add it to your website:

<script src="https://api.liverick.com/widget/loader.js"></script>
<script>
  LiverickWidget.init({
    propertyId: 'YOUR_PROPERTY_ID',
    widgetId: 'YOUR_WIDGET_ID'
  });
</script>

Configuration Options

lang: 'fr'

userData: {
  name: 'John Doe',
  email: 'john@example.com',
  phone: '+1 555-1234',
  organization: 'Acme Inc'
}

Replace YOUR_BRAND_ID and YOUR_WIDGET_ID with the values from your widget settings. The embed code is also available to copy directly from the widget settings page.

JavaScript API

After the widget is loaded, you can use the JavaScript API to control it programmatically.

LiverickWidgetAPI.open();

LiverickWidgetAPI.close();

LiverickWidgetAPI.toggle();

// Inject custom data for the current visitor
LiverickWidgetAPI.setCustomData([
  { label: 'User ID', value: '12345' },
  { label: 'Plan', value: 'Premium' },
  { label: 'Account Status', value: 'Active' }
]);

LiverickWidgetAPI.addCustomData('Cart Total', '$99.99');

LiverickWidgetAPI.clearCustomData();

const data = LiverickWidgetAPI.getCustomData();
console.log(data);

Triggers

Triggers allow you to automatically send proactive messages to visitors based on certain conditions. This is great for engaging visitors who might need help.

Managing Conversations

The Chat interface provides a powerful way to manage all your visitor conversations.

Assignment & Transfer

Conversations can be assigned to agents and transferred between team members for efficient workflow management.

Conversation Takeover

To prevent conflicts when multiple agents view the same conversation:

Ticketing (Help Desk) Overview

The ticketing system allows you to manage customer support requests via email. All emails sent to your support address are automatically converted into tickets.

Email Setup

Configure your email settings to start receiving tickets.

Managing Tickets

The Inbox provides a clean interface to manage all your support tickets.

Ticket Statuses:

Auto-reply & Auto-close

Bug Tracker Overview

The Bug Tracker is an intelligent system that captures detailed technical context when users report bugs, helping you debug issues faster.

Automatically Captured Information:

Bug Tracker Widgets

Create widgets that allow your users to easily report bugs directly from your website.

Create a bug widget in Settings > Bug Tracker, then add the embed code to your website. Users will see a button to report bugs, and all the technical context will be captured automatically.

<script src="https://api.liverick.com/widget/bug-loader.js"></script>
<script>
  LiverickBugWidget.init({
    propertyId: 'YOUR_PROPERTY_ID',
    widgetId: 'YOUR_BUG_WIDGET_ID'
  });
</script>

Early Error Capture

Add this snippet at the very top of your HTML (before any other script) to capture JavaScript errors that occur before the widget loads.

Optional - Only needed if you want to capture errors that occur before the widget loads.

<script>window.__liverickErrors=[];window.addEventListener('error',function(e){window.__liverickErrors.push({m:e.message,f:e.filename,l:e.lineno,t:Date.now()})})</script>

Configuration Options

lang: 'fr'

userData: {
  name: 'John Doe',
  email: 'john@example.com',
  phone: '+1 555-1234',
  organization: 'Acme Inc'
}

JavaScript API

After the widget is loaded, you can use the JavaScript API to control it programmatically.

LiverickBugWidget.open();

LiverickBugWidget.close();

LiverickBugWidget.prefill({
  name: 'John Doe',
  email: 'john@example.com'
});

// Inject custom data when user clicks the bug button
document.getElementById('report-bug').addEventListener('click', () => {
  LiverickBugWidget.setCustomData([
    { label: 'User ID', value: '12345' },
    { label: 'Plan', value: 'Premium' },
    { label: 'Feature', value: 'Dashboard' }
  ]);
  LiverickBugWidget.open();
});

LiverickBugWidget.addCustomData('Cart Total', '$99.99');

LiverickBugWidget.clearCustomData();

LiverickBugWidget.setLanguage('fr');

Managing Bug Reports

The Bugs section provides a timeline view of all bug reports with their full technical context.

Bug Statuses:

Invite Team Members

Add team members to help manage your customer support across all your brands.

1. 1 Go to Settings > Users
2. 2 Click "Invite User"
3. 3 Enter their email address
4. 4 Select their role (Admin or Agent)
5. 5 Configure their permissions (Chat, Tickets, Bugs)
6. 6 Click "Send Invitation"

Roles & Permissions

Control what each team member can access and do within the platform.

Agent Profiles

Agents can customize their profile to personalize how they appear to visitors.

Push Notifications

Never miss an important message with push notifications delivered directly to your browser or mobile device.

1. 1 Go to your Profile > Notification Preferences
2. 2 Click "Enable Push Notifications"
3. 3 Allow notifications when your browser prompts you
4. 4 Test with the "Send Test Notification" button

Notification Settings

Customize how and when you receive notifications.