====== Установка ======

===== Лицензирование =====
ProBonus Bot не имеет собственной лицензии и не требует отдельного лицензирования.
При работе он проверяет лицензию сервера ProBonus и наличие в ней соответствующей "фичи" ТелеграмБот.

===== Создание Бота в Телеграм =====

Перед началом настройки модуля необходимо создать своего Бота в Telegram [[https://wiki.carbis.ru/external/zz_дополнительные_материалы/01_telegram_bot|как описано тут]].

**Важно!** При создании Бота обязательно заполните поле 
"Description (описание)" - Текст, который пользователи будут видеть в начале диалога с ботом под заголовком «Что может делать этот бот?».
===== Установка =====

  - Скачать [[https://disk.yandex.ru/d/PMyz9_qcm9TSxw|Актуальный дистрибутив телеграм-бота для ProBonus]].
  - Распаковать архив в отдельную папку. 

В дистрибутиве содержатся следующие файлы:
<code>
desktop.bat       - запуск сервера в экранном режиме
install.bat       - установка сервера службой (запускать с правами Администратора)
uninstall.bat     - удаление службы сервера (запускать с правами Администратора)
</code>

Первый запуск приложения рекомендуется провести через desktop.bat
В процессе запуска возможно появления сообщение от брандмауэра или антивируса с запросом на сетевой доступ для нового приложения. Необходимо «Разрешить» доступ.

Результатом успешного запуска является вот такое окно.
{{:external:pro_bonus:04_probonus_tbotv2:01_setup:pasted:20230904-090626.png}}

Проверить работу модуля можно перейдя по ссылке [[http://127.0.0.1:11031|http://127.0.0.1:11031]]. 
Порт 11031 - является значением по умолчанию.
{{:external:pro_bonus:04_probonus_tbotv2:01_setup:pasted:20230904-120759.png}}
Для авторизации в модуль используется та же учетная запись, которая используется для web-интерфейса ProBonus (по умолчанию user/123).

Если сервер ProBonus размещен на том же компьютере, где установлен сервер телеграм-бота и работает на порту 11030 (значение по умолчанию), то после ввода валидного логина и пароля произойдет вход.
Если серверная часть ProBonus расположена на другой машине и/или другом порту, то дополнительно потребуется указать верные данные для подключения.
{{:external:pro_bonus:04_probonus_tbotv2:01_setup:pasted:20230904-123425.png}}

После проверки можно завершить работу нажатием кнопки “Закрыть приложение”. 
В папке с модулем появится файл **TBotProBonus_settings.yaml** - это файл конфигурации (настроек) модуля. 
Если порт 11031, используемый по умолчанию для запуска службы бота занят, то его можно изменить в данном файле (параметр server_settings->port).

Далее рекомендуется установить сервер ProBonus в качестве службы (install.bat) и запустить установленную службу.
{{:external:pro_bonus:04_probonus_tbotv2:01_setup:pasted:20230906-090922.png}}