Работа с группами и каналами в MAX
Действие позволяет управлять группами и каналами в MAX прямо из сценария бота: отправлять, править и удалять сообщения, закреплять их, читать данные чата, проверять подписку, добавлять и удалять участников, а также работать с комментариями под постами канала.
Бот должен быть добавлен в канал или группу с правами администратора — без этого ни одна операция не сработает.
Доступные операции
| Операция | Что делает |
|---|---|
| Отправка сообщения в канал/группу | Публикация сообщения от имени бота-администратора. |
| Проверка подписки | Проверяет, состоит ли подписчик в канале/группе. Полезно для геймификации, доступа к контенту, проверки условий акций. |
| Добавление в канал/группу | Добавление подписчика в канал или группу. |
| Удаление из канала/группы | Исключение участника. |
| Удаление сообщения | Удаление ранее опубликованного сообщения по его ID. |
| Комментарии к посту | Читает обсуждение под постом канала: сколько комментариев и что написали последним. |
| Отправка комментария к посту | Бот отвечает в обсуждении под постом. |
| Удаление комментария | Убирает один комментарий по его ID. |
Работа с опубликованным сообщением
Отправка кладёт номер сообщения в переменную _group_message_id — по нему
сообщение потом правят, закрепляют и удаляют. Сохраните его в свою переменную,
если собираетесь вернуться к сообщению позже.
| Операция | Поля | Что делает |
|---|---|---|
| Изменение сообщения | ID сообщения, новый текст | Правит опубликованное сообщение |
| Закрепление | ID чата, ID сообщения, «Уведомить участников» | Закрепляет сообщение |
| Открепление | ID чата | Снимает закрепление |
Данные чата и администраторы
| Операция | Что даёт |
|---|---|
| Данные канала/группы | _chat_title, _chat_description, _chat_link, _chat_membercount, _chat_pinned; весь ответ — в указанную переменную |
| Получить список администраторов | Список ID администраторов в указанную переменную |
В MAX чат адресуется числовым ID — его даёт системная переменная
_maxgroup_id у входящего события из группы. Сохраните её в список
или глобальную переменную, если публикуете в чат из других сценариев.
Комментарии к постам канала
Под постом канала MAX идёт обсуждение, и бот умеет в нём работать: прочитать,
ответить, удалить лишнее. Комментарии адресуются номером поста, а не ID
чата — тем самым _group_message_id, который вернула отправка.
| Операция | Поля | Что делает |
|---|---|---|
| Комментарии к посту | ID поста, имя переменной | Кладёт число комментариев в _comments_count, последний — в _comment_id, _comment_text, _comment_user_id, _comment_user_name; весь список целиком — в указанную переменную |
| Отправка комментария к посту | ID поста, текст | Бот пишет комментарий под постом |
| Удаление комментария | ID поста, ID комментария | Убирает комментарий — например, из #{_comment_id} |
Типовой сценарий: по расписанию читаем комментарии под последним постом, и если под ним появился вопрос — бот отвечает в обсуждении, а менеджеру уходит уведомление. Спам с ссылками удаляется той же веткой.
Упоминания и гиперссылки в комментариях не работают — это ограничение мессенджера, а не конструктора. Вложений комментарий тоже не несёт, только текст.
Для чтения и удаления боту нужны права администратора канала: чтение всех сообщений и удаление.
Отправка сообщения в канал/группу
Публикация от имени бота-администратора. Кроме текста и кнопок сообщение может нести вложения — те же, что и обычное сообщение бота.
| Поле | Значение |
|---|---|
| ID или username канала/группы | Куда публиковать |
| Сообщение | Текст с шаблонами замен и переменными |
| Кнопки | Кнопки под публикацией |
| Медиа | Кнопка «Загрузить медиафайл»: фото, документы, аудио, архивы — до 10 МБ каждый. Несколько файлов уходят одной публикацией |
| File ID | Идентификатор файла этого бота: фото, документ, видео, аудио |
Загрузите файл боту один раз, сохраните #{_fileId} и укажите его в поле File ID: МАКС не будет перезаливать файл при каждой публикации.
Публикация может состоять из одного медиа — сообщение уйдёт и с пустым текстом.
Настройка
Выберите нужную операцию и заполните поля — используйте подсказки, которые появятся в форме под каждым полем.
Для входящих сообщений из групп/каналов MAX автоматически заполняется группа системных переменных _maxgroup_* — ID группы, текст, ответы, вложения, состав участников. Полный список — в справочнике Системные переменные.