Уведомления в Telegram (Телеграм): различия между версиями

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


После этого вы получите сообщение, которое будет содержать ссылку на вашего бота, а также токен для авторизации в Sprut.hub или другой системе управления умным домом.
После этого вы получите сообщение, которое будет содержать ссылку на вашего бота, а также '''токен''' для авторизации в Sprut.hub или другой системе управления умным домом.


Шаг 4: Далее вам необходимо узнать ваш ID. Для этого вам нужно подключиться к [https://t.me/getidsbot этому боту], который и сообщит вам ваш ID.
Шаг 4: Далее вам необходимо узнать ваш '''chatID'''. Для этого вам нужно подключиться к [https://t.me/getidsbot этому боту], который и сообщит вам ваш '''chatID'''.


{{Quote | Ваш бот готов к использованию}}
{{Quote | Ваш бот готов к использованию}}


Теперь вам необходимо настроить его работу в Sprut.hub. Для этого необходимо создать глобальный сценарий в виде кода. Идем в "Настройки" - "Сценарии" - "Глобальные" и создаем там новый сценарий<syntaxhighlight lang="js" line="1">
Теперь вам необходимо настроить его работу в Sprut.hub. Для этого необходимо создать глобальный сценарий в виде кода. Идем в "Сценарии" - "Глобальные" и создаем там новый сценарий
[[Файл:Scenario1.png|центр|обрамить]]
 
После этого - вставляем в блок кода сценария следующий код:<syntaxhighlight lang="js" line="1">
let chatIDs = ["666666666"];
let chatIDs = ["666666666"];
let token = "666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP"
let token = "666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP"
Строка 44: Строка 47:
     }
     }
}
}
</syntaxhighlight><syntaxhighlight lang="js" line="1">
</syntaxhighlight>
sendToTelegram(["*Первая строка", "вторая строка"])
{{Quote | В коде необходимо заменить "777777777" на ID которые вы получили от бота на Шаге 4 и заменить токен 666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP на токен, который вы получили на Шаге 3}}
 
В этот же глобальный сценарий, после функции sendToTelegram, вы можете добавить дополнительную строку, которая будет уведомлять вас о запуске хаба вызывая функцию выше:
<syntaxhighlight lang="js" line="1">
sendToTelegram(["*Первая строка*", "вторая строка"])
</syntaxhighlight>
</syntaxhighlight>

Версия от 19:12, 14 ноября 2022

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

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

Для этого необходимо в Telegram в поиске вбить @BotFather (это официальный бот для создания ботов)


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

Шаг1. Нажмите «Запустить» для активации бота BotFather. В ответ вы получите список команд по управлению ботов.

Шаг 2. Выполнить команду /newbot

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

После этого вы получите сообщение, которое будет содержать ссылку на вашего бота, а также токен для авторизации в Sprut.hub или другой системе управления умным домом.

Шаг 4: Далее вам необходимо узнать ваш chatID. Для этого вам нужно подключиться к этому боту, который и сообщит вам ваш chatID.


Ваш бот готов к использованию


Теперь вам необходимо настроить его работу в Sprut.hub. Для этого необходимо создать глобальный сценарий в виде кода. Идем в "Сценарии" - "Глобальные" и создаем там новый сценарий

После этого - вставляем в блок кода сценария следующий код:

let chatIDs = ["666666666"];
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);
    }
}


В коде необходимо заменить "777777777" на ID которые вы получили от бота на Шаге 4 и заменить токен 666666666:AABBCCddEeffggeeHH-IIJJkKLlMmnno_oP на токен, который вы получили на Шаге 3


В этот же глобальный сценарий, после функции sendToTelegram, вы можете добавить дополнительную строку, которая будет уведомлять вас о запуске хаба вызывая функцию выше:

sendToTelegram(["*Первая строка*", "вторая строка"])