Инструкция: Soft Lite Registration Bot

Версия 1.2.0. Настройка SL REG Bot, очередь клиентов, менеджеры, ссылки, рассылки и XLSX.

Быстрый старт

Запустите SoftLiteRegBot.exe и активируйте лицензию.
На странице «Боты на этом ПК» добавьте Bot Token и проверьте профиль.
При необходимости добавьте администраторов. Manager Chat можно не подключать.
Запустите бота.
Добавьте менеджеров через Telegram ID или одноразовую ссылку.
Откройте бота с тестового аккаунта и нажмите START.
Откройте «Новые заявки», возьмите клиента и отправьте ответ.
Верните карточку в очередь или закройте её с результатом.

Запуск, активация и несколько ботов

License Key привязан к Hardware Code этого Windows-компьютера. После активации открывается страница «Боты на этом ПК». Один экземпляр программы управляет несколькими Telegram-ботами. У каждого бота отдельные клиенты, менеджеры, START history, ссылки, приветствие, рассылки, статистика, настройки и локальная база.

В карточке бота доступны «Открыть», Start, Stop и Restart. Закрытие окна скрывает интерфейс; запущенные боты продолжают работать. «Завершить работу программы» останавливает backend и всех ботов.

Настройки и приветствие

Для каждого бота отдельно задаются Bot Token, администраторы, оформление и приветствие. Текст приветствия — до 1024 символов. Изображение — JPEG или PNG до 5 МБ. Можно отправлять только текст, только изображение или оба варианта.

START, источник и ссылки

Первый START сохраняет Telegram-профиль, постоянный номер клиента и источник. Повторный START не создаёт дубликат клиента, но добавляет новое обращение. Пакеты deep links содержат 1, 5, 10, 15 или 20 ссылок. Пакет можно открыть и скачать; ссылку — копировать, отключить и снова активировать. Старые ссылки находятся в пакете «Старые ссылки».

Входящие и CRM-карточка

START или новое сообщение создаёт обращение со статусом «Новый». Администратор открывает «Заявки» → «Новые», менеджер — «Новые заявки». Карточка показывает «Клиент №», имя, username, Telegram ID, источник, статус, ответственного, даты, результат и комментарий.

Взять в работу

START → Новый → Взять в работу → В работе

Свободную заявку может взять активный сотрудник. Он становится ответственным. Менеджер видит «Мои клиенты»: общую очередь новых, свои заявки в работе и свои закрытые. Administrator и MAIN ADMIN видят новые, в работе, закрытые и все клиентские карточки.

Сообщения и Manager Chat

Сообщения клиента приходят ответственным сотрудникам. Для ответа используйте «Написать от бота». Private staff delivery работает без Manager Chat. Если общий чат настроен, Reply на связанную карточку тоже может отправить ответ клиенту.

Manager Chat — дополнительный канал. Он не обязателен. Участник Manager Chat автоматически не получает CRM-права.

Возврат, закрытие, reopen и reassign

«Вернуть в очередь»: IN_WORK → NEW, ответственный снимается.
«Закрыть»: результат «Успешно», «Неуспешно» или «Другое»; комментарий — до 1024 символов.
«Вернуть в работу»: CLOSED → IN_WORK.
«Переназначить»: администратор передаёт заявку в работе другому активному менеджеру.

Менеджеры и роли

Команда /managers открывает активных, ожидающих и отключённых сотрудников, их карточки и статистику. Менеджера добавляют по Telegram ID или одноразовому приглашению. По ссылке приглашения сотрудник нажимает START, профиль связывается с записью, статус становится active и открывается staff panel. Этот START не создаёт клиентскую карточку.

Роль / статус	Доступ
MAIN ADMIN	Администраторы, менеджеры и все CRM-записи.
Administrator	CRM и управление сотрудниками в разрешённых пределах.
Manager	NEW, TAKE, свои IN_WORK/CLOSED, ответы, возврат, закрытие и reopen.
Pending	Создан, но не активирован через /start.
Disabled	Доступ выключен; клиенты в работе возвращаются в очередь.

Пользователи, статистика и XLSX

Desktop UI сохраняет прежние данные пользователей, START history и статистику источников. Telegram показывает CRM-итоги и статистику менеджеров. XLSX содержит фактические листы «Обращения», «Уникальные пользователи», «Клиенты» и «Менеджеры».

Рассылки, лог и обслуживание

Рассылка работает только по базе выбранного бота. Лог показывает запуск, остановку, ссылки, рассылки, импорт и ошибки. Cleanup может очистить обращения, пользователей или данные выбранного бота. Legacy import копирует старую базу в новое отдельное хранилище; исходные файлы не удаляются.

Данные и переустановка

Ваш бот. Ваш токен. Ваша база.

SL REG Bot работает на Windows-компьютере пользователя. Рабочие данные находятся в %PROGRAMDATA%\SoftLite\RegistrationBot\instances\. CRM, клиенты, менеджеры, ссылки и START history каждого бота разделены. Bot Token используется для обращения к Telegram Bot API. Soft Lite не получает автоматическую копию рабочей базы.

Перед переносом или переустановкой сохраните папку данных и обратитесь в поддержку, если изменился Hardware Code.

Если что-то не работает

Симптом	Что проверить
Бот не отвечает	Bot Token, статус бота и Интернет.
Новая заявка не видна	Бот запущен, сотрудник active и открыт список «Новые заявки».
Ответ не дошёл	Заявка в работе, сотрудник остаётся ответственным, клиент не заблокировал бота.
Manager Chat не подключён	Это не мешает CRM и личной доставке сотрудникам.