Версия ПО Приток-А ни ниже 3.7.0.128, но желательно 3.7.1 (60)+
Версия Приток-Охрана-WEB не ниже 2.0.0.19.

************************************************************
Схема взаимодействия:
************************************************************

[Ядро] - (tcp) - [Приток-Охрана] - (httpS) - [Telegram] 

************************************************************
Принцип работы:
************************************************************

Пульт создает бота в системе "Telegram". Как создавать бота - отдельная инструкция (см ниже).
Этот бот работает на сервере "Telegram" и имеет уникальное имя. Например: "GrdPritokRu_Bot".

В настройках в админке "Приток-Охрана" указывается с каким ботом ему работать. 
Для одного "Приток-Охрана" один бот.
Один бот пульта обслуживает всех пользователей пульта, у которых есть аккаунт в "Приток-Охрана".
"Приток-Охрана" периодически опрашивает бота, получая сообщения, которые пишет пользователь (команды пользователя).
Нужные уведомления и сообщения для пользователя "Приток-Охрана" отправляет пользователю через бота.

Аккаунт пользователя "Приток-Охрана" привязывается к уникальному идентификатору чата, открытого пользователем с ботом.
"Приток-Охрана" хранит связку "аккаунт-чат" в специальном файле. Путь к файлу настраивается в админке.
Связка происходит через указание в профиле "Приток-Охрана" кода авторизации, полученного пользователем при начале работы с ботом.

При возникновении событий на объекте, "Приток-Охрана" ищет аккаунт для этого объекта.
Проверяется настроено ли для этого аккаунта в (профиле пользователя) оповещение через "Telegram". 
Если да, то "Приток-Охрана" отправляет уведомление (сообщение) пользователю в чат от имени бота (через бота).

Для того, чтобы отключить бота - нужно отключить внешнее оповещение в настрйках "Приток-Охрана" (убрать галочку).
Для того, чтобы пользователю перестать получать уведомления - удалить связку в профиле через ЧИ "Приток-Охрана".

Должен быть открыт порт 80 для работы с сервером "Telegram".


************************************************************
Иснтрукция:
************************************************************

1. "Telegram"

- При помощи бота @BotFather создать собственного нового бота, сохранить API Token. 
  Указать подсказку, задать иконку, написать контакты для обратной связи.
  См инструкцию ниже.

2. "Приток-Охрана"

- Зайти в админку "Приток-Охрана". 
  Во вкладке "Настройки" прописать параметры созданного бота в пункте "Внешние сервисы оповещения". 
  Указать наименование бота и API Token, полученный при создании бота.
- Никому не сообщать API Token!
- Сообщить пользователям имя бота (*).


3. Пользователю

- Установить приложение "Telegram" на смартфон (компьютер).
- В "Telegram" добавить бота по имени (*) в список контактов. Нажать /start. Получить код авторизации.
- Зайти в частный интерфейс "Приток-Охрана" (через браузер) и в профиле пользователя прописать полученный код авторизации.
- Убедиться, что пользователь зарегистрирован - будет сообщение от бота в "Telegram".


************************************************************
Иснтрукция: Как создать Telegram бота?
************************************************************

Для начала необходимо зарегистрировать в Telegram нашего будущего бота. Это делается следующим образом:
- Необходимо установить приложение Telegram на телефон или компьютер.
- Добавляем к себе в контакт-лист бота с именем BotFather
- Запускаем процедуру «общения» с ботом нажатием кнопки Start. Далее перед нами предстанет список команд.
- Для того, чтобы создать нового бота необходимо выполнить команду /newbot и следовать инструкциям. 
  Обратите внимание, что username для бота должен всегда содержать в конце слово bot. Например, PCN-1_Bot или UVO_Irk_bot.
  Придуманное имя нужно прописать в админке Приток-Охрана.

После создания бота, обратите внимание на строку с текстом: "Use this token to access the HTTP API: ..."
Этот токен должен быть прописан в админке Приток-Охрана. Не сообщайте его никому.

Помимо функции создания telegram бота, BotFather также имеет ряд других возможностей:
- Присвоить боту описание
- Установить аватар (иконку) 
и так далее. 
Полное описание доступных команд можно увидеть набрав команду /help в чате с BotFather.

Примеры описания для бота:
 about: Обеспечивает возможность получения уведомлений от Вашей охранной системы.
 descr: С помощью бота от ... Вы сможете получать уведомления от Вашей охранной системы и взаимодействовать с ней.