Sprut.hub Wiki - Вклад [ru]

Создание контроллера Xiaomi

2025-09-11T13:03:49Z

Permadm:

== Создание контроллера Xiaomi ==
{{QuoteYellow|WiFi устройства Xiaomi подключаются к локальной сети вашего дома с помощью вашего же роутера. Они настраиваются в родном приложении и уже после этого - становятся доступны для управления из Sprut.hub через контроллер Xiaomi}}
{{QuoteGreen|Для локального подключения Bluetooth светильников(спотов) Xiaomi и Yeelight в Sprut.hub - требуется Yeelight Gateway YLWG01YL/YZNA0319028WTEU которые умеют работать с Apple Homekit. Дальнейшее подключение светильников, осуществляется [https://wiki.spruthub.ru/Создание_контроллера_HomeKit_(Обратный_HomeKit) через обратный HomeKit]}}
{{QuoteBlue|Sprut.hub подключается к серверам Xiaomi с вашей учетной записью и получает оттуда необходимые реквизиты для локального управления. Вы получаете возможность управлять своими устройствами одновременно через приложение MIHome и из Sprut.hub}}

Для создания контроллера Xiaomi, вам необходимо перейти в раздел "Контроллеры" и добавить новый контроллер
[[Файл:Xiaomi 001 Создать контроллер.png|центр|обрамить]]
Выбрать тип Xiaomi
[[Файл:Xiaomi 002 Создать контроллер.png|центр|обрамить]]
И нажать сохранить.

== Настройка контроллера Xiaomi ==
Перед тем как включить контроллер Xiaomi, необходимо его настроить. Для этого необходимо перейти в контроллер Xiaomi, нажать на троеточие и выбрать "Настройки"
[[Файл:Xiaomi 003 Настройки контроллера.png|центр|обрамить]]
Далее необходимо ввести логин и пароль от вашей учетной записи MiHome, а также выбрать регион MiHome если это необходимо.
{{QuoteYellow|Нежелательно использовать в качестве логина - номер телефона. При использовании номера телефона, иногда возникают ошибки авторизации. Лучше использовать ID или e-mail}}
[[Файл:Xiaomi 004 Настройки контроллера.png|центр|обрамить]]
{{QuoteBlue|Если выбрать "Все страны" - то добавятся все устройства из всех регионов MiHome вашей учетной записи. Или вы можете выбрать конкретный регион, в котором у вас подключено устройство}}

Если включить "Облачные устройства", то Sprut.hub получит возможность управлять не только локально, но и удаленно через облако Xiaomi, но при этом управление будет осуществляться с задержкой (Особенности облачного управления).

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

Причем вы можете выбрать в настройках каждого подключенного устройства (после его добавления в хаб) - предпочтительный способ связи
[[Файл:Xiaomi 006 Способ связи.png|центр|обрамить]]

Но для начала давайте сохраним изменения в самом контроллере и включим его.

== Двухфакторная авторизация учетной записи Xiaomi ==
Если у вас стоит двухфакторная авторизация, то при включении контроллера Xiaomi, в [[Служебный раздел отладки|разделе отладки]] у вас появится ссылка для прохождения двухфактора, которую нужно скопировать, вставить в адресную строку браузера и выполнить предлагаемые инструкции.
[[Файл:Xiaomi 007 2FA.png|центр|обрамить]]

Если ссылка не сработала, то можно зайти [https://account.xiaomi.com/fe/service/account/privacy по этой ссылке] и при нажатии на номер телефона - система Xiaomi вам отправит код на почту, после введения которого скорее всего контроллер сможет работать и видеть устройства
== Добавление устройств ==
Чтобы добавить в Sprut.hub устройства Xiaomi - нужно [[Создание контроллера Xiaomi#Создание контроллера Xiaomi|настроить контроллер Xiaomi]] как описано выше в этой статье.

После включения контроллера, Sprut.hub автоматически найдет все устройства, доступные для этой учетной записи MIHome.
{{QuoteYellow|То, что устройства появились в контроллере - еще не значит, что они подключены к хабу. Статус "Not Paired" как раз означает, что они не подключены. Для того, чтобы они появились на вкладке "Устройства" - их надо к нему подключить.}}{{QuoteBlue|Если у устройства обозначено "Нет шаблона" - это означает, что хаб пока не поддерживает устройство. То есть он его видит, но работать с ним не может, пока не появится шаблон. Что делать в этом случае - описано в [[Моё устройство не поддерживается. Нет шаблона. Что делать|этой статье]]}}

Для добавления поддерживаемого устройства, необходимо нажать на троеточие в правой части карточки устройства и выбрать "Добавить устройство"
[[Файл:Xiaomi 005 Добавить устройство.png|центр|обрамить]]
После добавления устройства в контроллере Xiaomi, если для него есть шаблон - он автоматически добавится в Sprut.hub и будет доступен для управления в разделе Устройства.
{{QuoteRed|Необходимо учитывать, что у WiFi устройств Xiaomi есть ограничение на одновременное управление из нескольких мест. Поэтому если вы управляете ими через несколько систем умного дома, вероятно в один прекрасный момент у вас начнут появляться ошибки и устройство будет работать нестабильно}}

== Yeelight LAN Control (Управление через LAN) ==

В связи с тем, что у ламп и люстр Yeelight есть возможность включения локального управления - многие его так или иначе включали для интеграции в различные системы умного дома. Но так как процессорных мощностей у устройств и так немного - это нагружает их и так не очень мощные "мозги".

Для работы со Sprut.hub - LAN Control мало того, что не нужен, но и вреден, так как приводит к нестабильной работе устройств.

Поэтому LAN Control при работе с контроллером Xiaomi должен быть выключен в обязательном порядке.

{{QuoteYellow|После отключения LAN Control в настройках лампы или люстры - ее необходимо перезагрузить по питанию, чтобы изменения вступили в силу}}

== Проблемы с устройствами Xiaomi в Sprut.hub: причины и решения ==
'''1. Устройство нормально работало локально, но перестало:'''

'''1.1. Завис компонент локального управления в самом устройстве.'''

'''Симптомы''': Не реагирует на управление из Sprut.hub (или управляется, но не отдает свой статус и в интерфейсе отображается с пометкой Не в сети), но видно в родном приложении.

'''Решение''': Полная перезагрузка устройства (выключение/включение питания). Со стороны Sprut.hub повлиять на эту проблему невозможно.

'''1.2. Устройство было перепривязано (переспарено) в приложении Xiaomi Home.'''

'''Причина''': В настройках контроллера Xiaomi в Sprut.hub отключена опция «Облачные устройства». Из-за этого Sprut.hub не может автоматически получить новые ключи доступа (токены) с серверов Xiaomi, а со старыми устройство работать отказывается.

'''Решение''': Включить опцию «Облачные устройства» в настройках контроллера Xiaomi внутри Sprut.hub.

'''1.3. Изменилась сетевая конфигурация (поменялась IP-адресация).'''

'''Причина''': Устройство и Sprut.hub больше не находятся в одной подсети, что критично для локального режима.

'''Решение''': Вернуть устройство и хаб в одну подсеть или перевести устройство в режим «Только облако».

'''1.4. Сбой авторизации контроллера Xiaomi.'''

'''Причина''': Устройство было переспарено, или Xiaomi принудительно сменила токен, или Xiaomi сменили процедуру авторизации для сторонних систем. Сервер Xiaomi перестал отдавать актуальные данные в Sprut.hub без повторной процедуры авторизации.

'''Решение''': Переавторизовать контроллер Xiaomi в настройках Sprut.hub

'''2. Пользователь перевел устройство из режима «Только облако» в «Только локально», но оно не работает.'''

'''Причина''': Не все устройства поддерживают локальный режим. Например, большинство Bluetooth-устройств работают только через облако (через шлюз Xiaomi). Некоторые Wi-Fi-устройства также могут не иметь полноценной локальной поддержки.

'''Решение''': Вернуть для устройства режим «Только облако».

'''3. Устройство работавшее в режиме «Только облако», перестало работать.'''

'''Вероятная причина''': Серверы Xiaomi требуют обновления сессии (переавторизации контроллера).

'''Решения''':

3.1. Попробовать переключить режим на «Только локально». Это может сработать, если токены, ранее полученные из облака, всё еще актуальны на самом устройстве. Не поможет, если токены были изменены или устройство не поддерживает локальный режим.

3.2. Переавторизовать контроллер Xiaomi — это основной способ решения проблем облачной работы.

'''Рекомендация''': Режим «Локально и облако» использовать не рекомендуется. Его поведение часто непредсказуемо: он может не давать преимуществ локального режима, при этом имея все зависимости и задержки облачного. Лучше выбрать четкий режим основанный на возможностях устройства: «Только локально» для поддерживающих его устройств или «Только облако» для всех остальных, либо устройств находящихся не в одной подсети с Sprut.hub.

Этот режим не надо включать для устройств, которые не умеют работать локально. Если spruthub будет видеть устройство локально, то не переключится на облачный режим.

Если у устройства зависнет локальный компонент, то это режим скорее всего тоже не спасёт.

Создание контроллера Xiaomi

2025-09-09T22:09:34Z

Permadm: Добавление описания проблем и способов решения

Уведомления в Telegram (Телеграм)

2025-08-18T01:19:49Z

Permadm: Опечатки

Для получения уведомлений о событиях Sprut.hub через бота в Telegram можно использовать сервис уведомлений или решение с использованием кода (выбор за вами)

Если у вас нет своего бота, вам необходимо его создать.

Именно этот бот будет присылать вам сообщения, которые вы будете отправлять из Sprut.hub.

Если вы хотите, чтобы сообщения приходили в ваш канал, который будут читать несколько пользователей, то вам потребуется выяснить ID канала, куда будут присылаться сообщения от бота и указать его. Личные уведомления и группы с супергруппами могут добавляться в уведомления автоматически.

== Создание сервиса уведомлений Telegram ==
Необходимо перейти в раздел "Уведомления" в веб интерфейсе Sprut.hub и создать новый сервис уведомлений
[[Файл:010 Телеграм Создать сервис уведомлений.png|центр|обрамить]]
Далее выбрать Telegram
[[Файл:011 Телеграм Выбрать сервис уведомлений.png|центр|обрамить]]
Далее перейти в настройки нового сервиса
[[Файл:012 Телеграм Настройки.png|центр|обрамить]]
В настройках необходимо перейти в раздел управления вашим ботом (откроется диалог с официальным ботом Telegram @botfather)
[[Файл:013 Телеграм создать бота.png|центр|обрамить]]

== Создание своего бота в Telegram ==
Если вы не перешли из настроек сервиса уведомлений, то вы можете в Telegram в поиске вбить [https://t.me/BotFather @BotFather] (это официальный бот для создания ботов)
[[Файл:Tg0.jpg|центр|обрамить]]

После этого необходимо:

'''Шаг 1:''' Нажмите «Запустить» для активации бота BotFather.

Шаг 2: Открыть меню управления ботами (кнопка Open)

'''Шаг 2: Нажать "Create a New Bot"'''

'''Шаг 3:''' Дать имя своему боту — например "Бот для умного дома" и присвоить никнейм бота, по которому вы сможете его найти. Он должен быть уникальным и заканчиваться на слово «bot».

Шаг 4: Нажать кнопку "Create bot"

Шаг 5: Перейти в настройки вашего бота

Шаг 6: Отключить Privacy Mode в группах, чтобы бот мог видеть сообщения в группах

Шаг 7: Вернитесь в настройки, скопируйте и сохраните токен вашего бота для дальнейшего использования в хабе (Нажав синюю кнопку Copy)
[[Файл:000 Телеграм Botfather Создать бота full.png|центр|обрамить]]

== Окончательная настройка бота в сервис уведомлений Telegram ==
После создания бота, вам необходимо вернуться в веб интерфейса хаба и вставить скопированный на предыдущем этапе токен бота в соответствующее поле. После, нажмите кнопку "Авторизоваться"
[[Файл:014 Телеграм авторизовать бота.png|центр|обрамить]]

== Добавление чатов, групп и супергрупп в сервис уведомлений ==
После настройки вашего бота, вам необходимо добавить клиентов сервиса уведомлений, которые будут их получать. Для этого необходимо начать диалог с ботом, чтобы получать личные уведомления. Это делается с помощью отправки кода в диалоге с ботом.

Необходимо нажать на строку "Отправьте код...." и у вас откроется диалог с вашим ботом.
[[Файл:016 Телеграм отправить код боту.png|центр|обрамить]]
Чтобы начать пользоваться ботом, нужно начать с ним чат и нажать кнопку "Старт". После этого, необходимо отправить код, указанный в настройках сервиса уведомлений и у вас автоматически подключится новый клиент.

[[Файл:Telegram.png|центр|обрамить]]{{QuoteBlue |Код обновляется после каждого использования}}

== Отправка сообщений в телеграм группы и супергруппы ==
Для отправки сообщений в группы и супергруппы (в определенные топики), вам необходимо:

# Добавить бота в группу или супергруппу
# Открыть настройки сервиса уведомлений Telegram
# Отправить сообщение в кодом в группе или в нужном топике супергруппы
# Группа будет автоматически добавлена в список клиентов уведомлений
{{QuoteYellow|Для каждого топика супергруппы - необходимо отправлять свой код. При этом в вашем хабе создается отдельный клиент уведомлений для каждого топика супергруппы}}

== Отправка сообщений в каналы ==
{{QuoteYellow|Если вы хотите, чтобы бот отправлял сообщения в ваш канал и его сообщения могли читать несколько пользователей, то вы должны добавить бота в этот канал с правами администратора и возможностью отправлять сообщения}}Далее вам необходимо узнать '''chatID''' вашего канала. Для этого вам нужно подключиться к [https://t.me/getmyid_bot этому боту] и переслать ему любое сообщение из нужного канала, чтобы он вам сообщил ID вашего канала, из которого вы переслали сообщение.

После этого, вам необходимо вручную добавить нового клиента сервиса уведомлений.

Для этого необходимо создать нового клиента и вставить туда полученный ID канала
[[Файл:017 Телеграм создать клиента.png|центр|обрамить]]
[[Файл:018 Телеграм настроить клиента.png|центр|обрамить]]
После этого ваш канал появится в списке клиентов для уведомлений

== Использование уведомлений в телеграм из сценариев ==
В блочном сценарии, вам необходимо в блоке Тогда блочного сценария, добавить сервис уведомлений, выбрать там Телеграм и выбрать клиента, которому вы хотите отправить уведомления
[[Файл:019 Телеграм уведомления в блочном сценарии добавить сервис.png|центр|обрамить]]
[[Файл:020 Телеграм уведомления в блочном сценарии отправить.png|центр|обрамить]]
[[Файл:021 Телеграм уведомления в блочном сценарии выбор бота.png|центр|обрамить]]
[[Файл:022 Телеграм уведомления в блочном сценарии выбор клиента.png|центр|обрамить]]
[[Файл:023 Телеграм уведомления в блочном сценарии создание сообщения.png|центр|обрамить]]

== Форматирование сообщений ==
Для отправки сообщений в телеграм, вам доступно три варианта форматирования: Markdown, Markdown V2 и HTML

Переключение вариантов форматирования, доступно в экспертном разделе настроек вашего сервиса уведомлений
[[Файл:024 Телеграм экспертные настройки.png|центр|обрамить]]
И выбрать вариант форматирования
[[Файл:025 Телеграм выбор форматирования.png|центр|обрамить]]
Как правильно оформлять текст для каждого типа форматирования, можно посмотреть в официальной документации Телеграм:

* [https://core.telegram.org/bots/api#html-style Для форматирования HTML]
* [https://core.telegram.org/bots/api#markdown-style Для форматирования Markdown]
* [https://core.telegram.org/bots/api#markdownv2-style Для форматирования Markdown V2]

== Использование уведомлений в телеграм в блоках кода ==
В блоке кода, уведомлениями можно пользоваться по аналогии с другими сервисами уведомлений. В качестве бонуса, есть опция отправки сообщений без уведомлений (тихий режим)

Отправить текст всем клиентам<syntaxhighlight lang="js">
Notify.text("Тест отправки всем").to("Telegram_1").silent(false).send();
</syntaxhighlight>Отправить текст одному конкретному клиенту с идентификатором 1<syntaxhighlight lang="js">Notify.text("Тест отправки в Телеграм").to("Telegram_1", 1).silent(false).send();</syntaxhighlight>

Отправить текст нескольким клиентам<syntaxhighlight lang="js">Notify.text("Тест отправки на клиентов 1 и 2").to("Telegram_1", 1, 2).silent(false).send();</syntaxhighlight>

Отправить показания датчика<syntaxhighlight lang="js">
Notify.text("Показания датчика температуры: {}", Hub.getCharacteristicValue(13,15)).to("Telegram_1", 1, 2).silent(false).send();</syntaxhighlight>Отправить показания нескольких датчиков<syntaxhighlight lang="js">
Notify.text("Показания датчика температуры 1 : {}, Показания датчика температуры 2 : {}", Hub.getCharacteristicValue(13,15),Hub.getCharacteristicValue(16,19)).to("Telegram_1", 1, 2).silent(false).send();
</syntaxhighlight>Отправить показания нескольких датчиков в несколько строк (используется \n для перевода строки)<syntaxhighlight lang="js">
Notify.text("Показания датчика температуры 1 : {}\nПоказания датчика температуры 2 : {}", Hub.getCharacteristicValue(13,15),Hub.getCharacteristicValue(16,19)).to("Telegram_1", 1, 2).silent(false).send();
</syntaxhighlight>
Отправка снапшота с камеры в тихом режиме<syntaxhighlight lang="js">
let snapshot = Hub.getAccessory(2037).getSnapshot()
if (snapshot != null)
{
Notify.text("Теcт отправки снапшота").to("Telegram_1", 1, 2, 3).image(snapshot).silent(true).send();
}
</syntaxhighlight>

== Отправка уведомлений в Telegram полностью через сценарии в виде кода ==
Теперь вам необходимо настроить его работу в Sprut.hub. Для этого необходимо создать глобальный сценарий в виде кода. Идем в "Сценарии" - "Глобальные" и создаем там новый сценарий
[[Файл:Scenario1.png|центр|обрамить]]

После этого - вставляем в блок кода сценария следующий код:<syntaxhighlight lang="js" line="1">
let chatIDs = ["777777777", "888888888", "-123123123123"];
// 777777777 и 888888888 - ID чатов, в которые будут отправляться сообщения
// -123123123123 - ID канала, куда вы можете добавить бота, чтобы сообщения от него приходили группе людей

// let chatIDs = ["777777777"] // первая строка будет выглядеть так, если вам нужно отправлять только в один чат

let token = "666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP"

function sendToTelegram(text, notify) {
try {
if (!Array.isArray(text))
text = [text];

chatIDs.forEach(function (chatID) {
HttpClient.POST("https://api.telegram.org")
.path("bot" + token)
.path("sendMessage")
.queryString("chat_id", chatID)
.queryString("text", text.join("\n"))
.queryString("parse_mode", "Markdown")
.queryString("disable_notification", notify == null ? false : !notify)
.send()
})
} catch (e) {
log.error(e.message);
}
}
sendToTelegram(["*Мой город*", "Хаб запущен"])
</syntaxhighlight> [https://wiki.spruthub.ru/images/c/c9/Отправка_сообщений_в_Telegram.zip Скачать шаблон сценария]{{QuoteYellow | В коде необходимо заменить "777777777" и другие ID на те ID, которые вы получили от бота на Шаге 4 и заменить токен 666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP на токен, который вы получили на Шаге 3}}

После этого сохраняем сценарий

== Дополнительные настройки отправки сообщений ==
В этот же глобальный сценарий, после функции sendToTelegram, вы можете добавить дополнительную строку, которая будет уведомлять вас о запуске хаба вызывая функцию выше:
<syntaxhighlight lang="js">
sendToTelegram(["*Мой город*", "Хаб запущен"])
</syntaxhighlight>

Вызов функции отправки сообщений из блочных сценариев, производится через добавление в блоке кода блочного сценария (в раздел "Тогда" или "Иначе") следующей команды:
<syntaxhighlight lang="js">
global.sendToTelegram("Сообщение")
</syntaxhighlight>

Если вам нужен перевод на новую строку, то код будет выглядеть вот так
<syntaxhighlight lang="js">
global.sendToTelegram(["*Нижний Новгород*, хаб запущен", "вторая строка"])
</syntaxhighlight>

Если вы хотите, чтобы приходили "тихие" уведомления в телеграм, то строка кода будет выглядеть вот так:
<syntaxhighlight lang="js">
global.sendToTelegram(["*Нижний Новгород*, хаб запущен", "вторая строка"], false)
</syntaxhighlight>

Также можно оформлять текст с помощью разных "плюшек" в виде различного форматирования текста:
<syntaxhighlight lang="js">
global.sendToTelegram("*выделение жирным*")
</syntaxhighlight>
<syntaxhighlight lang="js">
global.sendToTelegram("__выделение подчеркнутым__")
</syntaxhighlight>
<syntaxhighlight lang="js">
global.sendToTelegram("_наклонный текст_")
</syntaxhighlight>
<syntaxhighlight lang="js">
global.sendToTelegram("Текст с емоджи 😄")
</syntaxhighlight>''** Эмоджи можно скопировать из любого приложения, которое их поддерживает и вставить в код сценария. Как текст.''<syntaxhighlight lang="js">
global.sendToTelegram("[Инструкции живут тут](https://spruthub.ru/news)") - это отправка ссылки
</syntaxhighlight>

Если вам нужно отправить в телеграм значение какого либо устройства, то можно использовать следующий синтаксис:

<syntaxhighlight lang="js">
global.sendToTelegram("Состояние сигнализации: " + Hub.getCharacteristic(2, 13).format())
</syntaxhighlight>где 2 - это [[Аксессуары, сервисы и характеристики#Идентификаторы аксессуара, сервиса и характеристики|идентификатор аксессуара]], а 13 это [[Аксессуары, сервисы и характеристики#Идентификаторы аксессуара, сервиса и характеристики|идентификатор характеристики]]

Для отправки в одном сообщении состояний нескольких устройств в одну строку<syntaxhighlight lang="js">
global.sendToTelegram("Показания датчика температуры 1 : " + Hub.getCharacteristicValue(13,15) + " Показания датчика температуры 2 : " + Hub.getCharacteristicValue(16,19))
</syntaxhighlight>Для отправки в одном сообщении состояний нескольких устройств в две строки, где добавляются квадратные скобки [], а перевод строки осуществляется с помощью запятой<syntaxhighlight lang="js">
global.sendToTelegram(["Показания датчика температуры 1 : " + Hub.getCharacteristicValue(13,15), "Показания датчика температуры 2 : " + Hub.getCharacteristicValue(16,19)])

</syntaxhighlight>

== Уведомления в Telegram из блочных сценариев ==
Глобальные сценарии используются в блочных через вызов функции.

Для этого переходим в раздел Блочных сценариев и создаем новый блочный сценарий или добавляем уже в существующий, отправку уведомлений в телеграм:
[[Файл:Scenario tg2.png|центр|обрамить]]
[[Файл:Scenario tg4.png|центр|обрамить]]

== Передача данных датчика в Telegram ==
Если вы хотите что-то посложнее, например отправить данные датчика или что-то подобное, то можно использовать данные характеристики устройства.

Например отправка состояния открытия окна будет выглядеть в виде такой команды:<syntaxhighlight lang="js">
global.sendToTelegram("Состояние окна: " + Hub.getCharacteristic(1154, 16).format())
</syntaxhighlight>где цифра 1154 - это [[Аксессуары, сервисы и характеристики#Идентификаторы аксессуара, сервиса и характеристики|ID аксессуара]] Окно в хабе, а цифра 16 - это номер характеристики "Целевая позиция" у Окна.

Чтобы не напрягаться с поиском того, как называется сервис или характеристика для использования в коде (даже с авто-подстановкой), а также какие у них идентификаторы, достаточно зайти в настройки устройства и нажать кнопку информации у нужной характеристики
[[Файл:Tg23.jpg|центр|обрамить]]
И там будут нужные вам названия сервисов и характеристик для указания в коде, а также идентификаторы всех уровней.
[[Файл:Tg24.jpg|центр|обрамить]]

== Отправка фото в Телеграм ==
Если вам необходимо отправлять фото в телеграм, то нужно дополнить глобальный сценарий еще одной функцией
<syntaxhighlight lang="js" line="1">
let chatIDs = ["777777777"];
let token = "666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP"

function sendToTelegram(text, notify) {
try {
if (!Array.isArray(text))
text = [text];

chatIDs.forEach(function (chatID) {
HttpClient.POST("https://api.telegram.org")
.path("bot" + token)
.path("sendMessage")
.queryString("chat_id", chatID)
.queryString("text", text.join("\n"))
.queryString("parse_mode", "Markdown")
.queryString("disable_notification", notify == null ? false : !notify)
.send()
})
} catch (e) {
log.error(e.message);
}
}

function sendPhotoToTelegram(binary,caption) {
try {
if (!caption) {caption = ""}
chatIDs.forEach(function (chatID) {
HttpClient.POST('https://api.telegram.org')
.path("bot" + token)
.path("sendPhoto")
.queryString("chat_id", chatID)
.queryString('caption', caption)
.fieldMultipart('photo', binary)
.send();
})
} catch (e) {
log.error(e.message);
}
}
sendToTelegram(["*Мой город*", "Хаб запущен"])
</syntaxhighlight>[https://wiki.spruthub.ru/images/e/e1/%D0%9E%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0_%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D0%B9_%D0%B8_%D1%84%D0%BE%D1%82%D0%BE_%D0%B2_Telegram.json Скачать шаблон сценария]{{QuoteYellow | В коде необходимо заменить "777777777" на ID которые вы получили от бота на Шаге 4 и заменить токен 666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP на токен, который вы получили на Шаге 3}}А отправка фото, осуществляется следующим блоком кода в блочном сценарии<syntaxhighlight lang="js" line="1">
let snapshot = HttpClient.GET("[АДРЕС_ИЗОБРАЖЕНИЯ]").send().getBinary();
if(snapshot != null) {
global.sendPhotoToTelegram(snapshot,"Изображение с камеры");
}
</syntaxhighlight>Где в данном примере, [АДРЕС_ИЗОБРАЖЕНИЯ] - это URL для картинки с вашей камеры видеонаблюдения, если она умеет отдавать статичные картинки.

Стандартная ссылка для подобных картинок: {{Color|blue|'''http://[ВАШ_ЛОГИН]:[ВАШ_ПАРОЛЬ]@[IP_АДРЕС_КАМЕРЫ]:[ПОРТ]/cgi-bin/snapshot.cgi'''}} но она может быть другой, или ваша камера может не уметь показывать статичные картинки.

Главное для использования этого варианта отправки картинок, чтобы она была доступна из хаба по обычной ссылке на сайт.

== Отправка фото в Телеграм с подключенной к Sprut.hub камеры ==
Осуществляется с использованием отправки фото в Телеграм через глобальную функцию описанную выше.

Вызов в блочном или логическом сценарии: <syntaxhighlight lang="js">
let snapshot = Hub.getAccessory(1291).getSnapshot()
if (snapshot != null) {
global.sendPhotoToTelegram(snapshot, "текст под картинкой", "")
}
</syntaxhighlight>где 1291 это идентификатор подключенной к Sprut.hub камеры

== Универсальный вариант для чатов, групп и каналов с отправкой в конкретный топик группы ==
Номер топика в супергруппе можно получить скопировав ссылку на любое сообщение в топике. Она будет выглядеть как:

https://t.me/c/123456789/2/17 - где:

* 123456789 - идентификатор группы (чтобы добавить в код, нужно в начало идентификатора добавить -100 чтобы получилось -100123456789)
* 2 - идентификатор топика
* 17 - идентификатор сообщения

Идентификатор чата с ботом вы получили на [[Уведомления в Telegram (Телеграм)#Создание своего бота в Telegram|шаге 4]]

Идентификатор канала, в который бот должен отправлять сообщения вы так же получили на [[Уведомления в Telegram (Телеграм)#Создание своего бота в Telegram|шаге 4]]

В итоге мы получаем три места, куда бот будет отправлять сообщения: чат с ботом, канал и конкретный топик в супергруппе. Где:

* -100123456789 - это ID супергруппы
* -100987654321 - это ID канала
* 50506060 - это ID чата с ботом
{{QuoteRed|Если у вас несколько каналов и чатов, необходимо в переменной chatIDs указывать сначала каналы и группы (со значком "-" в начале), а потом уже ID чатов}}
Глобальный сценарий будет выглядеть таким образом:<syntaxhighlight lang="js" line="1">
let chatIDs = ["-100123456789","-100987654321","50506060"];
let token = "666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP"

function sendToTelegram(text,topic,notify) {
try {
if (!Array.isArray(text))
text = [text];

chatIDs.forEach(function (chatID) {
if (chatID.indexOf("-")) {topic = ""}
HttpClient.POST("https://api.telegram.org")
.path("bot" + token)
.path("sendMessage")
.queryString("chat_id", chatID)
.queryString("message_thread_id", topic)
.queryString("text", text.join("\n"))
.queryString("parse_mode", "Markdown")
.queryString("disable_notification", notify == null ? false : !notify)
.send()
})
} catch (e) {
log.error(e.message);
}
}
</syntaxhighlight>Отправка сообщений

Если нужно отправить сообщение в чат с ботом, канал и топик General супегруппы <syntaxhighlight lang="js">
global.sendToTelegram("Сообщение в канал, чат и топик General")
</syntaxhighlight>Если нужно отправить сообщение в чат с ботом, канал и топик с индексом 2 супергруппы, где цифра 2 после запятой - ID топика в супергруппе <syntaxhighlight lang="js">
global.sendToTelegram("Сообщение в канал, чат и топик номер 2",2)
</syntaxhighlight>__ОБЯЗАТЕЛЬНОЕ_ОГЛАВЛЕНИЕ__