Перейти к содержанию

Настройка интеграции контроллера с Telegram

1. Включение Telegram в прошивке

  1. В конструкторе прошивок включите опцию Telegram и в шестеренке выберите
    Telegram настройка
  2. Установите:
  3. Количество алиасов — количество кнопок для управления в Telegram боте
  4. Список пользователей — количество пользователей, имеющих доступ к управлению через бота
  5. Включите опции Поддержка управления и Ответы на русском.

2. Настройка Telegram

  1. Создайте бота, в который будет поступать информация, и узнайте его API токен (см. раздел “Дополнительные шаги”).
  2. Важно: Управление ботом осуществляется с другого аккаунта, не с того, с которого он был создан.
  3. Узнайте Telegram Chat ID пользователей, которым необходим доступ к управлению (см. пункт 2.1).
  4. Добавьте бота в контакты и отправьте ему команду /start.

3. Настройка уведомлений (Notifications) в контроллере

  1. В разделе Config перейдите на вкладку Notifications

  2. Заполните поля:

  3. Bot data — API токен бота.

  4. Chat id — ID пользователя.

  5. Включите галочку Enable Telegram send and control

  6. Сохраните настройки кнопкой SET и проверьте работу с помощью TEST. В боте должно прийти сообщение вида: 

Test msg: Uptime: 0 day 01:23:46. Time: 16:54:23

4. Настройка команд (Command Alias)

На вкладке Command Alias отображаются кнопки для управления в боте. Поддерживаемые команды (опции должны быть включены в прошивке):

  • setgpio X Y — управление GPIO, включая VGPIO и D2D.
  • setpwm X Y — управление PWM.
  • settermo X Y Z — управление термостатом: X - номер, Y - верхняя граница, Z - нижняя граница.
  • gettermo X — чтение настроек термостата.
  • ontermo X / offtermo X — включение/выключение термостата.
  • radio XXX — управление радио по имени, номеру или URL станции.
  • info — вывод полезной информации.
  • hard — список установленных опций на модуле.
  • restart — перезапуск модуля.
  • ver — дата и версия прошивки.
  • geturl URL — отправка и чтение GET-запросов.
  • cam — получение изображения с подключенной к esp32 камеры.
  • wol x — пробуждение устройств через WakeOnLan.
  • valdes X Y — установка переменной конструктора кода.

Пример управления GPIO через Web_Key

  1. В поле Name введите значение, отображаемое в боте.

  2. В поле To введите команду управления из п. 3.2. Например, для управления GPIO:

setgpio X Y

где X — номер GPIO, Y — состояние (1 - включить, 0 - выключить)

На вкладке Web_Key выводимые GPIO выглядят следующим образом

Отображение кнопок в боте Telegram

5. Настройка списка пользователей (User list)

  1. Для предоставления доступа пользователям внесите их Chat ID в поле User ID (см. п. 1.2).
  2. Пользователи должны добавить бота в контакты и отправить команду /start для активации.

6. Настройка отправки текстовых сообщений

  1. Для настройки отправки текстовых сообщений включите опцию Текстовые шаблоны
    Текстовые шаблоны
  2. Укажите Максимальное количество SMS шаблонов для отправки
  3. На вкладке Text Template введите необходимые текстовые шаблоны, ссылаясь на документацию.
  4. В поле Command введите название кнопки для вывода в Telegram

  5. В блоке TEST отображается текст, который будет отправлен в сообщении. На вкладке Metrics в разделе Config можно найти доступные метрики для отображения.