The chatworx Web Widget: Live Chat on Your Website in Minutes

Live chat is still one of the highest-converting support channels — customers get instant answers, agents can handle multiple conversations at once, and you capture leads that would otherwise bounce. The chatworx Web Widget gives you a production-ready live chat experience that you can install on any website in under five minutes.

One Script Tag, Full Feature Set

To add the widget to your site, paste a single <script> tag into your HTML. That's it. No heavy SDK to configure, no build step required.

<script>
  (function(d, t) {
    var BASE_URL = "https://app.chatworx.cc";
    var g = d.createElement(t), s = d.getElementsByTagName(t)[0];
    g.src = BASE_URL + "/packs/js/sdk.js";
    g.defer = true;
    g.async = true;
    s.parentNode.insertBefore(g, s);
    g.onload = function() {
      window.chatwootSDK.run({
        websiteToken: 'YOUR_TOKEN',
        baseUrl: BASE_URL
      });
    };
  })(document, "script");
</script>

Once loaded, the widget appears as a launcher in the corner of your page. Visitors can open it, type a message, and connect with your team instantly.

Fully Customisable Appearance

Your widget should feel like part of your product, not a bolt-on. From the chatworx dashboard you can customise:

Brand colour — the widget accent colour matches your brand palette
Widget position — bottom-left or bottom-right
Launcher icon — chat bubble or custom icon
Welcome title and tagline — shown before the visitor starts a conversation
Agent availability message — different copy for online vs. offline hours

Dark mode is supported automatically — the widget respects the visitor's system preference.

Visitor Context and Identity

For logged-in users, you can pass identity attributes via the SDK so your agents always know who they're talking to:

window.$chatworx.setUser('user_123', {
  name: 'Jane Smith',
  email: 'jane@example.com',
  plan: 'Pro',
  accountId: 'acct_456'
});

These attributes appear in the contact panel alongside conversation history, so agents can jump straight into helping without asking for basic information.

Smart Routing

The Web Widget is backed by a full chatworx inbox, which means all the same routing rules apply:

Round-robin assignment — distribute incoming chats evenly across available agents
Capacity limits — cap how many simultaneous chats each agent handles
Automation rules — route conversations by URL, visitor attributes, or message content
Team routing — send conversations from your pricing page to sales, from your docs to support

Pre-Chat Forms and Email Collection

When no agents are online, the widget can prompt visitors to leave their email address so you can follow up. Pre-chat forms let you collect a name, email, or any custom field before the conversation starts — giving your team context before they type the first reply.

CSAT Built In

chatworx CSAT surveys work seamlessly with the Web Widget. When a conversation is resolved, the widget automatically prompts the visitor for a rating — no separate survey tool required. Results feed directly into your CSAT analytics dashboard.

Chatbot Integration

Pair the Web Widget with the chatworx Chatbot Builder to handle common questions automatically. A bot can greet visitors, collect information, answer FAQs, and hand off to a human agent when needed — all within the same widget experience.

Getting Started

Go to Settings → Inboxes → New Inbox
Select Web Widget
Configure appearance, routing, and availability settings
Copy the script snippet and paste it into your website's <head> or before the closing </body> tag
Your widget is live

The entire setup takes under five minutes. From that point, every chat from your website lands in your chatworx inbox alongside conversations from every other channel — one unified view for your whole team.

Ready to add live chat to your website? Create your first Web Widget inbox today under Settings → Inboxes.