Окно "Сообщения Telegram"

Previous

Сервис "Использовать Telegram" работает на основе известного интернет-мессенджера "Telegram".

Эта опция позволяет отправлять произвольные сообщения, текущее состояние датчиков и картинки графиков логгеров к выбранным пользователям мессенджера Telegram.

Кроме того, из Telegram можно отправлять команды  удалённого управления



Особенности использования мессенджера.


Перед началом использования этой опции, надо в мессенджере "Telegram" создать своего "Бота". Создаётся он с помощью встроенного в Telegram-систему бота BotFather.  

Первым делом, если Вы ранее не использовали Telegram, надо зарегистрироваться в  мессенджере, добавить в контакты бота "BotFather" и  через чат с ним можно управлять своими ботами.





Вот краткая пошаговая инструкция:

1. Открываем  в "Telegram"  чат с ботом "BotFather" и создаём своего бота командой /newbot .

2. После этого система предложит ввести имя вашему боту, а так-же предложит указать пользовательское имя боту с обязательным окончанием имени на bot или _bot.

3. Если этот этап будет пройдёте успешно, система выдаст уникальный идентификатор бота (набор символов и цифр), он будет  примерно такого вида: 1417136097:AAGz******BQVph6.

4. Запускаем программу "Бенукс", переходим в окно "Сообщения Telegram".

5. На закладке "общие настройки" в окно "ID бота" надо скопировать тот самый идентификатор бота, который нам выдала система "Telegram".

6. В верхней части окна "Сообщения Telegram" поставьте галку "Активен сервис Telegram".

7. На закладке "общие настройки" поставьте галку "отправлять сообщения".

8. На закладке "приём Telegram" поставьте галку "принимать команды".

9. В  мессенжере "Telegram" добавляем своего созданного бота и через него работаем с программой Бенукс, используя команды    удалённого управления как в режиме командной строки, так и с использованием  "кнопочного" интерфейса.


В последствии, этого бота можно подключить одновременно к нескольким пользователям месенжера Telegram и они смогут удалённо работать с программой Бенукс.


Важное замечание: Одного и того-же бота нельзя использовать на двух и более одновременно работающих программах Бенукс. Для каждой программы надо создавать отдельного бота с уникальным ID. Таким образом, если Вы хотите управлять двумя программами Бенукс, у Вас в Телеграм будет соответственно, два различных бота.



Вот примеры скрин-шотов:

             


В нижней части мессенжера "Telegram" находится основное меню, в котором заложены не все, но основные команды, а в командной строке можно использовать весь перечень команд Удалённого управления.

По команде "HELP" тоже выводятся только основные команды, чтобы не загромождать экран смартфона.


Таким образом, для диалога с телеграм-ботом имеются три варианта:

- нажатие на кнопки (нижнее меню или кнопки в сообщениях).

- нажатие на слова с передним слешем, например: /STARTBENUKS (они выделяются синим цветом).

- ввод команд вручную в поле ввода  сообщений.



Вся работа с Telegram-сообщениями выполняется на нескольких закладках.


Закладка  "общие настройки".


Прежде всего,  здесь находится идентификатор Вашего бота, полученный при его создании в системе "Telegram".

Кроме того, на этой закладке можно тестировать отправку произвольных текстовых сообщений пользователям Telegram. Причём, список пользователей появится только после того, как каждый пользователь пришлёт Вашему боту произвольное сообщение, так сказать проведёт инициализацию диалога. Более подробно об этом - на закладке "приём Telegram".

Опция "метки времени" используется для тех сообщений, которые имеют режим "автообновление", он описан ниже.

Стандартный формат для меток времени содержит символы латинского алфавита. Он имеет такой вид: DD.MM.YYYY hh:mm:ss  Каждый пользователь может этот формат изменить, добавить свой текст на руском языке, можно использовать только часть указанных латинских символов и  в любой последовательности, можно заменить разделители или добавить свои символы.


Режим "автообновление" сообщений.

Когда система Беукс находится в режиме сканирования, она автоматически обновляет сообщение в телеграм, если пользователь задал одну из этих команд:

- вывод текущего состояния указанного логгера

- вывод состояния всех датчиков

- меню управления устройствами

Любая последующая команда, введённая пользователем в телеграм прерывает автоматическое обновление. Причём, очистка чата или выход из месенжера Telegram не останавливает обмен и Бенукс продолжает посылать обновлённые сообщения. Поэтому если Вы решили закончить диалог с программой Бенукс, просто введите любую команду, которая не использует автообновление сообщений, например команда STATUS.



Закладка  "настройка прокси".


Здесь находятся настройки, позволяющие программе Бенукс работать с системой "Telegram" через сторонние прокси-сервера. Обычно это не требуется и в опции "Тип прокси" надо выбрать "Без прокси".



Закладка  "приём Telegram".


На этой закладке находятся настройки для управления сообщениями, принимаемыми от других пользователей Telegram. Опция "принимать команды по Telegram" позволят включать или отключать приём и обработку сообщений.

После того, как на закладке "общие настройки" был задан ID бота, пользователям Telegram рекомендуется выполнить инициализацию чата. Делается это так:

1. На закладке "приём Telegram" надо отключить опцию "контроль номера чата".

2. Включить опцию "принимать команды по Telegram".

3. Пользователи  Telegram присылают  сообщения. Это могут быть как произвольные текстовые строки, так и команды удалённого управления Бенукс. При приёме сообщений формируется список пользователей, которым в дальнейшем Бенукс сможет отправлять состояния датчиков и картинки графиков командами сценариев.


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


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



Закладка  "логи".


В процессе использования Telegram-сообщений,  формируется протокол работы. На этой закладке указывается, где хранится протокол работы. Он может дописываться в общий лог системы «Бенукс», может формировать отдельный файл с указанным именем. Кроме того, для удобства есть возможность видеть эти сообщения и в окне «Использовать Telegram». Для этого активируется опция «Показывать протокол» и устанавливается максимальное количество строк. Таким образом, на экране всегда показываются последние актуальные сообщения, а более ранние затираются. Следует отметить, что на лог-файл эта настройка не распространяется и там накапливаются  все,  с начала работы системы.



























Created with the Personal Edition of HelpNDoc: Easily create Help documents