Две темы: как поставить виджет на сайт и как работают AI-отчёты по отзывам.
Установка одним скриптом
Если на сайте несколько виджетов — отзывы, часы работы, вопросы, всплывающие отзывы, — не нужно вставлять по скрипту на каждый. У приложения есть один общий код: его ставят в шапку сайта один раз, а виджеты расставляют короткими метками.
Что вставить
В кабинете откройте приложение → вкладка «Установка».
Скопируйте строку из блока «Один код на весь сайт». Она выглядит так:
Вставьте её в <head> — в настройках сайта или шаблона, чтобы она была на всех страницах.
Там, где должен стоять виджет, вставьте его метку из того же раздела:
<div data-widgetsai="abcd1234"></div>
Всплывающие отзывы, кнопка «Оставьте отзыв» в углу экрана и кнопки мессенджеров меток не требуют: появятся сами на каждой странице, где стоит общий код. Список таких виджетов — там же, во вкладке «Установка».
Tilda
Общий код — в «Настройки сайта» → «Ещё» → «HTML-код для вставки внутрь head». Метку виджета — в блок T123 «HTML-код» в нужном месте страницы. Опубликуйте страницы заново.
1C-Bitrix
Общий код — в шаблон сайта, в header.php перед </head>. Метку — через визуальный редактор в режиме HTML там, где нужен виджет. Если изменений не видно, сбросьте кеш Bitrix.
WordPress
Проще всего — плагин WidgetsAI Reviews (версия 1.1 и новее). В «Настройки → WidgetsAI Reviews» вставьте строку общего кода — плагин сам поставит его в шапку. Виджеты — шорткодом [widgetsai widget="abcd1234"] или блоком «WidgetsAI» с кодом виджета. Если стоит WP Rocket или похожий плагин оптимизации, добавьте loader.js в исключения — иначе новые виджеты появятся на сайте только после очистки его кэша.
Свой сайт на React, Vue и т. п.
Общий код подключите один раз в шаблоне страницы. Если метки появляются уже после загрузки (переходы без перезагрузки страницы), после отрисовки вызовите window.WidgetsAI.scan() — загрузчик найдёт новые метки и поставит в них виджеты. Уже поставленные повторно не трогает.
Если что-то не так
Метка есть, а виджета нет — проверьте, что виджет включён и что метка от этого же приложения: код другого приложения загрузчик не трогает.
Общий код попал на чужой сайт — во вкладке «Установка» нажмите «Выдать новый ключ» и замените строку у себя. Старая перестанет работать сразу.
Старые скрипты отдельных виджетов (/w/…/embed.js) продолжают работать, менять их не обязательно. Не ставьте только оба способа для одного и того же виджета на одной странице — он покажется дважды.
Установка виджета на сайт
Точный код для вставки выдаёт редактор виджета (кнопка «Редактировать» → «Получить код»). Ниже — куда этот код вставить в популярных конструкторах.
Как это выглядит
Код — это один скрипт, примерно такой (ваш будет с вашими настройками и ключом виджета):
Вставьте его в то место страницы, где должны показываться отзывы. После публикации отзывы появятся автоматически — WidgetsAI обрабатывает данные из подключенных вами источников.
Tilda
Откройте страницу в редакторе Tilda → «Добавить блок» → найдите блок T123 «HTML-код».
Вставьте код виджета в поле блока.
Опубликуйте страницу («Опубликовать» в правом верхнем углу).
1C-Bitrix (Управление сайтом)
Вариант для одной страницы: откройте страницу в визуальном редакторе → вставьте компонент «HTML-код» (Служебные) в нужное место → впишите код виджета → сохраните.
Вариант для всего сайта: в шаблоне сайта (обычно footer.php перед </body>) вставьте код виджета — отзывы появятся на всех страницах с этим шаблоном.
Сбросьте кеш Bitrix (Настройки → Автокеширование → сброс), если изменения не видны сразу.
WordPress
Вариант для одной страницы: в редакторе блоков добавьте блок «Произвольный HTML» → вставьте код виджета → «Обновить».
Вариант с конструктором (Elementor и др.): добавьте виджет «HTML» в нужную секцию → вставьте код → сохраните.
Вариант для всего сайта: плагин типа «Insert Headers and Footers» → вставьте код в поле «Footer» → сохраните.
Не работает?
Проверьте, что страница опубликована (черновики конструкторов сторонний скрипт не исполняют).
Отключите блокировщики рекламы для проверки — они иногда режут сторонние скрипты.
Отзывы кэшируются: после подключения источника первые данные могут появиться в течение нескольких минут.
Убедитесь, что в редакторе виджета указан правильный идентификатор организации (подсказка — в самом редакторе, над списком источников).
Не помогло — напишите нам: admin@pirondev.rbel.info. Укажите адрес страницы и ID виджета (цифры после # в кабинете).
AI-инсайты и отчёты по отзывам
Раздел «Отчёты» в кабинете — там две кнопки, и они делают разное.
Проанализировать
Быстрый текстовый разбор прямо на странице: что хвалят, что ругают, как это меняется. Никуда не сохраняется и никому не отправляется — посмотрели и закрыли.
Отчёт со ссылкой
Отдельная страница с диаграммами и постоянным адресом: её можно переслать коллеге или клиенту и распечатать (Ctrl/Cmd + P — браузер сохранит в PDF, отдельная программа не нужна).
Перед созданием спрашиваются три вещи, и все три потом не переиграть, потому что ссылку вы уже отправите:
Срок действия ссылки — от 7 дней до года. После него страница перестаёт открываться и показывает «срок действия истёк». Отозвать ссылку можно и раньше, кнопкой в списке отчётов.
Доступ — по умолчанию отчёт видят только участники вашей организации. Вариант «любой, у кого есть ссылка» делает страницу открытой: внутри аналитика вашего бизнеса и цитаты из отзывов, поэтому включайте его только для того, что готовы показать клиенту.
Фотографии из отзывов — необязательно. Делают отчёт нагляднее, но это снимки покупателей с площадок; с публичной ссылкой лучше не сочетать.
Отчёт готовится в фоне: на пул отзывов, запрос к модели и сохранение уходит до минуты. Окно можно закрывать — когда всё готово, ссылка появится в списке отчётов, а на почту придёт письмо. Если вкладка открыта, ссылка покажется в ней сама, обновлять страницу не нужно.
Одновременно готовится один отчёт на организацию: каждая генерация тратит AI-запрос из месячного лимита тарифа.
Отчёт по одному приложению
Кнопка со звёздочкой в строке приложения на странице «Обзор» открывает разбор только его источников, а не сводку по всей организации. Из готового разбора можно сразу сделать отчёт со ссылкой.
Откуда в отчёте числа
Разделение жёсткое, и это важно для доверия к документу:
Все цифры и графики считает сервер по тексту отзывов — средний рейтинг, распределение оценок, доли по площадкам, динамика. Модель их не придумывает и не пересчитывает.
Модель отвечает за смысл: темы, тональность по аспектам, цитаты, рекомендации. Каждая тема подкреплена дословными цитатами — их видно в отчёте, и по ним выводы можно проверить.
В подвале отчёта написано, к каким данным модель обращалась и по какой выборке он построен.
Блок «Что изменилось» появляется не сразу: он сравнивает сегодняшние показатели с замером примерно месячной давности, а замеры снимаются раз в сутки автоматически. У новой организации сравнивать пока не с чем, поэтому блока в первых отчётах не будет — это правильное поведение, а не ошибка.
Если отчёт не получился
«Квота AI-запросов на этот месяц исчерпана» — лимит обновится в начале следующего месяца либо после перехода на тариф с бо́льшим лимитом. Повторный анализ по неизменившимся отзывам берётся из кэша и квоту не тратит.
«Отзывы ещё не загружены» — источник только подключили, данные подтянутся в течение нескольких минут.
«Под выборку не попал ни один отзыв» — фильтры слишком узкие, расширьте их (см. ниже).
Выборка отзывов для анализа
Выборка — это то, что читает модель. По умолчанию берутся 50 свежих отзывов. На тарифах с настраиваемой выборкой на странице «Отчёты» открывается «Настроить выборку»:
Сколько отзывов — от 1 до потолка вашего тарифа; 0 означает «все загруженные».
Оценки от и до — например, 1–2★, чтобы получить отчёт только по негативу.
Период — либо скользящее окно («последние 90 дней», удобно для регулярных отчётов), либо конкретный интервал дат. Конкретные даты важнее окна в днях.
Отзывы без распознанной даты — часть площадок отдаёт дату не всегда. Если для интервала важна точность, такие отзывы можно исключить, но выборка станет меньше.
Настройки задаются для всей организации или отдельно для приложения — переключатель области рядом с описанием выборки. Настройки приложения перекрывают настройки организации.
Почему «все отзывы» — это не весь маркетплейс
Здесь легко ошибиться в ожиданиях, поэтому скажем прямо: анализ идёт по отзывам, загруженным в WidgetsAI, а не по всему архиву площадки. Мы держим в кэше ограниченное число свежих отзывов на каждый источник, и глубже этого никакой фильтр не заглянет — интервал, начинающийся три года назад, вернёт только те отзывы за этот срок, которые есть у нас.
Сколько именно отзывов держится в кэше, написано прямо под полем «Сколько отзывов». Разные площадки отдают разный объём: у части из них постраничный доступ, у части — только одна страница выдачи.
Выборка, по которой построен отчёт, всегда напечатана в его подвале — вместе с тем, сколько отзывов под неё попало из загруженных. Так документ можно проверить, а не принимать на веру.