Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Чат-бот для заявок
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
Чат-бот для заявок: сценарии, Telegram и Битрикс24Чат-бот на сайте задаёт посетителю вопросы по сценарию и в конце собирает заявку: имя, телефон, удобное время связи, ответы и приложенные файлы. Менеджер получает заявку с уже собранными ответами, страницей, с которой пришёл клиент, и метками UTM. Уточнять, что нужно клиенту, при первом звонке не приходится.
Сценарий собирается в админке на карте шагов, программист не нужен. Заявка приходит на почту, в Telegram и в CRM Битрикс24. Если канал не ответил, отправка повторяется сама.
Какие задачи решает модуль- Собрать квалифицированную заявку вместо короткой формы с одним полем «Телефон».
- Вести посетителя по ветвящемуся сценарию: следующий вопрос зависит от выбранного ответа.
- Показать клиенту примеры работ из вашего инфоблока в нужный момент диалога.
- Передать заявку менеджеру в течение минуты в удобном ему канале.
- Увидеть, на каком шаге посетители уходят, и сравнить два сценария по конверсии.
- Не потерять заявку, если почта или CRM временно недоступны.
- Типы шагов: сообщение, один вариант ответа, несколько вариантов, текстовый ответ, загрузка файла, контакты, примеры работ, завершение.
- У каждого варианта ответа свой следующий шаг. У шага есть шаг «Назад».
- Карта сценария: шаги показаны карточками, связи нарисованы стрелками. Шаги и связи создаются и перетаскиваются мышью, раскладка выстраивается кнопкой «Авторасклад.».
- Несколько сценариев и основной сценарий. Сценарий можно привязать к сайту: на многосайтовой установке у каждого сайта свой основной сценарий.
- A/B-тест: два сценария делят трафик в заданной пропорции, в каждой заявке видно, какой вариант её собрал.
- Экспорт сценария в файл и импорт на другом сайте. 13 готовых шаблонов: «Быстрая заявка» (линейная), «Квиз: подбор услуги» и 11 отраслевых, все с ветвлением (первый ответ ведёт на свои уточняющие вопросы, затем шаги объединяются): «Ремонт: расчёт стоимости», «Запись на приём», «Автосервис: запись на обслуживание», «Курсы и обучение: подбор программы», «Юридическая консультация», «Салон красоты: запись», «Недвижимость: подбор объекта», «Клининг: расчёт уборки», «Фотосъёмка: заявка», «Фитнес: пробное занятие», «Разработка сайта: заявка на расчёт».
- Демо-сценарий создаётся при установке, виджет можно проверить сразу.
- Форма контактов: имя, телефон с маской, email, удобные мессенджеры, удобное время связи.
- Согласие на обработку персональных данных со ссылкой на политику конфиденциальности.
- Загрузка файлов клиентом: изображения, PDF, документы Word и Excel, текст. До 10 МБ на файл, до 3 файлов и 15 МБ на диалог. Тип файла проверяется по содержимому.
- Примеры работ в диалоге: карточки с картинкой, названием со ссылкой и описанием. Берутся из любого инфоблока сайта, дублировать их в модуле не нужно. Три способа привязки к кнопкам бота: свойство типа «Список» (по XML_ID или тексту значения), разделы инфоблока (по символьному коду) или встроенный список для демонстрации. До 12 карточек на показ, только активные элементы.
- Источник заявки: страница, с которой начат диалог, реферер и метки UTM.
- Защита формы контактов от ботов: скрытое поле и проверка времени заполнения. Заявки от ботов не создаются.
- Посетитель может вернуться на шаг назад и поправить ответ. Незавершённый диалог продолжается после перезагрузки страницы.
- Список со стандартным фильтром (поиск, сценарий, статус, период), постраничным выводом и сортировкой.
- Статусы: новая, в работе, закрыта, спам. Групповая смена статуса и удаление, в том числе для всех заявок по фильтру.
- Карточка заявки на вкладках: контакты и источник, ответы по шагам с файлами, доставка уведомлений.
- Выгрузка ответов заявки в Excel (CSV) и PDF.
- Раздел «Недозаполненные»: диалоги, которые посетитель начал и бросил. Срок бездействия задаётся в настройках.
- Письмо с ответами клиента и вложенными файлами.
- Telegram: сообщение о каждой новой заявке и о брошенных диалогах. Chat ID определяется кнопкой в настройках, есть тестовая отправка.
- Битрикс24: заявка уходит в CRM как лид или как сделка через входящий вебхук облачного портала, с контактами, ответами бота и метками UTM. Есть проверка подключения.
- Очередь отправки. При сбое попытки повторяются через 5, 15, 60 и 180 минут, до 5 попыток. На вкладке «Доставка» видны статус каждого канала и ошибка, кнопка «Повторить отправку» запускает отправку сразу.
- Событие OnLeadCreated для интеграторов: вызывается после сохранения заявки и передаёт контакты, ответы и номер сценария.
- Сводка за период: сессии, заявки, недозаполненные, активные диалоги, конверсия в заявку.
- Воронка по шагам: сколько сессий дошло до каждого шага и какая это доля от всех.
- Сравнение вариантов A и B: сессии, заявки, конверсия.
- Шесть готовых тем и собственные настройки: цвета шапки и кнопки, акцентный цвет, цвет текста и фона, скругление углов, положение слева или справа.
- Выбор сценария: правило по странице (в каталоге один сценарий, на других страницах другой), A/B-тест двух сценариев, основной сценарий для каждого сайта. Правило страницы главнее A/B-теста.
- Два режима диалога на выбор. «Один шаг»: на экране только текущий вопрос. «Переписка»: вопросы и ответы остаются на экране пузырями, диалог можно прокрутить вверх.
- Правила показа: задержка появления кнопки, автоматическое открытие окна, только компьютеры или только телефоны, показ на указанных страницах или везде, кроме указанных (маски вида /catalog/*). Закрытый посетителем виджет в этом визите не открывается снова.
- Виджет подключается одним компонентом xlogic:leadbot.widget в шаблон сайта или на нужную страницу.
- Отдельный раздел в меню «Сервисы → Чат-бот для заявок»: заявки, недозаполненные, аналитика, сценарии, шаги, карта сценария, настройки.
- Права на модуль: чтение и запись для разных групп пользователей.
- Публичные контакты (Telegram, телефон, email), которые виджет показывает клиенту в конце диалога.
- Хранение данных: срок хранения диалогов и, по желанию, заявок, очистка идёт автоматически.
- Защита публичной части: проверка CSRF-токена, ограничение числа запросов с одного IP, токен диалога хранится на сервере только в виде хэша.
- При удалении модуля можно сохранить заявки, сценарии, настройки и загруженные файлы, чтобы они были доступны после повторной установки.
Перед установкой
- PHP 8.1 или выше с расширением fileinfo.
- Для уведомлений в Telegram и заявок в Битрикс24 серверу нужен исходящий доступ по HTTPS: к api.telegram.org и к облачному порталу Битрикс24 (адрес вида ваш-портал.bitrix24.ru). Коробочная версия Битрикс24 на своём домене не поддерживается.
- Брошенные диалоги и очистку старых данных выполняет агент раз в час, повторную отправку уведомлений агент раз в 5 минут. Чтобы сроки соблюдались точно, выполняйте агенты на cron.
- Файлы, которые клиенты прикрепляют к заявке, лежат в /upload/xlogic.leadbot/ с длинным случайным именем. На Apache папка закрыта файлом .htaccess, который создаёт модуль. Менеджер скачивает файлы из карточки заявки. На Nginx добавьте в конфигурацию правило:
location ^~ /upload/xlogic.leadbot/ { deny all; }
Установка- Установите решение из Marketplace: Marketplace → Установленные решения, либо Настройки → Настройки продукта → Модули → Чат-бот для заявок → «Установить».
- После установки в разделе «Сервисы» появится пункт «Чат-бот для заявок». В нём создан демо-сценарий «Демо: заявка на консультацию» и стандартные настройки, так что виджет можно сразу проверить.
- Откройте Сервисы → Чат-бот для заявок → Настройки, вкладка «Виджет». Проверьте, что включён флажок «Виджет включён».
- Добавьте компонент в footer.php шаблона сайта или на нужную страницу:
<?$APPLICATION->IncludeComponent('xlogic:leadbot.widget', '', []);?> |
Компонент поддерживает композитный режим: разметка виджета одинакова для всех посетителей, а диалог работает через JS и AJAX. У компонента один параметр, «Заголовок виджета». Если оставить его пустым, берётся заголовок из настроек модуля.
- Откройте страницу сайта и пройдите демо-диалог. Заявка появится в Сервисы → Чат-бот для заявок → Заявки.
Сервисы → Чат-бот для заявок → Настройки. Настройки разбиты на вкладки, внизу общие кнопки «Сохранить», «Применить» и «Отменить».
Виджет- Виджет включён. Выключенный виджет на сайте не показывается.
- Заголовок виджета. Текст на кнопке и в шапке окна.
- URL политики конфиденциальности. Ссылка, которую виджет показывает рядом с согласием на обработку персональных данных. Принимаются адреса вида /privacy/ и https://....
- Требовать галочку согласия. Если включено, заявку нельзя отправить без отметки согласия.
- Готовая тема. Шесть тем: розовая (стандартная), «Океан», «Лес», «Фиолет», «Солнечная», «Строгая графитовая». Выберите тему и нажмите «Сохранить»: цвета и скругление подставятся в поля ниже.
- Цвета шапки и кнопки. Начало и конец градиента.
- Акцентный цвет. Кнопки, ссылки, рамки вариантов ответа.
- Цвет текста и цвет фона окна.
- Скругление углов. От 0 до 32 px.
- Положение. Справа внизу или слева внизу.
- Если изменить любое поле вручную, тема станет «Свои настройки». Кнопка «Сбросить оформление» возвращает стандартную тему.
- Режим диалога. «Один шаг»: на экране только текущий вопрос. «Переписка»: вопросы и ответы остаются на экране, как в мессенджере, посетитель может прокрутить диалог вверх. По умолчанию «Один шаг».
- Показать кнопку через, секунд. Задержка появления кнопки. 0 означает показ сразу.
- Открывать окно автоматически. Окно открывается само после задержки. Если посетитель закрыл виджет, в этом визите он не откроется снова.
- Устройства. Все, только компьютеры и планшеты или только телефоны.
- Сценарии по страницам. Правила вида маска | код сценария, по одному в строке, например /catalog/* | catalog_quiz. Сценарий выбирает первое подходящее правило, на остальных страницах работает основной сценарий сайта. Правило важнее A/B-теста. Диалог, начатый на одной странице, продолжается тем же сценарием на других страницах. Строки, начинающиеся с #, считаются комментариями. Под полем перечислены коды активных сценариев.
- Страницы. Показывать везде, только на указанных страницах или везде, кроме указанных. Страницы задаются масками, по одной в строке: /catalog/*, /contacts/. Звёздочка заменяет любые символы.
Telegram, телефон и email, которые виджет показывает клиенту на шагах с контактами и в конце диалога.
Уведомления- Email для уведомлений о заявках. На этот адрес приходит письмо с ответами клиента и вложенными файлами. Пустое поле отключает письма.
- Telegram Bot Token. Создайте бота у @BotFather командой /newbot и скопируйте токен вида 123456:AAH....
- Telegram Chat ID менеджера. Напишите боту /start, сохраните токен и нажмите «Найти Chat ID»: идентификатор подставится сам. Для чата с ботом нужен числовой ID, а не @username.
- Telegram: новые заявки и Telegram: недозаполненные диалоги. Какие сообщения отправлять.
- Кнопка «Отправить тест в Telegram» проверяет связь.
- Токен хранится в базе и в поле не показывается: после сохранения поле остаётся пустым, оставьте его пустым, чтобы не менять токен.
- В Битрикс24 откройте Разработчикам → Другое → Входящий вебхук и дайте вебхуку права на CRM.
- Вставьте адрес вебхука вида https://ваш-портал.bitrix24.ru/rest/1/код/ в поле «Входящий вебхук Битрикс24». Принимаются только облачные адреса Битрикс24 (bitrix24.ru, bitrix24.by, bitrix24.kz, bitrix24.com и другие) на HTTPS.
- В поле «Создавать в CRM» выберите «Лид» или «Сделку».
- Включите «Отправлять заявки в CRM Битрикс24» и нажмите «Тест Битрикс24 CRM»: в CRM появится тестовая запись, её можно удалить.
«Часов простоя до «недозаполненной»»: через сколько часов бездействия диалог считается брошенным (по умолчанию 2, максимум 168). Кнопка «Проверить недозаполненные сейчас» запускает проверку вручную.
A/B сценарииВключите тест, выберите «Сценарий A» и «Сценарий B» и задайте долю трафика на A в процентах. Если выбран один сценарий, на него идёт весь трафик.
ПортфолиоИсточник примеров работ, которые бот показывает на шаге «Портфолио». Карточки берутся из инфоблока: картинка анонса (или детальная), название со ссылкой на детальную страницу, анонс до 300 символов. Показывается до 12 активных элементов в порядке сортировки.
- Выберите инфоблок и нажмите «Сохранить». После этого появится список его свойств типа «Список».
- Выберите свойство, по которому элементы привязываются к кнопкам бота, и сохраните.
- У значений списка задайте XML_ID, равный коду кнопки на шаге «Портфолио» (например, shop, services, promo). Если XML_ID пустой, используется текст значения.
- Отметьте у элементов инфоблока нужные значения списка. Элементу можно отметить несколько значений.
- В сценарии на шаге «Портфолио» создайте кнопки с теми же кодами. Карточки выбранной ниши появятся на следующем шаге, у которого «Шаг «Назад»» указывает на шаг «Портфолио», либо на любом шаге с заполненной «Нишей для примеров работ».
Если свойство не выбрано, элементы привязываются к разделам инфоблока по их символьному коду (с подразделами). Если инфоблок не выбран, используется встроенный список примеров из демо-данных. Подробные примеры и типичные ошибки в instruction.md, раздел 8.
Защита и хранение- Защита от ботов. В форму контактов добавляется скрытое поле, дополнительно проверяется время заполнения. Заявки от ботов не создаются. По умолчанию включено.
- Хранить завершённые и брошенные диалоги, дней. По умолчанию 90. 0 означает хранить без ограничения. Заявки это не затрагивает.
- Хранить заявки, дней. По умолчанию 0, то есть без ограничения. По истечении срока заявка удаляется вместе с файлами и записями о доставке. Очистка запускается агентом раз в час.
Структура
Сервисы → Чат-бот для заявок → Сценарии: список сценариев. Групповые действия: «Активировать», «Деактивировать», «Сделать основным», «Удалить». Основной сценарий нельзя удалить. В форме сценария поле «Сайт» привязывает сценарий к одному сайту: у каждого сайта свой основной сценарий, а сценарий без привязки («все сайты») подходит любому. Посетителю показывается основной сценарий, а при включённом A/B-тесте один из двух выбранных.
Шаги сценария редактируются в трёх местах: в списке «Шаги» (сортировка, название, активность прямо в таблице), на странице шага и на «Карте сценария».
ШагНа вкладке «Шаг»:
- Название и код. Код пишется латиницей, цифрами и подчёркиванием. Он используется в связях между шагами.
- Тип. Определяет, что видит посетитель (см. таблицу ниже).
- Сообщение. Текст вопроса. В тексте последнего шага можно использовать {name}: подставится имя посетителя из контактов.
- Подсказка. Мелкий текст под сообщением.
- Следующий шаг и шаг «Назад». Выбираются из списка шагов сценария.
- Сортировка, флажки «Стартовый шаг» и «Активен». Стартовым может быть только один шаг сценария.
| Тип | Что видит посетитель |
|---|---|
| Сообщение / кнопка продолжить | Текст и кнопки (или одна кнопка «Далее») |
| Один выбор | Список вариантов, выбирается один |
| Множественный выбор | Список вариантов, отмечается несколько, затем «Далее» |
| Текстовый ввод | Поле для ответа своими словами |
| Загрузка файла | Выбор файла (можно пропустить) |
| Контакты (лид) | Форма с именем, телефоном, email, мессенджерами, временем связи и согласием; после отправки создаётся заявка |
| Портфолио по нише | Варианты ниш и карточки примеров работ |
| Завершение | Итоговое сообщение, после которого диалог закончен |
Настройки шага зависят от типа и находятся на вкладке «Шаг»: «Можно оставить ответ пустым» (текстовый ввод), «Показывать контакты компании», «Ниша для примеров работ» (портфолио), «Код кнопки завершения выбора» (множественный выбор, по умолчанию done).
Кнопки (варианты ответа)На вкладке «Кнопки» варианты ответа шага редактируются одной таблицей. Для каждого варианта:
- Код (при добавлении можно оставить пустым: он будет построен из текста);
- Текст кнопки;
- Следующий шаг, на который переходит диалог после выбора. Если не задан, берётся следующий шаг самого шага;
- «Нужен ввод» и «Подсказка ввода». После выбора такого варианта посетитель должен дописать свой ответ;
- Сортировка, «Активна» и флажок «Удалить».
Столбец Value появляется, только если у какого-то варианта значение отличается от кода.
Новая кнопка добавляется в пустой строке в конце таблицы, кнопка «Добавить кнопку» добавляет ещё одну пустую строку. Сохраняется всё сразу кнопкой «Сохранить» или «Применить».
Правила цепочки: у шага с контактами в поле «Следующий шаг» должен стоять шаг типа «Завершение», иначе после отправки заявки диалог не перейдёт дальше.
Карта сценарияСервисы → Чат-бот для заявок → Сценарии → Карта сценария. Шаги показаны карточками, связи стрелками.
- Новый сценарий и новый шаг создаются кнопками «+ Сценарий» и «+ Шаг» или двойным кликом по пустому месту карты.
- Связь создаётся перетаскиванием от круглой ручки справа (следующий шаг) или от ручки у варианта ответа на карточку нужного шага. Клик по линии удаляет связь.
- Клик по карточке открывает боковую панель с кодом, типом, связями и кнопкой «Редактировать шаг».
- Возвраты («Назад» и переходы после завершения) по умолчанию скрыты, включаются флажком «Показывать возвраты». При выбранной карточке подсвечиваются её связи.
- Кнопка «Авторасклад.» выстраивает шаги по столбцам, «Вписать» подгоняет масштаб. Положение карточек сохраняется кнопкой «Сохранить позиции».
- В списке сценариев у каждой строки есть действие «Экспорт в файл»: скачивается JSON с шагами, кнопками и связями.
- Кнопка «Импорт и шаблоны» над списком открывает страницу с двумя вкладками. «Импорт из файла»: выберите JSON (до 2 МБ) и при желании новое название; сценарий создаётся как новый, существующие не меняются. «Готовые шаблоны»: «Быстрая заявка» (три шага, без ветвления) и 12 шаблонов с ветвлением: «Квиз: подбор услуги» и 11 отраслевых: «Ремонт: расчёт стоимости», «Запись на приём», «Автосервис: запись на обслуживание», «Курсы и обучение: подбор программы», «Юридическая консультация», «Салон красоты: запись», «Недвижимость: подбор объекта», «Клининг: расчёт уборки», «Фотосъёмка: заявка», «Фитнес: пробное занятие», «Разработка сайта: заявка на расчёт». Шаблон с ветвлением устроен так: ответ на первый вопрос ведёт на свои уточняющие вопросы, затем сценарии сходятся на общих шагах (площадь или бюджет, дополнительные услуги, срок, комментарий), а в конце идут контакты и завершение. В шаблоне есть выбор нескольких вариантов, кнопки «Назад» и кнопка «Пройти заново». Тексты, варианты ответов и связи можно править после создания, ветвление наглядно видно на карте сценария.
- Файл проверяется перед импортом: формат, число шагов (до 300), число вариантов в шаге (до 100) и коды.
Над списком заявок стандартный фильтр: поиск по контактам, сценарий, статус и период. Результат разбит на страницы, а групповое действие «для всех» применяется ко всем заявкам по фильтру. В карточке заявки на вкладке «Доставка» видны каналы (почта, Telegram, Битрикс24), статус, число попыток и последняя ошибка.
Событие для интеграторовПосле сохранения заявки вызывается событие OnLeadCreated модуля xlogic.leadbot. В параметрах: LEAD_ID, SCENARIO_ID, CONTACTS (имя, телефон, email и другие контакты) и ANSWERS.
AddEventHandler('xlogic.leadbot', 'OnLeadCreated', function (\Bitrix\Main\Event $event) {
$leadId = (int)$event->getParameter('LEAD_ID');
// your integration
}); |
Права доступа
Права на модуль задаются в Настройки → Пользователи → Группы пользователей → нужная группа → вкладка «Доступ» → Чат-бот для заявок: сценарии, Telegram и Битрикс24:
- «Доступ закрыт»: раздел не виден.
- «Чтение»: просмотр заявок, сценариев, аналитики и настроек, скачивание файлов и выгрузка.
- «Запись»: изменение заявок, сценариев, шагов и настроек.
Настройки → Настройки продукта → Модули → Чат-бот для заявок → «Удалить». На втором шаге по умолчанию стоит флажок «Сохранить таблицы, данные и загруженные файлы»: заявки, сценарии, настройки и файлы останутся и будут доступны после повторной установки. Снимите флажок, чтобы удалить всё без возможности восстановления.
Сайт: xlogic.ru
Время работы: пн–пт с 10:00 до 19:00 (МСК, UTC+3).
Время реакции на заявку: в течение 1 рабочего дня
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
