Все ноды/Integrations/Telegram

Информация о чате Telegram

Информация о чате и участниках. action: chat (метаданные), member_count (точное число участников), administrators (точный список админов), member (статус конкретного пользователя), known_members (ПРИБЛИЗИТЕЛЬНЫЙ ростер из записанных наблюдений — Bot API не умеет перечислять всех участников, поэтому молчуны в него не попадут), bot_rights (права самого бота: можно ли удалять сообщения и банить). Требует Telegram Config.

Информация о чате Telegram▶

Telegram ConfigSuccess

Error

Тип в графе: telegram_chat_info

Exec

Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.

Как попробовать

Минимальный рабочий воркфлоу

Вход

Информация о чате Telegram▶

Выход▶

Исполнение
Исполнение + данные

Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Запускается сразу

Как применять

Эта нода отвечает на вопросы «что это за чат», «кто здесь админ», «какой статус у этого участника» и «что здесь может сам бот». Последнее — самый частый сценарий: проверить права перед тем, как ветка пойдёт в Модерацию или Управление чатом, и не превращать отказ Telegram в упавший ран.

Как это работает

Одна нода, одно поле «Действие» — потому что у Bot API поверхность по участникам маленькая и разрозненная. Точные ответы дают getChat, число участников, список администраторов и статус конкретного пользователя. Перечислить всех участников Bot API не умеет вовсе, поэтому «Ростер из наблюдений» собирается из собственной записи платформы и по определению неполон.

«Что может здесь сам бот» дополнительно возвращает can_read_all_group_messages — это и есть признак privacy mode. Если он false, запись истории группы останется пустой, сколько её ни включай.

Частые ошибки

Ростер читается как полный список. Участник, который никогда не писал и вступил до прихода бота, в нём отсутствует. Для точной цифры берите «Точное число участников».
Заполнено только поле выбранного действия, остальные остаются пустыми: chat, member_count, administrators, member, known_members, bot_rights.
Отказ Telegram останавливает ноду. И это правильно: самый частый отказ — «бот не состоит в чате», то есть ровно тот факт, о котором спрашивали. Нужна мягкая обработка — включите «Выход ошибки» и нарисуйте ветку.
Chat ID только числовой, @имя_канала не принимается. Пустое поле означает чат текущего Telegram-хода; запуск из веб-чата или по расписанию с пустым полем остановится.
Статус чужого пользователя надёжен, только когда бот администратор. Обычному участнику Telegram отдаёт заметно меньше.
«Ростер из наблюдений» — единственное действие без обращения к Telegram. Оно работает и без бота, зато требует включённой записи истории группы.

Входы

Порт	Провод	Данные	Примечания
Telegram Config`telegram_config`	Данные`data`	—	показывается, когда connection_source ≠ "auto"

Выходы

Порт	Провод	Данные	Примечания
Success`output`	Исполнение + данные`execute_data`	`object`
Error`on_error`	Исполнение + данные`execute_data`	—	показывается, когда expose_error_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Источник подключения`connection_source`	`string`	`auto`	Откуда нода берёт подключение. «Из контекста запуска» — использовать то, что платформа уже знает (Telegram-бот, на который задеплоен воркфлоу / собственное файловое хранилище этого воркспейса), проводов не требуется. «Внешнее подключение» — показать ресурсный порт, чтобы в него можно было подключить конфиг-ноду. Варианты: `auto` — Из контекста запуска, `external` — Внешнее подключение (подключить конфиг-ноду)
Действие`action`	`string`	`chat`	chat — метаданные чата (getChat); member_count — точное число участников; administrators — список админов; member — статус одного пользователя; known_members — ростер из записанных наблюдений (приблизительный: Bot API не умеет перечислять всех участников); bot_rights — права самого бота в чате. Варианты: `chat` — Метаданные чата (getChat), `member_count` — Точное число участников, `administrators` — Список администраторов, `member` — Статус одного участника, `known_members` — Ростер из наблюдений (приблизительный), `bot_rights` — Что может здесь сам бот
Chat ID`chat_id`	`string`	`""`	Telegram chat_id. Пусто — чат текущего запуска (для Telegram-триггера). Шаблоны поддерживаются. поддерживает шаблоны
Лимит`limit`	`integer`	`200`	Максимум записей ростера. показывается при action = known_members
User ID`user_id`	`string`	`""`	Telegram user_id (число). Шаблоны поддерживаются. поддерживает шаблоны показывается при action = member

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.