How to Add the Ensoras Chat Widget to Your Store

This guide walks through setting up the Ensoras chat widget on your site. The configuration takes about 15 minutes inside Ensoras and another 5 minutes to install the embed snippet. Most of the time goes into deciding what you want the widget to look and sound like.

Before you start

You'll need:

• An active Ensoras project
• Admin access to your store theme (Shopify Admin, WooCommerce dashboard, or your CMS)
• About 20 minutes
• Optional: your brand logo as a PNG or SVG file (max 1 MB)

Step 1: Open the Live Chat Widget page

In your Ensoras admin panel, go to Channels > Live Chat Widget. The page is a single form divided into sections. The toggle at the top enables the widget; leave it on as you configure (you control where the widget appears via the embed snippet, so an enabled-but-not-embedded widget is harmless).

Step 2: Configure the appearance

The Appearance section controls the visual look:

• Widget Theme, Dark or Light. Pick whichever blends better with your site. Light is the safe default for most ecommerce sites; Dark looks sharp on premium / fashion brands.
• Widget Position, Bottom-right is the most familiar to customers (90%+ of chat widgets sit there). Bottom-left is fine if you have something else at bottom-right (a sticky footer or another tool). Top positions are unusual and we don't recommend them unless you have a specific reason.

Upload your logo in the Logo field. The widget shows it in the header. If you don't upload one, the widget shows a default icon.

Step 3: Set the messaging

The Messaging section controls what customers read:

• Ensoras Name, what the customer sees as the chat counterpart. By default this is "Ensoras." Many brands change it to a person's name ("Sam" / "Maya") or a brand-aligned name ("Acme Helper"). The AI doesn't know what name you picked beyond what the customer sees in the header.
• Header Subtitle, appears under the name in the widget header. The default ("We typically reply instantly") sets the right expectation if your AI is configured to reply quickly.
• Welcome Message, the first message the customer sees when they open the widget. Keep it short (one or two sentences). Common patterns: "Hi! How can we help?" / "Hi! Ask me about your order, returns, or anything else."

Step 4: Add quick-reply suggestions

Quick suggestions are the buttons customers can tap instead of typing. Pick 3–5 covering your highest-volume questions:

• "Where's my order?"
• "I need to return something"
• "How do I cancel my subscription?"
• "What's your shipping policy?"
• "Talk to a human"

These dramatically reduce the cold-start friction. A customer who taps "Where's my order?" gets the AI to start that flow immediately, instead of typing a free-form message and hoping the AI parses it correctly.

You can edit, reorder, or remove suggestions any time. They take effect immediately on the next page load.

Step 5: Configure branding and privacy

The Footer & Privacy section controls the bottom of the widget:

• Show Branding, toggles the small "Powered by Ensoras" label. Default on. Turn it off if you'd rather present the widget as fully your own.
• Privacy Agreement Text, the disclaimer text shown to customers (often something like "By chatting, you agree to our privacy policy"). Edit to match your brand voice.
• Privacy URL, where the privacy link points. Defaults to ours; change to your own privacy policy.

Step 6: (Optional) Tighten advanced settings

The Advanced section is where the operationally important toggles live:

• AI Guidelines, channel-specific instructions for the AI when answering chat messages. Useful for setting a different tone vs email. ("Keep replies under 3 sentences. Use emojis sparingly. Match the customer's energy.")
• Require Email, gates the conversation behind an email collection step. Higher data quality, slightly lower engagement.
• Restrict Domains + Allowed Domains, limit which sites can run the widget. Useful when you want to keep development environments from generating real tickets. List your production domains (yourstore.com, www.yourstore.com); requests from anywhere else get blocked.
• Min/Max Response Delay (seconds), adds a random wait before the AI sends each reply. The default of zero means instant replies. Some teams prefer a 1–3 second delay so the experience doesn't feel suspiciously fast.

Step 7: Save and grab the embed snippet

Click Save Settings. The widget configuration is now active in Ensoras.

To install on your site, you need the embed snippet. There's a small JavaScript tag that loads the widget; it's the same snippet for everyone but each project has a unique identifier baked in. Find it on the Live Chat Widget page (look for "Embed code" or a similar label) and copy the snippet to your clipboard.

Step 8: Install on your site

Shopify

In Shopify Admin, go to Online Store > Themes. Click the three-dot menu on your active theme, then Edit code.

In the file tree on the left, find Layout > theme.liquid. Click to open it.

Scroll to the bottom and find the closing </body> tag. Paste the Ensoras snippet on a new line just before it. Save.

The widget is now live on every page of your store. Visit your storefront in an incognito tab and you should see the chat bubble appear in the position you configured.

WooCommerce

The cleanest path is via your theme's footer template. In WordPress Admin, go to Appearance > Theme File Editor, find footer.php for your active theme, and paste the snippet just before the closing </body> tag.

If your theme has a built-in "Custom Code" or "Header / Footer Scripts" section (many premium themes do), use that instead, it survives theme updates better than editing template files directly.

Custom site

Paste the snippet into whatever global footer or layout file your site uses, just before the closing </body> tag. If you use a static site generator (Next.js, Astro, etc.), put it in the layout component that wraps every page.

Step 9: Test on a live page

Open your storefront in an incognito tab and click the chat bubble. Send a real message: "Hi, can you check on my order?" or whatever maps to one of your configured workflows.

If the AI responds, the widget is wired correctly. Check your Ensoras admin panel, the conversation should appear as a new ticket within seconds.

Common issues

The widget doesn't appear. Check three things in order: (1) the widget is enabled in your Ensoras admin; (2) the embed snippet was pasted into a page that's actually loading on your site (a saved-but-not-published theme won't show it); (3) Allowed Domains in the Advanced section actually includes the domain you're testing on.

The widget appears but messages don't reach Ensoras. Usually a domain restriction issue. Either disable Restrict Domains while you debug, or add your test domain to the Allowed Domains list.

The widget covers a Shopify "Add to Cart" button or similar important UI. Switch the widget position from bottom-right to bottom-left (or vice versa). Most theme-vs-widget collisions resolve with a position change.

The AI replies too slowly. Check the Min/Max Response Delay in the Advanced section. Some teams accidentally set this in the multi-second range when they meant zero.

What's next

After the widget is installed:

• Connect Shopify so the AI can answer order-related chat messages with live data.
• Upload your knowledge base so the AI can answer policy questions (shipping, returns, sizing) without escalating.
• Set up email-based support to cover async questions alongside the real-time chat.

The chat widget shines when it's paired with the rest of the stack. On its own it's a smarter bubble; combined with order data and a clean knowledge base, it resolves the bulk of pre-purchase and post-purchase questions without human involvement.

Sources

• Google, Page Experience report and Core Web Vitals, helpful context on how third-party widgets affect perceived page performance and what to watch for after install.