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.
How it works
Section titled “How it works”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.
Add the widget to your site
Section titled “Add the widget to your site”-
Open Customers & messaging › Live chat and select Add website.
-
Enter the Domain without
https://, for exampleexample.com. Website Name is optional and only labels the widget in your list. Select Create Widget. -
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> -
Paste it just before the closing
</body>tag on every page where the chat should appear, then publish your site. -
Open your live site and check that the chat button appears.
-
Back in Pinlyx, select Verify on the widget.
Customise the widget
Section titled “Customise 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.
Let AI answer visitors
Section titled “Let AI answer visitors”-
Open the widget’s settings and go to AI replies.
-
Turn on Enable AI replies.
-
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.
-
Keep Show AI disclosure on so visitors know they are talking to an AI. It is recommended, and required in some regions.
-
Edit the Handoff message visitors see when the AI passes the chat to a person, or when they ask for one.
-
Select Save.
When the AI is unsure, it hands the chat to your team. See Human handoff.
Answer chats
Section titled “Answer chats”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.
Business plan options
Section titled “Business plan options”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.
Style it with CSS
Section titled “Style it with CSS”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:
| Selector | Element |
|---|---|
#crmsolid-container | Outer fixed wrapper (launcher and window) |
.crmsolid-window | The chat window when open |
.crmsolid-header | Header bar (avatar, name, close) |
.crmsolid-avatar | Agent avatar |
.crmsolid-name | Agent display name |
.crmsolid-status | Online status row |
.crmsolid-messages | Scrollable message thread |
.crmsolid-msg.agent | Agent message bubble |
.crmsolid-msg.user | Visitor message bubble |
.crmsolid-footer | Input row at the bottom |
.crmsolid-input | Text input |
.crmsolid-send | Send button |
.crmsolid-btn | Floating launcher button |
.crmsolid-prechat | Teaser bubble next to the launcher |
.crmsolid-channels | Row of channel chips |
.crmsolid-chip | One channel chip (WhatsApp, Telegram and so on) |
.crmsolid-brand | ”Powered by” footer |
.crmsolid-notif | Unread badge on the launcher |
For example:
.crmsolid-window { box-shadow: 0 24px 60px rgba(15, 23, 42, 0.25); }.crmsolid-msg.user { background: #2563eb; }Good to know
Section titled “Good to know”- 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.
Troubleshooting
Section titled “Troubleshooting”The widget stays Pending
Section titled “The widget stays Pending”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.
The chat button does not appear
Section titled “The chat button does not appear”Check that the snippet is on that page and was not changed while pasting. Then use Clear widget cache and reload the page.