Overview
The Live Chat Widget is an embeddable chat interface that lets customers talk to Ensoras directly on your website. It provides real-time messaging, customizable appearance, and session tracking.
Navigate to Channels > Live Chat Widget in your project sidebar.
Enabling the Widget
Toggle the widget on at the top of the page. When enabled, the widget becomes available on your website (once you add the embed code).
Appearance
Theme and Position
| Setting | Description |
|---|---|
| Theme | Dark or Light mode for the widget |
| Position | Right or Left side of the screen |
Company Logo
Upload your company logo (max 1MB) to display in the widget header.
Messaging
| Setting | Description | Default |
|---|---|---|
| Display Name | The name shown in the widget header | Ensoras |
| Header Subtitle | Text shown below the display name | We typically reply instantly |
| Welcome Message | The first message shown when a customer opens the chat | Hi! How can I help you today? |
| Quick Replies | Clickable suggestion buttons for common questions | (empty) |
Quick Replies
Add suggested questions that appear as clickable buttons in the chat. Customers can click these to start a conversation quickly:
What are your shipping times?
How do I track my order?
What is your return policy?
Do you offer international shipping?
These reduce friction and help customers get started.
Footer & Privacy
| Setting | Description | Default |
|---|---|---|
| Show "Powered by Ensoras" | Display the Ensoras branding badge | On |
| Privacy Notice Text | Short privacy notice displayed in the widget | (empty) |
| Privacy Policy URL | Link to your full privacy policy | (empty) |
Advanced Settings
Ensoras Guidelines
Add channel-specific instructions for how Ensoras should respond in chat conversations. These are applied on top of the global communication style from Configuration:
Keep responses short and conversational since this is a chat.
Use 1-2 sentences per message. Avoid long paragraphs.
Customer Information
| Setting | Description |
|---|---|
| Require Email | Ask customers for their email before the chat starts |
When enabled, customers must provide their email address before they can send messages. This allows Ensoras to look up their order history and enables follow-up via email.
Domain Restrictions
| Setting | Description |
|---|---|
| Restrict to Specific Domains | Only allow the widget to load on specified domains |
| Allowed Domains | List of domains where the widget can be embedded |
Add your domain(s) to prevent unauthorized use of your widget:
yourdomain.com
shop.yourdomain.com
Wildcard patterns are supported (e.g., *.yourdomain.com). Leave disabled to allow any domain.
Response Timing
Optionally configure a short delay before Ensoras responds to create a more natural conversational feel.
Installing the Widget
After configuring and enabling the widget, add the embed code to your website. Place this script before the closing </body> tag on every page where you want the widget to appear:
<script src="https://ensoras.com/widget/your-project-slug.js"></script>
Replace your-project-slug with your actual project slug (found in your project settings).
Testing the Widget
- Enable the widget and configure your settings
- Install the embed code on a test page
- Open the page in your browser
- Click the chat bubble in the corner
- Enter your email (if required)
- Send a test message
- Verify Ensoras responds correctly
- Check that the ticket appears in your project Inbox
Best Practices
Match Your Brand - Choose a theme and upload your logo to make the widget feel like part of your site.
Write a Welcoming Message - A good welcome message sets expectations. "Hi! How can I help you today?" works for most cases.
Add 3-5 Quick Replies - Cover your most common questions. This helps customers get answers faster and reduces typing.
Require Email for Follow-up - Enable email collection if you need to follow up with customers or match conversations to existing records.
Use Domain Restrictions - In production, restrict the widget to your domains to prevent unauthorized embedding.
Next, learn about Identity Verification to protect customer account data.