Home Website Live Chat

Website Live Chat

Installing the chat widget
Super Admin
By Super Admin
2 articles

Installing chat on your website

Installing chat on your website The website chat widget is included free on every plan and does not take up a paid channel slot. Step 1. Create the inbox 1. Open Settings → Inboxes and add an inbox. 2. Choose Website. 3. Enter a name and your website address. 4. Configure the widget's look: colour, greeting, position. 5. Add agents. Step 2. Copy the code Once the inbox exists, the platform shows a code snippet that looks like this: <script> (function(d,t) { var BASE_URL="https://online.kulpunai.com"; 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.kulpunaiSDK.run({ websiteToken: 'YOUR_TOKEN', baseUrl: BASE_URL }) } })(document,"script"); </script> The token is filled in for you — copy the whole snippet from the interface rather than typing it out. Step 3. Add the code to your site Place the snippet just before the closing </body> tag on every page. WordPress Add it to the theme footer or through a plugin for custom <head>/<body> code. Tilda Site settings → More → HTML code inserted inside <body>. Bitrix, OpenCart, Shopify Add the snippet to the shared page template (footer) so the widget appears everywhere at once. Step 4. Test it Open your site, click the chat icon and send a message. It should appear under Conversations. If the widget does not appear - Confirm the code is on the page and not stripped by caching — clear the site and browser cache; - Check the browser console for script loading errors; - Make sure your domain is set in the inbox settings.

Last updated on August 23, 2026

Configuring the widget

Configuring the widget Open Settings → Inboxes and pick the Website inbox. Appearance - Widget colour — match your brand; - Position — left or right; - Launcher icon — how the chat button looks; - Welcome message — the first thing a visitor sees. Reply time Sets the expectation you show visitors: replies in minutes, in a few hours, or your own wording. Pre-chat form Collects details before the conversation starts: name, email, phone and custom fields. Each field can be required or optional. The form improves lead quality but reduces the number of conversations — turn it on only if you genuinely need the details. Extras - Attachments — let visitors send files; - Emoji picker — show the emoji selector; - Remove branding — hide the KulpunAi logo under the widget. This is a plan add-on, see Settings → Billing. Passing user details If a visitor is signed in on your website, pass their details to the widget so conversations are tied to a known customer: window.$kulpunai.setUser("user-123", { name: "Aigul", email: "aigul@example.com" }); Arbitrary data is passed separately: window.$kulpunai.setCustomAttributes({ plan: "premium", orders_count: 12 }); These values appear in the contact card next to the conversation. Controlling the widget from code window.$kulpunai.toggle("open"); // open the chat window.$kulpunai.toggle("close"); // close the chat window.$kulpunai.reset(); // end the session on sign-out Call reset() when a user signs out, otherwise the next visitor on that browser will see someone else's conversation.

Last updated on August 23, 2026