Lalexi
РуководствоПодключения

Веб-чат на сайте

Как добавить виджет чата Lalexi на сайт: создать источник, вставить код на страницы и настроить внешний вид, приветствие и допустимые домены.

Веб-чат — это кнопка чата в углу вашего сайта. Посетитель пишет прямо со страницы, а разговор приходит в общий список чатов, как переписка из любого мессенджера. Ключей от сторонних платформ не нужно: канал целиком наш.

Создаёт канал администратор пространства: раздел Настройки → Источники сотруднику с ролью «оператор» не виден — см. Команда.

Шаг 1. Создайте источник

  1. Откройте Настройки → Источники (Settings → Inboxes) и нажмите Добавить источник (Add Inbox).

  2. Выберите канал Сайт (Website).

    Выбор канала при создании источника

  3. Заполните форму:

    Форма создания веб-чата

    ПолеЧто вводить
    Website NameНазвание канала в списке чатов, например «Сайт».
    Website DomainДомен вашего сайта, например example.com.
    Widget ColorЦвет кнопки и шапки виджета — обычно фирменный.
    Welcome HeadingЗаголовок в открытом чате: «Здравствуйте!».
    Welcome TaglineСтрока под заголовком: чем вы поможете.
    Enable channel greetingАвтоприветствие в ответ на первое сообщение.
  4. Нажмите Create inbox.

  5. Добавьте операторов — тех, кто будет отвечать. Без этого шага переписку никто не увидит.

Шаг 2. Вставьте код на сайт

  1. Откройте созданный источник: Настройки → Источники → ваш веб-чат.
  2. На вкладке Settings справа переключитесь с Preview на Script.
  3. Нажмите Copy и вставьте код на сайт перед закрывающим тегом </body> — на всех страницах, где нужен чат.

Код виджета на вкладке Script

Код небольшой: он подгружает sdk.js и запускает виджет с токеном вашего канала.

Токен в коде (websiteToken) — это идентификатор канала, он и должен быть на страницах сайта. Ограничить, откуда виджет разрешено открывать, можно списком доменов — см. ниже.

Если сайт на конструкторе или CMS, код вставляется в блок «пользовательский скрипт» / «код в подвале» — этого достаточно, отдельная интеграция не нужна.

Шаг 3. Настройте виджет

Всё это — вкладка Settings источника.

НастройкаЧто делает
Welcome Heading / TaglineТекст в открытом чате.
Widget ColorЦвет кнопки и шапки.
BubbleПоложение кнопки (слева/справа) и её вид: обычная или расширенная с подписью.
Launcher TitleПодпись на расширенной кнопке.
Set Reply timeОбещание скорости ответа: «за несколько минут», «за несколько часов», «в течение дня». Показывается в виджете.
FeaturesЧто доступно посетителю: вложения, эмодзи, кнопка «завершить разговор».
Enable channel greetingАвтоприветствие на первое сообщение.
Enable email collect boxСпрашивать email в новом разговоре, чтобы ответить, когда посетитель ушёл.
Allow messages after conversation resolvedМожно ли писать в уже закрытый разговор.
Enable conversation continuity via emailПродолжать разговор письмами, если email известен.

Рядом с настройками есть Preview — виджет виден сразу, без публикации на сайте.

Ещё две вкладки источника пригодятся почти всем:

  • Pre Chat Form — спросить имя, email или телефон до начала разговора.
  • Business Hours — часы работы: вне их виджет честно предупредит, что ответ будет позже.

Шаг 4. Ограничьте домены

Вкладка Configuration источника:

  • Allowed Domains — список доменов через запятую, откуда виджет разрешено открывать. Пустое поле означает «с любого сайта» — для боевого канала так оставлять не стоит: чужой сайт сможет открыть ваш чат.
  • Enable widget in mobile apps — включите, если встраиваете виджет в мобильное приложение: оно не передаёт домен и иначе будет отсечено проверкой.
  • Identity Validation — подпись данных посетителя секретным ключом, чтобы никто не мог представиться чужим именем. Нужна, если чат стоит в личном кабинете, где пользователь уже авторизован.

Чего у этого канала нет

Веб-чат не занимает слот в лимите подключений, не виден в разделе «Подключения» и недоступен в рассылках, прогреве и «Начать диалог»: написать первым посетителю, который ушёл с сайта, нельзя — для этого и нужен сбор email. SLA, контроль качества и отчёты работают как обычно.

Если что-то не получилось

СимптомЧто делать
Кнопка чата не появиласьКод вставлен не на ту страницу или не перед </body>. Откройте консоль браузера: скрипт sdk.js должен загружаться без ошибок.
Виджет был, а после правки настроек пропалПроверьте Allowed Domains: если там перечислены домены, а сайт открыт с другого (например, с www. или со staging-домена), виджет блокируется. Добавьте нужный домен.
Чат не открывается в мобильном приложенииВключите Enable widget in mobile apps — приложение не передаёт домен.
Сообщения приходят, но никто их не видитВ источнике не добавлены операторы — вкладка Collaborators.
Посетитель ушёл, а ответить нужноВключите email collect box и conversation continuity via email: разговор продолжится письмом.

Содержание