Skip to content

Live chat

Live chat puts a chat widget on your website. Visitors open it from a button in the corner of the page, and their messages arrive in Contacts like any other conversation, where you or an AI agent answer in real time.

Plan
Pro and Business

Each website you add gets its own widget with its own id. You paste a short script into your site, and the script loads the widget on every page that has it. Changes you make in Pinlyx (colours, texts, AI, hours) reach the live widget when you save them, with no change to your site.

A widget starts as Pending. When you select Verify, Pinlyx loads the home page of the domain you registered and looks for the widget’s id in its HTML. Once it finds it, the widget is live and the Pending badge disappears.

Pro includes one widget. Business has no limit.

  1. Open Customers & messaging › Live chat and select Add website.

  2. Enter the Domain without https://, for example example.com. Website Name is optional and only labels the widget in your list. Select Create Widget.

  3. On the new widget, select Show install code and then Copy snippet. The snippet looks like this, with your widget id at the end:

    <script>
    (function(w,d,s,u){
    var g=d.createElement(s),h=d.getElementsByTagName(s)[0];
    g.async=true; g.src=u; h.parentNode.insertBefore(g,h);
    })(window,document,'script','https://api.pinlyx.com/js/widget.js?id=YOUR_WIDGET_ID');
    </script>
  4. Paste it just before the closing </body> tag on every page where the chat should appear, then publish your site.

  5. Open your live site and check that the chat button appears.

  6. Back in Pinlyx, select Verify on the widget.

Select Customize on a widget to open its settings. A live preview shows the chat, the launcher, the offline view and the pre-chat form as you change things. Select Save to publish your changes to your site.

  • Style and Launcher: theme colour, header style, bubbles, font, dark mode, position (bottom left or right), size, button shape and icon, and a brand logo.
  • Messages and Languages: the welcome message, a teaser bubble next to the launcher, a reply time note, the widget language (or Auto-detect from the visitor’s browser) and translated texts per language.
  • Agent: the display name, status message and avatar visitors see.
  • FAQ: quick questions visitors can tap. Give a question an answer for an instant reply, or leave the answer blank to send it to your AI or team.
  • Forms: a pre-chat form that asks for name, email or phone before the chat starts, a consent notice, and a 1 to 5 star satisfaction rating after the chat. Values from the form are saved to the visitor’s contact.
  • In the chat: let visitors send files and email themselves the transcript.
  • Business hours and When offline: a weekly schedule with a time zone. Outside it the widget shows your offline message and can ask for an email address.
  • Channels: add your WhatsApp number, Telegram username, Messenger username or email address so visitors can reach you there instead.
  • Install: the embed code, and Force visitors to load latest version if a visitor’s browser keeps an old copy.
  1. Open the widget’s settings and go to AI replies.

  2. Turn on Enable AI replies.

  3. In Answering agent, pick the AI agent that should answer, or leave Auto to use your highest-priority live chat agent. Make sure that agent is active and has your knowledge.

  4. Keep Show AI disclosure on so visitors know they are talking to an AI. It is recommended, and required in some regions.

  5. Edit the Handoff message visitors see when the AI passes the chat to a person, or when they ask for one.

  6. Select Save.

When the AI is unsure, it hands the chat to your team. See Human handoff.

New chats arrive in Contacts with the platform Live Chat. Open one to reply; the visitor sees your answer in the widget straight away. Saved replies can be inserted from the composer.

The Ratings view on the Live chat page lists the satisfaction ratings visitors left, and Analytics shows how the widget performs over time.

If you also want to see who is browsing your site before they start a chat, set up Live visitors.

These options need the Business plan:

  • Triggers: open the chat with a message when a visitor matches a condition: Page URL contains, Time on page, Exit intent or Returning visitor. Up to 10 triggers per widget.
  • Waiting visitor alert: a Telegram alert when a visitor waits longer than the minutes you set for a human reply (0 turns it off, the maximum is 1440). The alert comes through the Telegram CRM bot.
  • Hiding the Show “Powered by” branding line at the bottom of the chat.

Custom CSS in the widget settings takes up to 10,000 characters. Show class reference lists the selectors below. Every selector you write is prefixed with #crmsolid-container, so your rules cannot affect the rest of your page. @import and remote url() calls other than https and data:image are removed.

These class names are a stable public API. They keep working across widget updates:

SelectorElement
#crmsolid-containerOuter fixed wrapper (launcher and window)
.crmsolid-windowThe chat window when open
.crmsolid-headerHeader bar (avatar, name, close)
.crmsolid-avatarAgent avatar
.crmsolid-nameAgent display name
.crmsolid-statusOnline status row
.crmsolid-messagesScrollable message thread
.crmsolid-msg.agentAgent message bubble
.crmsolid-msg.userVisitor message bubble
.crmsolid-footerInput row at the bottom
.crmsolid-inputText input
.crmsolid-sendSend button
.crmsolid-btnFloating launcher button
.crmsolid-prechatTeaser bubble next to the launcher
.crmsolid-channelsRow of channel chips
.crmsolid-chipOne channel chip (WhatsApp, Telegram and so on)
.crmsolid-brand”Powered by” footer
.crmsolid-notifUnread badge on the launcher

For example:

.crmsolid-window { box-shadow: 0 24px 60px rgba(15, 23, 42, 0.25); }
.crmsolid-msg.user { background: #2563eb; }
  • The domain you register is used for Verify. Add a separate widget for each site you want to track separately.
  • Clear widget cache in the settings header forces every visitor to fetch the newest widget. Use it if a change does not show on your site after saving.
  • Deleting a widget cannot be undone. Remove the snippet from your site afterwards.

Make sure the snippet is in the HTML of the domain’s home page, that the domain in Pinlyx matches your site exactly, and that the site is published. Then select Verify again.

Check that the snippet is on that page and was not changed while pasting. Then use Clear widget cache and reload the page.