Веб-чат: чат на вашем сайте

Как это работает

1. Вы создаете канал «Веб-чат» в разделе «Каналы» - получаете уникальный код установки.
2. Вставляете код на сайт - там появляется кнопка чата (виджет).
3. Посетитель нажимает на кнопку, открывается окно чата, он пишет сообщение.
4. Сообщение попадает в Strelo так же, как сообщение из Telegram: запускает цепочку по триггеру, либо продолжает текущий диалог, либо falls back в инбокс, если бот на паузе.
5. Пиксель Strelo, привязанный к каналу, ставится автоматически - работает независимо от того, писал посетитель в чат или нет. Канал «Веб-чат» - это отдельная сущность в списке каналов, со своим значком и статусом, как Telegram-бот.

Как подключить

Шаг 1. Создать канал

1. «Каналы» - «Добавить канал» - «Веб-чат».
2. Задайте имя канала (для себя, посетители его не видят) и настройки виджета: цвет, название в шапке чата, приветственное сообщение, позиция кнопки на странице (справа или слева снизу), аватар.
3. Укажите домены, с которых разрешено встраивать виджет (allowlist). Виджет откроется только на них - это защита от того, что кто-то скопирует ваш код себе.
4. При создании канала можно выбрать существующий пиксель Strelo или создать новый - подробнее в разделе «Пиксель» ниже.

Шаг 2. Вставить сниппет на сайт

1. На странице канала нажмите «Код установки» - скопируется один тег вида:
   ```html
   <script async src="https://strelo.ru/w/<ваш-ключ>"></script>
   ```
2. Вставьте его в HTML сайта перед закрывающим тегом </head> - как и пиксель, через код сайта, CMS или конструктор.
3. Сохраните и опубликуйте изменения на сайте.
   
   После этого на странице появится плавающая кнопка чата. Окно чата открывается по клику - оно не открывается само по себе.
   

Шаг 3. Проверить домены

Если виджет не появляется или не открывается - скорее всего, домен сайта не добавлен в allowlist канала. Откройте настройки канала «Веб-чат» и добавьте нужный домен (и поддомен, если сайт открывается и с www., и без).

Пиксель ставится автоматически

Один и тот же script-тег веб-чата одновременно подключает и виджет, и пиксель Strelo - отдельно вставлять пиксель не нужно.

• Если при создании канала не было ни одного пикселя - Strelo создаст новый автоматически («Пиксель сайта»).
• Если пиксели уже есть - можно выбрать, к какому привязать канал (по умолчанию первый в списке).
• Пиксель, привязанный к веб-чату, работает как обычный пиксель Strelo: считает визиты, знает про переходы по трекинг-ссылкам, поддерживает события пикселя.
  
  Что это дает: триггер «Событие на сайте» в конструкторе цепочек начинает работать для посетителей веб-чата - не только для тех, кто пришел из Telegram-бота по трекинг-ссылке. Как только человек написал в чат, Strelo связывает его визит на сайте с этим диалогом, и события пикселя (просмотр страницы, скролл, клик) могут запускать цепочки в веб-чате точно так же, как в Telegram.
  
  Подробнее про сами события пикселя и триггер «Событие на сайте» - в статье Как подключить пиксель Strelo на сайт.
  

Как создать цепочку для веб-чата

1. «Цепочки» - «Создать цепочку» - на первом шаге выберите канал: Telegram или Веб-чат.
2. Выбор канала фиксируется для всей цепочки: в билдере доступны только те ноды и триггеры, которые умеет веб-чат, а привязать цепочку веб-чата к Telegram-каналу (и наоборот) нельзя.
3. Шаблоны цепочек помечены совместимостью - при выборе шаблона видно, для какого канала он подходит.
   

Какие ноды недоступны в веб-чате и почему

Часть узлов конструктора завязана на возможности Telegram, которых нет на сайте - в палитре цепочки веб-чата их просто нет:

• Голосовое сообщение (video note), Переслать сообщение - используют форматы, которых нет вне Telegram.
• Проверить подписку, Опрос (poll), Реакция - Telegram-специфичные механики (подписка на канал, нативные опросы и реакции), в браузере им неоткуда взяться.
• Редактировать сообщение и Удалить сообщение - в вебе появятся позже, в v1 недоступны.
  
  Остальные узлы - отправка сообщения, условия, ИИ-ответ, задержка, действия с тегами/полями, ожидание ответа пользователя, интеграции - работают в веб-чате так же, как в Telegram. Кнопки в сообщениях веб-чата рисуются как чипы; кнопки-ссылки открываются в новой вкладке сайта.
  

Ответы оператора

Диалоги веб-чата попадают в общий инбокс Strelo - ничего отдельного открывать не нужно. В списке диалогов у каждого сообщения виден бейдж канала (Telegram / Веб-чат), фильтры и статусы работают одинаково для обоих каналов.

