Просмотр кода страницы Отправка уведомлений в Telegram полностью через сценарии в виде кода

== Отправка уведомлений в 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>''<small>** Эмоджи можно скопировать из любого приложения, которое их поддерживает и вставить в код сценария. Как текст.</small>''<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(13, 15).format())
</syntaxhighlight>где цифра 13 - это [[Аксессуары, сервисы и характеристики#Идентификаторы аксессуара, сервиса и характеристики|ID аксессуара]] Датчик температуры, а цифра 15 - это номер характеристики "Температура" у датчика.

Чтобы найти идентификаторы аксессуара и характеристики, достаточно зайти в настройки устройства
[[Файл:026 Телеграм отправка данных устройств настройки.png|центр|обрамить]]
И найти идентификаторы аксессуара и характеристики
[[Файл:029 Телеграм отправка данных устройств идентификаторы full.png|центр|обрамить|[[Отправка уведомлений в Telegram полностью через сценарии в виде кода]]]]

== Отправка фото в Телеграм ==
Если вам необходимо отправлять фото в телеграм, то нужно дополнить глобальный сценарий еще одной функцией
<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>
__ОБЯЗАТЕЛЬНОЕ_ОГЛАВЛЕНИЕ__