SMACONT | Обмен данными. Telegram

Содержание

Общие данные
Начало работы
Действие «telegram_Send()»

Общие данные

Для обмена с мессенджером «Telegram», прошивка «Smacont-ESP» использует сервис «Whatabot API».

Передача данных осуществляется только в одну сторону: «устройство» -> «Telegram».

СТАБИЛЬНОСТЬ отправки данных в «Telegram» и БЕЗОПАСНОСТЬ пересылаемой информации, ЦЕЛИКОМ И ПОЛНОСТЬЮ зависят от сервиса «Whatabot API».

Вся работа с сервисом «Whatabot API» производится НА СВОЙ РИСК.

Претензии по работе сервиса «Whatabot API» НЕ ПРИНИМАЮТСЯ.

Данный способ передачи РЕКОМЕНДУЕТСЯ использовать только ДЛЯ ПЕРЕДАЧИ НЕКРИТИЧНОЙ ИНФОРМАЦИИ.

Начало работы

Основным преимуществом сервиса «Whatabot API» является простота использования и отсутствие какой-либо регистрации в системе.

Для начала работы необходимо:
1. в поисковой строке мессенджера «Telegram» набрать «@whatabotapi_bot» (без кавычек, символ «@» обязателен);
2. в открывшемся окне бота нажать кнопку «Start» и отправить сообщение «I allow whatabot to send me messages» (без кавычек);
3. в ответ на сообщение, будет выслана ссылка: «https://api.whatabot.net/telegram/sendMessage?apikey=XXXXXXXX&text=Hello%20from%20Whatabot&chatId=XXXXXXXXX»;
4. сохранить значения «apikey» и «chatId». В дальнейшем, данные значения, будут использоваться в действии «telegram_Send()».

«Whatabot API». Начало работы

Если вы забыли свой ключ API, отправьте «I allow whatabot to send me messages» (без кавычек) еще раз, и Whatabot отправит вам ключ, который у вас был.

Если вы хотите изменить свой ключ API, «I want to update my apikey» (без кавычек), и Whatabot отправит вам новый. Обратите внимание, что вам придется изменить ключ во всех действиях «telegram_Send()», на всех используемых устройствах!

Если вы хотите удалить свою учетную запись Telegram Whatabot, отправьте сообщение «I want to delete my account».

«Whatabot API». Удаление учетной записи

Действие «telegram_Send()»

Для передачи данных в мессенджер «Telegram», используется действие «telegram_Send()».

В качестве параметров, действие использует заранее заполненные шаблоны.

Действие «telegram_Send()»

ApiKey

Значение параметра находится в ссылке, полученной от бота (см. п.3,п.4). Никому не сообщайте значение параметра «ApiKey».

ChatId

Значение параметра находится в ссылке, полученной от бота (см. п.3,п.4). Никому не сообщайте значение параметра «ChatId».

Шаблон для отправки

Содержит сообщение, отправляемое в мессенджер «Telegram». Ознакомиться с форматом записи шаблонов можно в статье «Текстовые шаблоны».

Состояние обмена

Параметр «Состояние обмена» предназначен для контроля состояния обмена между устройством и сервисом. Для этого необходимо «привязать» параметр, к любой переменной «Vx». Значения параметра «Состояние обмена» перечислены здесь.