Чтобы ответить посетителю вручную:

1. Откройте диалог в инбоксе - если бот еще ведет цепочку, ответ оператора ставит его на паузу (как и в Telegram).
2. Напишите сообщение - оно появится в окне чата у посетителя почти сразу, без перезагрузки страницы.
   
   Если в цепочке стоит узел «Передать оператору» - для веб-чата уведомление о новом диалоге, требующем внимания, приходит в любой активный Telegram-канал вашего рабочего пространства (если в узле указан чат для уведомлений); если нет - диалог просто появится в инбоксе, и его нужно заметить самостоятельно.
   

Лимиты v1

• Файлы от посетителя не поддерживаются. Посетитель не может прикрепить файл или фото к сообщению в чате - только текст. Файлы и медиа от бота посетителю (исходящие вложения по URL) отправляются как обычно.
• Рассылки и цикл-сообщения (sequences) в веб-чат не отправляются. Веб-чат - канал, в который нельзя написать первым: посетитель должен сначала открыть чат сам. Массовые и отложенные рассылки на веб-контакты не запускаются.
• Анонимные посетители, которые ни разу не оставили контактные данные (email, телефон) и не проявляли активность долгое время, со временем удаляются автоматически - это не касается посетителей, которые оставили контакт или подписались.
• Несколько открытых вкладок сайта одновременно синхронизируются с задержкой - это ограничение первой версии.
  

Узнавание залогиненных посетителей (верификация)

Если посетитель уже залогинен на вашем сайте, чат может узнавать его надежно - между устройствами и даже после того, как браузер очистил cookie (например, Safari режет их через 7 дней). Для этого сайт подписывает id пользователя, а чат сверяет подпись.

Как включить:

1. Откройте настройки веб-чат канала, раздел «Верификация пользователей», нажмите «Сгенерировать секрет». Скопируйте секрет и храните его ТОЛЬКО на своем сервере (не в коде страницы).
2. На своем сервере для залогиненного пользователя посчитайте подпись: userHash = HMAC-SHA256(секрет, userId) в hex, где userId - ваш стабильный идентификатор пользователя.
3. На странице ДО тега виджета задайте:
   ```html
   <script>
   window.streloSettings = { userId: "ВАШ_ID", userHash: "ПОДПИСЬ" };
   </script>
   ```
   
   Теперь чат привязывает диалог к проверенному пользователю, а не к анонимной cookie. Верификация опциональна: без нее канал работает как обычно (анонимно).
   

Частые подвопросы

Можно ли изменить внешний вид виджета после подключения?

Да, в настройках канала «Веб-чат» в любой момент можно поменять цвет, приветствие, аватар и позицию кнопки - изменения применяются сразу, пересобирать код на сайте не нужно.

Обязательно ли создавать отдельный пиксель для веб-чата?

Нет. Можно привязать канал к уже существующему пикселю сайта - тогда статистика визитов и события пикселя будут общими и для обычного трекинга, и для веб-чата.

Что видит посетитель, если написал ночью, когда никто не отвечает?

Если в цепочке настроен автоответ или ИИ-ответ - работает он. Если нет активной цепочки и оператор не подключился - сообщение остается в инбоксе и ждет ответа, посетитель увидит его как только оператор напишет.

Можно ли использовать один канал веб-чата на нескольких сайтах?

Домены разрешенных источников (allowlist) можно указать несколько - тогда один и тот же код виджета будет работать на всех перечисленных доменах с одними настройками. Если нужны разные приветствия или цепочки для разных сайтов - удобнее завести отдельные каналы.

Если не получается

• Кнопка чата не появляется на сайте - проверьте, что скрипт вставлен до </head>, страница опубликована и не отдается из кеша старая версия.
• Виджет не открывается / чат пустой - домен сайта не добавлен в allowlist разрешенных источников канала. Добавьте домен (и www.-вариант, если он используется) в настройках канала.
• Цепочка не запускается на сообщение из чата - убедитесь, что в цепочке выбран канал «Веб-чат» и есть подходящий триггер (например «Ключевое слово» или «По умолчанию»); цепочка Telegram на веб-чат не сработает.
• Триггер «Событие на сайте» не видит посетителей веб-чата - проверьте, что каналу привязан пиксель (настройки канала «Веб-чат») и что нужное событие пикселя создано в разделе «Аналитика».
• Не могу отправить рассылку в веб-чат-контакты - ожидаемо: в v1 рассылки и sequences на веб-чат не распространяются (см. «Лимиты v1»).
  

Лимиты и тариф

Канал «Веб-чат» и виджет доступны без ограничения по числу подключенных доменов на канал. Число веб-каналов и лимиты на количество контактов - в рамках общих лимитов вашего тарифа (материализованные контакты веб-чата считаются в общую квоту так же, как контакты Telegram; анонимные посетители, которые еще не оставили контакт, в квоту не входят).