/справка
Справка Floqly
Как поставить виджет на сайт, проверить запуск и настроить первые обращения.
5 минут
на подключение
один скрипт
в общий шаблон сайта
из кабинета
без правки кода
01
Порядок запуска без лишних шагов
Создайте проект
Укажите домен сайта, на котором будет работать виджет. Домен нужен для проверки установки и корректной аналитики.
Пример: example.ru
Добавьте каналы связи
Телефон, Telegram, WhatsApp или email. Виджет предложит посетителю тот путь, где вам удобно принять заявку.
Достаточно одного рабочего контакта.
Задайте цель обращения
Опишите, какое действие считается заявкой: записаться, оставить контакты, запросить расчёт, выбрать тариф.
Это влияет на сценарии разговора.
Скопируйте код
В кабинете откройте блок установки и скопируйте готовую строку кода. Ключ уже будет подставлен.
Код индивидуален для проекта.
Поставьте код на сайт
Вставьте строку перед закрывающим тегом </body> или в блок пользовательского HTML в конструкторе.
После публикации обновите сайт.
Проверьте статус
Откройте кабинет. Когда скрипт загрузится с нужного домена, Floqly покажет, что код найден.
Обычно это занимает 1-2 минуты.
02
Подключение виджета к сайту
В кабинете будет готовый код с ключом проекта. Ниже показан формат: его нужно добавить в место, где платформа подключает пользовательские скрипты.
<script src="https://cdn.floqly.ru/embed/v1/fl-helper.iife.js?v=4"
data-widget-id="ВАШ_КЛЮЧ"
async>
</script>Куда вставить код
TildaМожно поставить на весь сайт или только на одну страницу.
В Tilda есть два рабочих варианта. Для полноценной работы ставьте код через настройки сайта: так Floqly будет загружаться на всех страницах и сохранит путь посетителя. Если умный виджет нужен только на выбранных страницах, используйте блок T123.
На все страницы сайта
Рекомендуемый вариант для запуска: виджет работает на всём сайте и видит переходы между страницами.
- Откройте панель Tilda и выберите нужный сайт.
- Перейдите в «Настройки сайта» и откройте вкладку «Ещё».
- Найдите поле «HTML-код для вставки внутрь head».
- Вставьте код Floqly из кабинета и сохраните изменения.
- Переопубликуйте все страницы сайта.
На выбранные страницы
Используйте, если вы сознательно ограничиваете показ виджета отдельными страницами.
- Откройте страницу в редакторе Tilda.
- Добавьте блок T123 «HTML-код» из категории «Другое».
- Откройте «Контент» блока и вставьте код Floqly.
- Сохраните блок и опубликуйте страницу.
После публикации откройте сайт в новом окне: на странице должна появиться кнопка Floqly. В кабинете статус установки сменится с «поставьте код» на «код найден».
WordPressЛучше через footer-плагин, без правки темы.
- 1Установите плагин для вставки кода в footer или откройте настройку темы для кода перед </body>.
- 2Вставьте код Floqly в поле footer.
- 3Сохраните изменения и очистите кеш сайта, если он включён.
Править footer.php стоит только если вы уверенно работаете с темой или рядом есть разработчик.
HTML / CSS сайтДля обычных файлов и самописных страниц.
- 1Откройте общий HTML-шаблон или файл страницы.
- 2Вставьте код Floqly перед закрывающим тегом </body>.
- 3Сохраните файл, загрузите изменения на хостинг и откройте сайт в новом окне.
Если у сайта несколько страниц, ставьте код в общий шаблон, чтобы не копировать его вручную.
Сайт в кодеNext.js, React, Vite, Codex, Cursor и похожие проекты.
- 1Найдите общий layout, который подключается на всех страницах сайта.
- 2Для Next.js используйте next/script в корневом layout; для Vite или обычного React можно вставить script в index.html.
- 3Задеплойте сайт и проверьте установку на рабочем домене.
Если сайт собирается через помощник для кода, попросите его добавить embed-скрипт Floqly во все страницы проекта.
1С-БитриксДля сайтов на шаблонах и корпоративных проектов.
- 1Откройте шаблон сайта, который отвечает за общий footer.
- 2Добавьте код Floqly перед закрывающим тегом </body>.
- 3Сохраните шаблон, очистите кеш и откройте сайт как посетитель.
Если шаблон обслуживает подрядчик, передайте ему код из кабинета Floqly и этот пункт инструкции.
Другой конструкторКогда платформа не указана в списке.
- 1Найдите раздел «Пользовательский код», «HTML-код» или «Код перед </body>».
- 2Вставьте код Floqly и примените его ко всем страницам сайта.
- 3Опубликуйте сайт и проверьте статус установки в кабинете.
Если конструктор поддерживает только iframe, напишите нам: для виджета нужен именно script-код.
03
Что настроить до запуска
Домен
Домен в проекте должен совпадать с сайтом, где стоит код. Если поставить код на другой домен, кабинет покажет предупреждение.
Каналы связи
Добавьте только те контакты, где вы реально отвечаете. Лучше один быстрый канал, чем четыре забытых.
База знаний
Добавьте страницы сайта, FAQ, условия доставки, тарифы, описания услуг или товаров. Чем точнее источник, тем точнее ответы.
Цель обращения
Сформулируйте ожидаемый результат: заявка, звонок, запись, расчёт, подбор товара. Это помогает виджету вести разговор к делу.
Уведомления
Подключите Telegram для заявок и важных диалогов. Посетители этот контакт не увидят.
04
Как проходит запуск
Код может быть найден сразу, но самостоятельные обращения и уведомления включаются после проверки. Сначала мы смотрим, что виджет подключён к нужному сайту, понимает цель обращения и ведёт посетителя к рабочему каналу связи.
Это нормальная часть запуска: виджет уже установлен, но активные сценарии включаются только после проверки качества.
- код найден
Проверяем подключение
Смотрим домен, загрузку скрипта и первые события на сайте. Если код стоит не там, кабинет покажет предупреждение.
- настройка
Настраиваем под сайт
Проверяем каналы связи, цель обращения и базу знаний. Это нужно, чтобы виджет не начинал диалог не к месту.
- запуск
Включаем самостоятельные обращения
Когда базовая проверка пройдена, виджет начинает писать первым в подходящий момент: при сомнении, уходе или вопросе по странице.
Первые дни смотрим поведение
Мы следим, какие страницы вызывают вопросы, какие сценарии ведут к заявкам и где виджету лучше промолчать.
Сценарии уточняются со временем
Чем больше реальных визитов и диалогов, тем точнее становятся формулировки, моменты показа и путь к заявке.
05
Как понять, что всё работает
Скрипт загружается
В коде страницы есть fl-helper.iife.js, а рядом стоит ваш data-widget-id.
Домен совпадает
Кабинет видит установку на том же домене, который указан в проекте.
Виджет отвечает
Откройте сайт как посетитель, напишите тестовый вопрос и проверьте ответ.
Данные попадают в кабинет
После первых открытий и диалогов в аналитике появятся события, каналы и заявки.
06
Если что-то пошло не так
Виджет не появился на сайте
Проверьте, что код опубликован, стоит перед </body> и не удалён оптимизатором сайта. После правки откройте страницу в новом окне.
Кабинет пишет, что домен не совпадает
Код загрузился не с того сайта. Перенесите его на нужный домен или измените домен проекта в кабинете.
После правок в кабинете на сайте старый вид
Обновите страницу без кеша. Сам код менять не нужно: настройки подтягиваются автоматически.
Каналы связи ведут не туда
Откройте раздел каналов и проверьте номер телефона, ссылку Telegram, WhatsApp и email. Сохраните изменения.
Виджет отвечает, но сам не начинает разговор
Проверьте установку, цель обращения и статус самостоятельных сценариев. До активации он продолжит отвечать на ручные обращения.
07
Частые вопросы
Нужно ли менять код после правок в кабинете?
Нет. Один и тот же код остаётся на сайте. Цвета, каналы, цель обращения и база знаний обновляются через кабинет.
Можно ли поставить виджет на несколько страниц?
Да. Лучше добавить код в общий шаблон сайта, чтобы он работал на всех нужных страницах.
Виджет повлияет на стили сайта?
Нет. Интерфейс изолирован от стилей страницы, поэтому кнопки, шрифты и формы сайта не должны измениться.
Можно временно отключить виджет?
Да. Отключите его в кабинете или временно удалите строку кода с сайта. Настройки проекта при этом сохранятся.
Что делать, если сайт на конструкторе?
Найдите блок пользовательского HTML или код перед </body>. Если такого блока нет, напишите нам: подскажем место для вашей платформы.
следующий шаг
Поставьте код и проверьте первый диалог
Если установка уже сделана, переходите к каналам связи, цели обращения и базе знаний. Эти три настройки сильнее всего влияют на качество заявок.