A4 и A4MAX. Интеграция с мессенджером Telegram [версия ПО 0.05]
Автор: Дмитрий ГамалинВведение
В устройствах A4 и A4MAX поддержано взаимодействие с Telegram-ботами.
Функциональные возможности Telegram-бота:
- Получение геолокации, напряжения бортовой сети транспортного средства и резервного АКБ, скорости, ID-метки водителя, состояния детектора поездок и т.д.
![](/file/dca456bdd4752cd48b7bb.png)
- Совместное использование функционала «Логика пользователя» позволяет получить информацию о событиях, созданных самим пользователем по инструкции (для чего необходимо выбрать действие из справочника –> «отправить сообщение в Telegram»)
![](/file/6a57c0d825b9972b3cb88.png)
- Отправление текстовых команд (*SERV*, *GETN*, *SETN*).
![](/file/0b4c94db0723dd9c46fd5.png)
@Monitoring_Bot_bot
Для данного функционала есть готовый системный бот у которого предустановлены кнопки с командами для изменения интервала выдачи геолокации объекта, обновления настроек или ПО. Чтобы появилось меню бота, достаточно отправить в чат "/start"
![](/file/4df1483c135263c6e5cab.png)
Для настройки трекера с данным ботом token не требуется, а ID пользователя выдаётся после того, как напишите боту "/start" (подробнее в разделе «Настройка»).
Передача данных
Типы данных передаются в виде эмодзи. Описание эмодзи:
![](/file/d835e83d0b4ff044220da.png)
![](/file/ca6be0207c8336e79d66e.png)
Настройка
Для настройки трекера в разделе «Telegram» нужно ввести следующие данные:
![](/file/199ba24a8e440bbb635c1.png)
- Token бота
При использовании готового системного бота @Monitoring_Bot_bot поле данного параметра требуется оставить пустым.
Если хотите использовать своего бота, то для этого напишите пользователю @BotFather и следуйте его инструкциям. После создания своего бота получите его уникальный token.
- ID пользователя, группы или канала
Можно настроить передачу данных как в индивидуальный чат пользователя с ботом, так и в группу или канал.
При использовании @Monitoring_Bot_bot требуется нажать на кнопку «запустить» или отправить /start и он напишет ID текущего чата.
![](/file/518ffe20c368003ac66b5.png)
Для получения ID другого пользователя, группы или канала можно воспользоваться ботом @myidbot.
ID своего аккаунта можно получить, выбрав в меню команду бота /getid.
![](/file/319615f7c5ce1361a119e.png)
ID аккаунта другого пользователя можно получить, переслав любое сообщение пользователя данному боту.
![](/file/f94f5fe4826e3c89f0b33.png)
Для получения ID-канала или группы нужно добавить бота и отправить соответствующую команду.
В канале на время получения ID требуется сделать бота администратором
![](/file/ff2a53eaccab497f23b28.png)
Также в канале необходимо назначить бота, передающего данные с трекера, в качестве администратора.
- Название устройства для сообщений
Название устройства, записанное в поле, будет передаваться в сообщениях. Допустимо использование только прописных букв английского алфавита.
![](/file/558bac3732ee647d527e9.png)
Если поле оставить пустым, в сообщениях будет отображаться IMEI.
![](/file/4e1ae094f52237456206c.png)
- Интервал передачи геолокации устройства
Значение данного параметра указывается в минутах. Для отключения передачи данных о местоположении нужно выставить нулевое значение.
Для удобной и быстрой смены интервала передачи геолокации устройства просто отправьте в чате число минут (максимальное значение – 180) или выберите количество минут с помощью системного меню (при использовании @Monitoring_Bot_bot).
![](/file/498c7abaeb7a4c4f33162.png)
После подтверждающего сообщения новая настройка будет применена.
Данный функционал позволяет использовать дополнительные варианты работы с Telegram. Возможно получение информации о событиях из сценариев, построенных самим пользователем по инструкции (для чего необходимо выбрать действие из справочника –> «отправить сообщение в Telegram»).
![](/file/0756c88d4affcbda9588f.png)
- Часовой пояс
Для отображения в сообщениях актуального времени геолокации или события в разделе «Системные» необходимо выбрать часовой пояс.
![](/file/3360b32262ca96fdfe92f.png)
![](/file/f7b2d8f59251bcae1d963.png)
При настройке через web-конфигуратор требуется отправить устройству SMS- или TCP-команду для обновления. Если настройка производится через локальный конфигуратор (Windows), то достаточно нажать на кнопку сохранить.