Работа с группами и каналами в Telegram
Действие позволяет управлять группами и каналами Telegram прямо из сценария: отправлять и удалять сообщения, модерировать участников, выдавать роли, генерировать пригласительные ссылки и получать статистику.
Бот должен быть добавлен в канал или группу с правами администратора — без этого ни одна операция не сработает.
Доступные операции
Сообщения
| Операция | Что делает |
|---|---|
| Отправка сообщения в канал/группу | Публикация сообщения от имени бота-администратора. |
| Оплата звездами | Платный пост: фото/видео скрыты до оплаты Telegram Stars. Каждый подписчик оплачивает доступ отдельно. |
| Удаление сообщения | Удаление ранее опубликованного сообщения по его ID. |
Подписка и статистика
| Операция | Что делает |
|---|---|
| Проверка подписки | Проверяет, состоит ли подписчик в канале/группе. Полезно для геймификации и условий акций. |
| Получить список администраторов | Список администраторов канала или группы. |
| Получить число участников | Количество подписчиков канала или участников группы. |
Модерация
| Операция | Что делает |
|---|---|
| Бан на канале/в группе | Блокировка участника. |
| Снятие бана | Разблокировка участника. |
| Установка ограничений пользователю | Запрет отправки сообщений, медиа и других действий. |
| Установка прав пользователю | Назначение прав администратора отдельным участникам. |
| Установка имени администратора в супергруппе | Изменение публичного имени администратора (custom title). |
Приглашения и вступления
| Операция | Что делает |
|---|---|
| Генерация пригласительной ссылки | Создание ссылки-приглашения. |
| Генерация пригласительной ссылки с параметрами | Ссылка с лимитом переходов, сроком жизни или модерацией заявок. |
| Одобрить вступление | Подтверждение заявки на вступление в группу с модерацией. |
| Отклонить вступление | Отказ в заявке на вступление. |
Оплата звездами (платный пост)
Операция «Оплата звездами» публикует в канал/группу платный пост: прикреплённые фото и видео остаются скрытыми, пока подписчик не оплатит доступ звёздами Telegram (Stars). Раскрытие персональное — каждый подписчик оплачивает свой доступ отдельно.
| Поле | Значение |
|---|---|
| ID или username канала/группы | Куда публикуется пост |
| Цена в звёздах | Целое число 1–10000 ⭐ — одна цена за весь пост |
| Подпись | Необязательный текст к посту (виден всем до оплаты) |
| Медиа | От 1 до 10 элементов. Для каждого — File ID и тип (фото или видео) |
| Кнопки | Только URL-кнопки |
За звёзды можно открывать только фото и видео. Документы, аудио, голосовые и GIF/анимации Telegram за звёзды не отправляет.
File ID должен принадлежать этому же боту. Получить его можно заранее — например, отдельным шагом сценария, загрузив медиа боту и сохранив file_id в переменную.
Доход в звёздах зачисляется на баланс самого бота (пост отправляется методом Bot API от имени бота). Вывод настраивается в @BotFather → Bot Settings → Payments, действует период удержания ~21 день. Отдельно «включать» платные посты на канале не нужно — достаточно прав бота на публикацию.
Настройка и результат
Выберите нужную операцию и заполните поля — используйте подсказки, которые появятся в форме под каждым полем.
Результат операции помещается в заданную переменную:
1— успех,0— неудача.
Текст ошибки (если есть) попадает в системную переменную _error.
Для входящих сообщений из групп/каналов Telegram автоматически заполняется большая группа системных переменных _tggroup_* — ID группы, текст, ответы, вложения, топики, состав участников. Полный список — в справочнике Системные переменные.