Все ноды/Integrations/Telegram

Управление чатом Telegram

Управление чатом: название, описание, режим «только чтение» для всех (mute_everyone/unmute_everyone через setChatPermissions), создание и отзыв инвайт-ссылок, одобрение/отклонение заявок на вступление, индикатор «печатает…». Бот должен быть администратором. Есть dry_run. Требует Telegram Config.

Управление чатом Telegram▶

Telegram ConfigSuccess

Error

Тип в графе: telegram_chat_manage

Exec

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

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

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

Вход

Управление чатом Telegram▶

Выход▶

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

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

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

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

Эта нода меняет сам чат: название, описание, режим «только чтение», инвайт-ссылки, заявки на вступление и статус вроде «печатает…». Действия над людьми — бан, мьют, удаление, закрепление — живут в соседней ноде Модерация. Разделение намеренное: по графу сразу видно, может ли ветка задеть участника.

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

Бот должен быть администратором чата — почти каждое действие иначе отвергается. Действие, включающее режим «только чтение», меняет права по умолчанию сразу для всех неадминов — это переключатель «чат работает как объявления», а не ограничение одного участника.

Статус вроде «печатает…» — подсказка, а не состояние: Telegram гасит его через несколько секунд или как только бот отправит сообщение. В ходе, начатом в теме форума, статус показывается в этой же теме.

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

Пробный прогон ничего не проверяет. Он возвращает план, не обращаясь к Telegram вообще, — то есть зелёный пробный прогон не доказывает, что у бота есть права.
Заявку на вступление можно одобрить, только пока она висит. И узнать о ней воркфлоу сможет лишь тогда, когда в панели публикации отмечен тип обновлений «Заявки на вступление».
Отзыв ссылки требует саму ссылку. Сохраните invite_link с выхода предыдущего «Создать инвайт-ссылку» — по названию ссылки Telegram её не найдёт.
Отказ останавливает ноду, а не возвращается полем success: false. Бот, потерявший админку, обязан ронять ветку, а не оставлять ран зелёным. Нужна мягкая обработка — включите «Выход ошибки».
Chat ID только числовой, @имя_канала не принимается. Пустое поле означает чат текущего Telegram-хода, поэтому запуск из веб-чата, API или по расписанию с пустым полем остановится.
«Лимит участников» = 0 означает «без ограничения», а «Название ссылки» видят только администраторы — участнику оно не показывается.
Снятие режима «только чтение» — это фиксированный набор прав, а не «как было». Он возвращает возможность писать и приглашать, но намеренно не возвращает права менять информацию о чате, закреплять сообщения и управлять темами: иначе снятие мьюта повышало бы обычного участника. Если такие права были у чата раньше, верните их в 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`	`send_chat_action`	Управление чатом (требует прав администратора). mute_everyone/unmute_everyone меняют permissions по умолчанию для всех не-админов; send_chat_action показывает статус «печатает…». Варианты: `set_title` — Переименовать чат, `set_description` — Задать описание чата, `mute_everyone` — Режим «только чтение» для всех, `unmute_everyone` — Снять режим «только чтение», `create_invite_link` — Создать инвайт-ссылку, `revoke_invite_link` — Отозвать инвайт-ссылку, `approve_join_request` — Одобрить заявку на вступление, `decline_join_request` — Отклонить заявку на вступление, `send_chat_action` — Показать статус вроде «печатает…»
Действие в чате`chat_action`	`string`	`typing`	Какой статус показывать. Telegram снимает его через несколько секунд или как только бот отправит сообщение, — это подсказка, а не состояние. Варианты: `typing` — печатает…, `upload_photo` — отправляет фото, `record_video` — записывает видео, `upload_video` — отправляет видео, `record_voice` — записывает голосовое сообщение, `upload_voice` — отправляет голосовое сообщение, `upload_document` — отправляет файл, `choose_sticker` — выбирает стикер, `find_location` — определяет местоположение, `record_video_note` — записывает видеосообщение, `upload_video_note` — отправляет видеосообщение показывается при action = send_chat_action
Chat ID`chat_id`	`string`	`""`	Telegram chat_id. Пусто — чат текущего запуска (для Telegram-триггера). Шаблоны поддерживаются. поддерживает шаблоны
Описание`description`	`string`	`""`	Новое описание чата. поддерживает шаблоны показывается при action = set_description
Пробный прогон`dry_run`	`boolean`	`false`	Не вызывать Telegram, только вернуть план.
Инвайт-ссылка`invite_link`	`string`	`""`	Ссылка, которую нужно отозвать. поддерживает шаблоны показывается при action = revoke_invite_link
Название ссылки`link_name`	`string`	`""`	Подпись ссылки (видна только админам). поддерживает шаблоны показывается при action = create_invite_link
Название`title`	`string`	`""`	Новое название чата. поддерживает шаблоны показывается при action = set_title
User ID`user_id`	`string`	`""`	Telegram user_id (число). Шаблоны поддерживаются. поддерживает шаблоны показывается при action = approve_join_request \| decline_join_request
Дополнительно
Лимит участников`member_limit`	`integer`	`0`	Сколько человек может вступить по ссылке. 0 — без ограничения. показывается при action = create_invite_link

Общие поля

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

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