Этап 3. Установка и настройка бота

3.1. Запустите MSI-установщик

Запустите скачанный MSI-файл (например, esqon_telegram_1.0.0.msi).

💡 Примечание Если бот устанавливается в защищённый каталог Windows (например, Program Files), установщик может запросить права администратора. В корпоративной среде заранее согласуйте запуск установщика с ИТ-администратором.

Установщик предложит:

Выбрать папку установки (по умолчанию: C:\Program Files\Esqon\Telegram\ или ...\MAX\).
Заполнить параметры подключения к 1С:
- Токен бота (Telegram-токен от @BotFather или MAX-токен)
- URL HTTP-сервиса 1С (например, http://192.168.1.100/MyBase/hs/Esqon)
- Логин пользователя 1С
- Пароль пользователя 1С
Создать ярлык на рабочем столе (опционально).

Нажмите «Установить» и дождитесь завершения.

💡 Совет Параметры подключения можно заполнить прямо в MSI-установщике. Если это не было сделано при установке или параметры нужно изменить позже, их можно указать вручную в конфигурационном файле.

3.2. Где взять токен бота

Для Telegram:

Откройте @BotFather в Telegram.
Отправьте команду /newbot.
Следуйте инструкциям: укажите имя и username бота.
BotFather выдаст токен вида 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.

Для MAX:

Создайте и верифицируйте профиль организации на платформе MAX для партнёров.
Перейдите в раздел «Чат-боты» и нажмите «Создать».
Заполните карточку бота и отправьте её на модерацию.
После успешной модерации откройте: «Чат-боты» → «Интеграция» → «Получить токен».
Скопируйте выданный токен.

3.3. Ручная настройка конфигурации

Если вы не заполнили параметры при установке или хотите изменить их позже, отредактируйте файл конфигурации:

Telegram-бот: *\Esqon\Telegram\config\config_tg.ini
MAX-бот: *\Esqon\MAX\config\config_max.ini

Пример файла config_tg.ini:

[SETTINGS]
; Токен бота от @BotFather в Telegram
TELEGRAM_TOKEN = 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

; URL HTTP-сервиса 1С (без слеша в конце)
URL_1C_BASE = http://192.168.1.100/MyBase/hs/Esqon

; Логин пользователя 1С для HTTP-авторизации
AUTH_LOGIN = БотEsqon

; Пароль пользователя 1С (оставьте пустым если пароля нет)
AUTH_PASSWORD = МойПароль123

; Проверять TLS-сертификат сервера 1С (true/false)
ONEC_VERIFY_TLS = false

; Путь к CA-bundle файлу для самоподписанных сертификатов
ONEC_CA_BUNDLE =

; Таймаут HTTP-запросов к 1С в секундах
HTTP_TIMEOUT = 30

; Уровень логирования: DEBUG, INFO, WARNING, ERROR, CRITICAL
LOG_LEVEL = INFO

Для MAX-бота файл аналогичен, только вместо TELEGRAM_TOKEN используется MAX_TOKEN.

💡 Пояснение по TLS

ONEC_VERIFY_TLS — проверка TLS-сертификата сервера 1С. Актуально только если URL_1C_BASE начинается с https://.
Если база опубликована по http:// внутри локальной сети — этот параметр не используется.
Если база по https:// с самоподписанным сертификатом — установите ONEC_VERIFY_TLS = false или укажите путь к сертификату в ONEC_CA_BUNDLE.

💡 Пояснение по уровню логирования

LOG_LEVEL = INFO — стандартный режим. Бот записывает основные события: запуск, подключение, ошибки.
LOG_LEVEL = DEBUG — расширенный режим. Бот записывает все запросы к 1С, ответы и промежуточные данные. Используйте при проблемах: переключите на DEBUG, воспроизведите проблему и отправьте лог разработчику. После решения верните на INFO.

💡 Окно статуса бота В окне статуса бота (значок в системном трее → правый клик → «Открыть статус») можно быстро открыть папку с логами и папку с конфигурационным файлом.