Настройка виджета

Обновлено 23 августа 2026

Настройка виджета

Откройте Настройки → Источники и выберите источник типа «Сайт».

Внешний вид

  • Цвет виджета — подберите под фирменный стиль;
  • Положение — слева или справа;
  • Иконка запуска — вид кнопки чата;
  • Приветственное сообщение — первое, что видит посетитель.

Время ответа

Показывает посетителю ожидаемую скорость ответа: «обычно отвечаем в течение нескольких минут», «в течение нескольких часов» или свой текст.

Форма до чата

Позволяет собрать данные до начала переписки: имя, email, телефон и произвольные поля. Каждое поле можно сделать обязательным или необязательным.

Форма повышает качество контактов, но снижает число обращений — включайте её, если контактные данные действительно нужны.

Дополнительно

  • Вложения — разрешить посетителям отправлять файлы;
  • Эмодзи — показывать выбор эмодзи;
  • Убрать брендинг — скрыть логотип KulpunAi под виджетом. Опция подключается в тарифе (Настройки → Платёж → Дополнительные опции).

Передача данных о пользователе

Если посетитель авторизован на вашем сайте, передайте его данные в виджет — тогда обращения будут привязаны к конкретному клиенту:

window.$kulpunai.setUser("user-123", {
  name: "Айгуль",
  email: "aigul@example.com"
});

Произвольные данные передаются отдельно:

window.$kulpunai.setCustomAttributes({
  plan: "premium",
  orders_count: 12
});

Эти значения появятся в карточке контакта справа от переписки.

Управление виджетом из кода

window.$kulpunai.toggle("open");   // открыть чат
window.$kulpunai.toggle("close");  // закрыть чат
window.$kulpunai.reset();          // завершить сессию при выходе пользователя

Вызывайте reset() при выходе пользователя из аккаунта, иначе следующий посетитель того же браузера увидит чужую переписку.