Чат IFLS через Яндекс Тег Менеджер

Статус шаблона

Наличие шаблона в личном кабинете Яндекса и размещение в общем каталоге — разные этапы. Инструкция ниже позволяет создать личный шаблон независимо от доступности карточки IFLS в каталоге. Также можно установить чат обычной строкой кода.

1. Подготовьте сайт и ключ

1. Проверьте, что на сайте установлен счётчик Яндекс Метрики. Если счётчика нет, можно воспользоваться обычной установкой ниже.
2. Владелец счётчика открывает Метрику → «Настройки» → «Счётчик», включает «Яндекс Тег Менеджер» и сохраняет изменения. Для шаблона IFLS включать «Пользовательский HTML» не требуется.
3. В кабинете IFLS откройте «Интеграции» → «Ключи и домены». Скопируйте ключ виджета кнопкой «Копировать». Он начинается с ifls_widget_. Секретный ключ API для этого не нужен.
4. Проверьте «Разрешённые домены» в том же разделе. Если адреса сайта нет, попросите оператора IFLS добавить его для вашей компании. Для example.ru и www.example.ru нужны оба адреса.

2. Создайте личный шаблон

Если в каталоге Яндекса уже доступен шаблон IFLS, выберите его и переходите к подключению тега. Для личного шаблона выполните шаги ниже.

1. В Метрике выберите нужный сайт. Откройте «Тег Менеджер» → «Шаблоны» → «Добавить шаблон».
2. В разделе «Информация» задайте название IFLS — чат поддержки.
3. В разделе «Поля» добавьте одно обязательное текстовое поле. Название в коде: widgetKey. Подпись для пользователя: Ключ виджета IFLS. Если конструктор предлагает проверку регулярным выражением, укажите ^ifls_widget_[A-Za-z0-9_-]{32,128}$. Проверка также встроена в код шаблона.
4. Откройте код шаблона, скопируйте весь текст и вставьте в раздел «Код» конструктора.
5. В «Разрешениях» оставьте только Добавление скриптов (load_script). Разрешите адрес https://intelligentfirstlinesupport.ru/widget.js*. Доступ к глобальным переменным, cookies, хранилищу и содержимому страницы самому шаблону не нужен.
6. Сохраните и опубликуйте личный шаблон. Публикация личного шаблона делает его доступным в вашем контейнере; отправка в общий каталог выполняется отдельно.

Скачать код шаблона · Параметры для конструктора. JSON — справка для заполнения полей, а не файл импорта Яндекса.

3. Подключите чат

1. Откройте «Теги» → «Добавить тег». Назовите его Чат IFLS и выберите личный шаблон IFLS.
2. В поле «Ключ виджета IFLS» вставьте скопированный ключ. Вставляйте только сам ключ — без HTML-кода и кавычек.
3. В «Триггерах» выберите запуск после готовности DOM на всех страницах, где нужен чат. DOM — это содержимое страницы; ждать загрузки всех картинок не нужно.
4. В ограничении активации выберите «В пределах одной страницы» и число 1.
5. Сохраните тег. Запустите «Предварительный просмотр» и откройте свой сайт. Должна появиться одна кнопка чата. Проверьте заголовок и цвета; отправьте тестовое сообщение и дождитесь ответа.
6. Если всё работает, опубликуйте изменения контейнера. Откройте сайт в обычной вкладке без предварительного просмотра и проверьте ещё раз.

Если раньше чат был установлен строкой кода, после успешной проверки удалите старую строку из настроек сайта. Загрузчик защищён от дублей, но лучше оставить один способ подключения.

Как изменить оформление

Откройте IFLS → «Интеграции» → «Внешний вид виджета». Выберите цвета, скругление, сторону экрана и шрифт, задайте заголовок и приветствие, нажмите «Сохранить». Затем обновите страницу сайта. Менять или перепубликовывать тег в Яндексе для этого не нужно.

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

• Проверьте, что изменения контейнера опубликованы, тег включён, а условия запуска подходят к этой странице.
• Проверьте ключ и разрешённый домен в IFLS, включая вариант адреса с www.
• Если кнопка есть, но оформление не загрузилось или чат сообщает об ошибке, проверьте домен и ключ: появление кнопки ещё не подтверждает доступ к API.
• Блокировщик Метрики может помешать загрузке через Яндекс. Также ограничения сайта (CSP) должны разрешать скрипт и подключения к https://intelligentfirstlinesupport.ru; при необходимости передайте этот адрес администратору сайта.

Помощь: ivanpodpr08@yandex.ru.

Альтернатива: установка кодом без Метрики

Скопируйте строку ниже, замените ВАШ_КЛЮЧ на ключ виджета из IFLS. Добавьте её в общий шаблон своего сайта перед </body> или в настройку конструктора «Код перед закрывающим body». Сохраните и опубликуйте сайт. Проверка разрешённого домена нужна и при этом способе.

<script src="https://intelligentfirstlinesupport.ru/widget.js" data-key="ВАШ_КЛЮЧ" defer></script>

Какие данные использует подключение

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