NeuronChat

Как установить виджет ChatNeuron на 1С-Битрикс

Код из кабинета вставляется в подвал шаблона сайта (footer.php) или в поле «скрипты перед </body>» решения Аспро — тогда чат будет на всех страницах. Ниже: шаблон, Аспро, мультисайт, кеш композита и проверка.

Что вставлять

Нужен HTML-тег <script> из кабинета — не PHP и не отдельный файл. Значения data-client и data-agent уникальны для аккаунта, их нельзя выдумывать.

Скопируйте код виджета в кабинете → Виджет. Код выглядит так:

<script
  src="https://chatneuron.ru/widget.js"
  data-client="ВАШ_CLIENT_ID"
  data-agent="ВАШ_AGENT_ID"
  data-variant="card"
  data-api-origin="https://chatneuron.ru"
  defer>
</script>

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

Рекомендуется: footer.php шаблона сайта

Так виджет попадает на все страницы выбранного сайта. Подходит для «чистого» 1С-Битрикс и для готовых решений (Аспро Max / Next / Premier, Allcorp и др.).

  1. Админка → НастройкиНастройки продуктаСайты Список сайтов. Откройте сайт и посмотрите поле Шаблон (например aspro_max, aspro_next).
  2. НастройкиНастройки продуктаСайты Шаблоны сайтов → откройте этот шаблон.
  3. Файл footer.php. Найдите закрывающий тег </body>.
  4. Вставьте код виджета перед </body>. Не оборачивайте его в PHP и не ставьте внутрь визуального редактора страницы: он вырезает <script>.
  5. Сохраните файл. Пример фрагмента:
<?php // ... конец шаблона ... ?>

<script
  src="https://chatneuron.ru/widget.js"
  data-client="ВАШ_CLIENT_ID"
  data-agent="ВАШ_AGENT_ID"
  data-variant="card"
  data-api-origin="https://chatneuron.ru"
  defer>
</script>
</body>
</html>

Аспро: поле «код перед </body>»

В Аспро Max, Next, Premier и похожих решениях счётчики часто кладут в настройки решения, без правки PHP.

  1. НастройкиНастройки решения (или Аспро: … в меню модулей).
  2. Найдите поле вроде Код перед закрывающим </body>, Скрипты в подвале, Пользовательский код / вкладка SEO или «Дополнительно».
  3. Скопируйте код виджета в кабинете → Виджет (вставьте как есть). Сохраните.

Если такого поля нет — используйте footer.php шаблона, это надёжнее. Не вставляйте код в «HTML-контент» обычной страницы через визуальный редактор.

Включаемая область или HTML-блок

  1. Если в footer.php уже есть $APPLICATION->IncludeFile("/include/...") — откройте этот файл в КонтентСтруктура сайта и допишите скрипт в конец файла.
  2. Либо добавьте блок HTML в общий подвал шаблона (не в тело одной новости). Переключитесь в режим исходного кода, иначе Битрикс удалит тег script.

Несколько сайтов на 1С-Битрикс

Два типичных случая:

  1. Два отдельных Битрикса (разные админки, разные домены) — повторите вставку в шаблоне каждого сайта. Код из кабинета один и тот же.
  2. Мультисайт в одной админке — у каждого сайта свой шаблон. Вставьте код в footer.php шаблона первого сайта и шаблона второго. Если шаблон общий — достаточно одной вставки.

Сбросить кеш

Без этого на сайте часто остаётся старая HTML-страница без скрипта.

  1. НастройкиНастройки продуктаКомпозитный сайт → сбросьте кеш композита, если композит включён.
  2. НастройкиНастройки продуктаСайты → очистка кеша (или кнопка сброса кеша в панели сверху).
  3. Откройте сайт в режиме инкогнито или с принудительным обновлением страницы.

Проверка

  1. На любой внутренней странице (не только на главной) откройте «Просмотр кода страницы».
  2. Найдите widget.js и свой data-client. Если их нет — код не в том шаблоне или страница из кеша.
  3. В правом (или левом) нижнем углу должен появиться виджет ChatNeuron.

Типовые сбои: визуальный редактор вырезал script; правили не тот шаблон; не сбросили композит; код поставили только на одну страницу. Внешний src="https://chatneuron.ru/widget.js" объединение JS Битрикса обычно не трогает.

Готово установить виджет на 1С-Битрикс?

Создайте аккаунт, скопируйте код из кабинета и вставьте на сайт по инструкции выше.

Получить свой код виджета в личном кабинете ChatNeuron