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.