Инструкция по эксплуатации программы «СиБот»

1. Вход в панель администратора

Адрес: https://ваш-домен/admin, логин и пароль — из параметров ADMIN_USER и ADMIN_PASSWORD.

2. Первичная настройка (раздел «Настройки»)

Заполнить и сохранить: название организации, приветствие, текст согласия на обработку персональных данных, контакты, ответ на случай отсутствия сведений, инструкцию ассистенту. В инструкции ассистенту обозначение {org_name} заменяется названием организации.

3. База знаний (раздел «База знаний»)

• «Загрузить файл» — документ .txt, .md, .docx или .pdf до 10 МБ;
• «Добавить текстом» — название и текст документа;
• «удалить» в строке документа — документ перестаёт использоваться в ответах;
• «Пересчитать векторы» — после подключения сервиса векторов.

Документ доступен ассистенту сразу после загрузки. Рекомендуется делить материалы на разделы с заголовками: так ответы точнее. Устаревший документ следует удалить и загрузить новую версию.

4. Работа с обращениями

• «Заявки» — список заявок: суть, имя, канал, телефон, дата;
• «Переписка» — диалоги пользователей; в открытом диалоге оператор может ответить пользователю;
• о каждой новой заявке оператор получает сообщение в мессенджере (если задан STAFF_CHAT_ID).

5. Рассылка

Раздел «Рассылка»: ввести текст и нажать «Отправить». Сообщение получат пользователи, давшие согласие, в каналах из параметра PROACTIVE_CHANNELS. Посетителям сайта рассылка не отправляется.

Рассылка по списку из Excel

1. Подготовить файл .xlsx: первая строка — заголовки «Канал», «Тип», «Получатель», «Текст». «Канал» — max или telegram; «Тип» — чат или пользователь; «Получатель» — идентификатор чата или пользователя; «Текст» — сообщение (до 4000 знаков). В файле до 5000 строк.
2. В разделе «Рассылка» выбрать файл и нажать «Проверить файл». Если есть ошибки, они показаны с номерами строк — исправить файл и загрузить заново.
3. Отправить пробное сообщение себе: указать канал, тип и свой идентификатор, нажать «Пробная отправка».
4. Нажать «Отправить рассылку». По окончании показано число отправленных; если часть строк не доставлена, повторное нажатие отправит только их. Отчёт по строкам — «Скачать отчёт».

Бот должен быть участником чатов, в которые идёт рассылка.

6. Действия пользователя

Пользователь открывает бота в мессенджере или чат на сайте, даёт согласие, после чего может задать вопрос, оставить заявку или запросить контакты. Команды: /start, /menu, «меню», «отмена».

7. Голосовые сообщения

Если голосовой режим включён, пользователь может отправить голосовое сообщение в мессенджере или нажать кнопку с микрофоном в чате на сайте (браузер запросит доступ к микрофону). Вопрос распознаётся и показывается текстом, ответ приходит текстом; на сайте его можно прослушать кнопкой у ответа, в Telegram ответ дублируется голосовым сообщением. Длина записи — до двух минут.

8. Типовые неполадки