Telegram Bot
Узлы Telegram Bot отправляют и принимают сообщения, работают с медиа, управляют чатами и реагируют на обновления через бота, которого вы создаёте в Telegram.
Создание бота
Ботов создаёт @BotFather.
Откройте BotFather
Найдите @BotFather или откройте t.me/BotFather.
Команда /newbot
Отправьте /newbot и следуйте подсказкам: отображаемое имя и username (должен заканчиваться на bot).
Не светите токен
Токен — пароль бота. Не публикуйте его в открытом доступе.
Подключение к Nodul
Откройте авторизацию
В любом модуле Telegram Bot нажмите Create an authorization или Choose.
Имя и токен
Задайте имя подключения и вставьте токен из BotFather.
Как получить Chat ID
Большинству модулей нужен Chat ID (личный чат, группа или канал).
Способ 1: вывод триггера (удобнее всего)
Добавьте New Updates (Instant) и включите его
Переведите триггер в Active.
Напишите боту и посмотрите вывод
Отправьте боту любое сообщение. В выводе триггера найдите message.chat.id.
Передайте значение дальше
Используйте этот id в следующих узлах.
Способ 2: приватный канал через веб Telegram
Откройте web.telegram.org
Перейдите в приватный канал.
Посмотрите URL
- Вариант A:
https://web.telegram.org/#/im?p=c1424271061_11793697872942794544— возьмите число послеc, добавьте префикс-100→-1001424271061. - Вариант B: URL уже вида
https://web.telegram.org/a/#-1001833483575— это и есть Chat ID.
Для каналов и супергрупп важен префикс -100; без него отправка может не сработать.
Добавление бота в канал или группу
Добавьте бота
Administrators (каналы) или Members (группы) → добавьте своего бота.
Чтобы писать в каналах, бот должен быть администратором канала.
Триггеры
New Updates (Instant)
Основной триггер: срабатывает на любое обновление бота (сообщения, callback, inline-запросы, системные события).
Выберите Connection того бота, который должен получать обновления.
Один активный триггер на бота
У Telegram может быть только один активный webhook на бота. Разделяйте сценарии отдельными ботами и подключениями.
- Если Run once отменён, боевой триггер восстанавливается примерно за 20 секунд.
- Если Run once остаётся активным или страница обновлена, восстановление занимает около 2 минут.
| Поле | Описание |
|---|---|
| Connection | Выберите Connection бота в выпадающем списке. |
| Allowed Updates | Необязательный фильтр (messages, callbacks, …). Пусто = все |
| Enable Raw Data Updates | Отдать накопившиеся обновления, пока триггер был выключен |
| Enable System Messages | Вход/выход, закрепы и т. п. |
| Include Message Thread | Информация о теме в форум-группах |
Reply Markup
Необязательный Reply Markup в узлах отправки: inline keyboard или reply keyboard.
Inline keyboard (ссылки и callback):
{
"inline_keyboard": [
[
{ "text": "Открыть ссылку", "url": "https://example.com" },
{ "text": "Подтвердить", "callback_data": "confirm" }
],
[{ "text": "Отмена", "callback_data": "cancel" }]
]
}Reply keyboard (текст кнопки уходит как сообщение):
{
"keyboard": [["Да", "Нет"], ["Может быть"]],
"resize_keyboard": true,
"one_time_keyboard": true
}Клавиатуры в каналах не работают (только лички и группы).
Действия
Большинству действий нужен Chat ID: числовой id, @username или id канала. Введите вручную, подставьте через Map из триггера или другого узла, либо Select, если интерфейс показывает список. См. Как получить Chat ID.
Connection везде — выбор сохранённого подключения бота.
Устранение неполадок
Лимиты частоты
| Лимит | Значение |
|---|---|
| Один чат | Примерно 1 сообщение в секунду |
| Все чаты | Примерно 30 сообщений в секунду |
| Одна группа | Примерно 20 сообщений в минуту |
Добавьте задержки или пакетируйте отправки, если получаете 429 Too Many Requests.
Бот не отвечает
Проверьте токен (без пробелов). Если BotFather выдал новый токен — обновите подключение в Nodul.
Бот не состоит в канале
Добавьте бота администратором канала. См. Добавление бота в канал или группу.
Чат не найден
Неверный Chat ID, нет префикса -100 для каналов/супергрупп или бота удалили. При апгрейде группы в супергруппу Chat ID меняется — обновите сохранённый id.