Статус Документация

Виджет чат-бота встраивается на сайт автосервиса и отвечает посетителям по вашей базе знаний, показывает контакты и принимает заявки на ремонт — пока вы заняты в ремзоне.

Виджет живёт в кабинете в разделе «Чат-бот». Отдельная страница описывает возможности виджета для клиентов — см. публичную страницу.

Что умеет виджет

  • Отвечает на вопросы посетителей по вашей базе знаний (формат XML-фид) — цена, сроки, услуги;
  • Показывает кнопки «Где нас найти», «Контакты», «Часы работы», «Сайт», «Оставить отзыв» — если вы заполнили соответствующие данные в настройках;
  • Принимает заявку на ремонт — телефон, авто, комментарий. Заявка падает в блок «Заявки» кабинета;
  • «Позвать сотрудника» — рядом с каждым ответом, если посетитель не нашёл ответ в базе;
  • Оповещает мастера о новой заявке тремя каналами: push в кабинет, веб-push в браузер и email.

Включение виджета

  1. Откройте раздел «Чат-бот» в кабинете.
  2. Включите тумблер «Включить чат-бот».
  3. Укажите URL XML-фида базы знаний (см. формат ниже).
  4. Нажмите «Проверить» — система загрузит фид и проиндексирует статьи.
  5. Скопируйте embed-сниппет (готовый <iframe>) и вставьте его на страницы вашего сайта.
Где взять slug. Embed-сниппет уже содержит уникальный идентификатор (slug) вашего сервиса — копировать его вручную не нужно.

Формат XML-фида

База знаний публикуется на вашем сайте как XML-файл в кодировке UTF-8. Вы даёте на него ссылку в кабинете — система периодически забирает и индексирует его.

<?xml version="1.0" encoding="utf-8"?>
<knowledge version="1" lang="ru">
  <article id="oil-change-price" updated-at="2026-08-01T09:00:00+03:00">
    <question>Сколько стоит замена масла?</question>
    <keywords>масло, замена, цена, стоимость, ТО</keywords>
    <answer><![CDATA[ Замена масла — от <b>800 ₽</b>. Стоимость масла и фильтра уточняйте по телефону. ]]></answer>
    <category>Цены</category>
    <url>https://autoservice.ru/prices</url>
  </article>
  <!-- ... -->
</knowledge>

Описание полей

Поле Обязательное Описание
article id да Стабильный внешний идентификатор статьи (строка). По нему статья обновляется при повторной синхронизации
article updated-at нет Дата изменения в формате ISO 8601. Если не изменилось с прошлой синхронизации — реиндексация пропускается
question да Вопрос посетителя. Используется в поиске с наибольшим весом
keywords нет Дополнительные ключевые слова через запятую
answer да Текст ответа. Допускается HTML (CDATA) — санитизируется при загрузке
category нет Категория для группировки
url нет Ссылка «подробнее» — кнопка в ответе виджета

Разрешённые теги в ответе

В answer допустимы: <b>, <i>, <strong>, <em>, <br>, <p>, <a href>, <ul>, <li>. Всё прочее (включая <script>, обработчики on*, javascript:) вырезается при загрузке фида.

Идемпотентность и удаление статей

  • Статьи обновляются по (id) — меняйте updated-at, чтобы форсировать реиндексацию;
  • Статьи, исчезнувшие из фида, удаляются из индекса при следующей синхронизации;
  • Фид должен быть доступен по прямой ссылке без авторизации.
Размер фида. Держите фид разумного размера: если статей больше нескольких тысяч или файл весит десятки мегабайт — синхронизация может не успеть. Группируйте похожие вопросы в одну статью.

Кнопки контактов и условия доступности

Виджет показывает пять кнопок быстрых действий. Каждая автоматически отключена, если её данные не заполнены — посетитель не видит неработающих кнопок.

Кнопка Что показывает Где заполнить
Где нас найти Ссылку на карточку организации на карте (маршрут) Настройки → Бренд, поле «Карта организации»
Контакты Телефон и мессенджеры Настройки → Бренд, список «Каналы связи»
Часы работы График работы по дням недели Настройки → Бренд, «Часы работы»
Сайт Ссылку на ваш сайт Настройки → Бренд, поле «Сайт»
Оставить отзыв Ссылку на карточку организации (отзыв) Та же ссылка «Карта организации» — карточка покрывает и маршрут, и отзыв
Один источник правды. Контакты, часы работы и карта заполняются один раз в настройках бренда — их одновременно использует виджет, мессенджер-бот и напоминания о ТО. Менять в двух местах не нужно.

Статус синхронизации

В кабинете отображается блок статуса последней синхронизации фида:

  • Успешно — фид загружен, статьи проиндексированы;
  • Ошибка — фид недоступен или невалидный (старые статьи сохраняются, виджет продолжает работать по ним);
  • дата и время последней синхронизации;
  • количество статей в индексе.

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

Embed-сниппет

После включения виджета в кабинете появляется готовый код для вставки:

<iframe
  src="https://app.status-autoservice.ru/widget/ВАШ-SLUG"
  style="position:fixed;bottom:0;right:0;width:380px;height:600px;border:0;z-index:9999"
  title="Чат-бот автосервиса"
  allow="clipboard-write"
></iframe>

Вставьте сниппет на страницы вашего сайта (обычно — в общий шаблон, чтобы виджет был на всех страницах). Подойдёт любой конструктор: Tilda, WordPress, самописный сайт.

Частые ошибки

  • Кнопка контактов не появилась в виджете — заполните соответствующие данные в Настройках → Бренд (каналы связи, карта, часы работы, сайт).
  • Виджет не грузится на сайте — проверьте, что тумблер «Включить чат-бот» включён, а embed-сниппет вставлен без изменений (slug обязателен).
  • Фид возвращает ошибку синхронизации — убедитесь, что XML валидный, кодировка UTF-8, а URL доступен без авторизации. Откройте ссылку фида в режиме инкогнито.
  • Ответы не находятся по нужному вопросу — добавьте синонимы в keywords статьи, либо переформулируйте question ближе к тому, как спрашивают клиенты.

Связанные разделы