Перейти к основному содержимому

Действие «Группы и каналы МАКС»

«Работа с группами и каналами в МАКС» — действие в сценарии действий, которое управляет каналом или группой в мессенджере МАКС. Аналог Telegram-канала, но с другим набором операций под специфику МАКС.

Для работы бот должен быть подключён к каналу/группе как сервисный аккаунт с правами на публикацию и модерацию.

Когда использовать МАКС вместо Telegram​

  • Российская инфраструктура — клиенты и команда в МАКС.
  • 152-ФЗ — хранение каналов и подписчиков в РФ.
  • Молодая аудитория РФ — МАКС набирает популярность как импортозамещение Telegram.
  • Параллельная стратегия — публиковать в оба мессенджера одновременно для шире охвата.

Часть 1. Подключение​

Шаг 1. Подключите бот к МАКС​

В Квесче: Боты → Добавить бот → MAX. Получите токен от MAX и привяжите.

Шаг 2. Добавьте бота в канал/группу​

В МАКС: Управление каналом → Администраторы → Добавить бота. Выдайте права публикации, удаления, модерации.

Шаг 3. Узнайте ID​

ID канала/группы — формат специфичен для МАКС. Получите через интерфейс администратора или сервисную команду бота.

Часть 2. Пять операций​

В сценарии действий → «Добавить действие» → «Работа с группами и каналами в МАКС».

ОперацияНазначение
Отправка сообщенияПубликация в канал/группу
Проверка подписки1 — подписан, 0 — нет
Удаление из канала/группыУдалить участника
Добавление в канал/группуДобавить пользователя
Удаление сообщенияПо ID сообщения

Операции МАКС

Скриншот 1. Операции для МАКС.

В отличие от Telegram, нет операций бана, прав, инвайт-ссылок и модерации участников через restrict/promote — это специфика МАКС.

Часть 3. Отправка сообщения​

ПолеЗначение
ID канала/группыID получателя
СообщениеТекст с шаблонами замен
КнопкиДоступные в МАКС типы кнопок

Бот опубликует от имени канала.

Применение​

  • Анонс акции;
  • Новости компании;
  • Ссылки на бот для новых клиентов.

Часть 4. Проверка подписки​

ПолеЗначение
ID каналаКого проверять
Имя переменной1 — подписан, 0 — нет
Только МАКС

Если подписчик пришёл из Telegram/VK — возвращает 0. Делайте проверку с учётом мессенджера через [Messenger].

Универсальный сценарий «Подпишись — получи бонус»​

Сценарий действий «До»:
  - Условие: [Messenger] = telegram
    → TG канал → subscription → переменная sub
  - Условие: [Messenger] = max
    → МАКС → subscription → переменная sub
  - Если #{sub} = 1 → выдать бонус

Часть 5. Добавление и удаление участников​

Добавление (add)​

ПолеЗначение
ID каналаКуда добавить
ID пользователяКого добавить

В МАКС бот может сам добавить пользователя — без согласия. Это удобно для:

  • Платных подписок (купил → добавили);
  • Закрытых клубов.
Согласие пользователя

В МАКС добавление без согласия возможно технически, но этически — лучше присылать инвайт-сообщение со ссылкой и кнопкой «Вступить».

Удаление (delete)​

ПолеЗначение
ID каналаОткуда удалить
ID пользователяКого удалить

Применения:

  • Подписка закончилась → удаление;
  • Нарушение правил → удаление.

Часть 6. Удаление сообщения (mesdelete)​

ПолеЗначение
ID каналаГде удалять
ID сообщенияКакое сообщение

Применяется так же, как в Telegram: автоудаление акций, реакция на жалобы.

Часть 7. Типовые сценарии​

Сценарий 1. Анонс акции​

Блок «Запуск анонса»
  Сценарий действий «До»:
    - МАКС → message:
        канал: канал_новостей
        текст: 🔥 Скидка #{percent}% до #{date}
  Сообщение админу: «✅ Опубликовано»

Сценарий 2. Подписка PRO​

Цепочка «Успешная оплата PRO»
  Сценарий действий «До»:
    - МАКС → add:
        канал: pro_канал
        пользователь: [ClientID]
  Сообщение клиенту: «Вы добавлены в PRO-канал!»

Цепочка «Окончание подписки» (триггер: тег `pro_истёк`)
  Сценарий действий «До»:
    - МАКС → delete (тот же канал, тот же клиент)
  Сообщение: «Доступ к PRO-каналу истёк. Продлить?»

Сценарий 3. Геймификация — подпиской​

Блок «Подпишись на канал»
  Сценарий действий «До»:
    - МАКС → subscription → переменная #{is_sub}
  Условие #{is_sub} = 1 → бонус
  Условие #{is_sub} = 0 → «Подпишитесь и нажмите Проверить»

Сценарий 4. Кросс-публикация TG + MAX​

Блок «Опубликовать везде»
  Сценарий действий «До»:
    - TG канал → message: канал_TG
    - МАКС → message: канал_MAX
    - Сохранение в [список](spiski.md) «Публикации»
  Сообщение админу: «✅ Опубликовано в TG и MAX»

Сценарий 5. Автоматическое исключение неактивных​

Цепочка «Чистка канала» (расписание: раз в месяц)
  Сценарий действий «До»:
    - Список «Подписчики MAX» → find неактивных за 90 дней
    - Перебор → МАКС → delete для каждого
    - Уведомление админу: «Удалено #{count} неактивных»

Часть 8. Сравнение с Telegram​

ВозможностьTelegramМАКС
Отправка сообщения✓✓
Проверка подписки✓✓
Удаление сообщения✓✓
Бан✓✗
Снятие бана✓✗
Restrict (ограничения)✓✗
Promote (права)✓✗
Кастомный титул✓✗
Инвайт-ссылка✓✗
Инвайт с параметрами✓✗
Заявки на вступление✓✗
Список админов✓✗
Число участников✓✗
Добавление в канал✗ (Telegram не даёт)✓
Удаление участникачерез ban✓

Главное отличие: МАКС позволяет программно добавлять в канал. Telegram такого не даёт ради защиты от спама.

Часть 9. Архитектура​

Принцип 1. Универсальные ветки сценариев​

Делайте проверку [Messenger] и ветвление: для TG — операции TG, для MAX — MAX. Один сценарий покрывает оба.

Принцип 2. Каналы — в глобальные переменные​

g_max_main, g_max_pro. Не хардкодьте ID в действиях.

Принцип 3. Согласие на добавление​

Перед add спросите клиента «Добавить вас в канал?». Согласие — в переменную, по 1 — добавляем.

Принцип 4. Кросс-постинг с осторожностью​

Не дублируйте контент в TG и MAX автоматически — аудитории разные. Лучше адаптировать сообщение под каждый мессенджер.

Принцип 5. Учёт подписчиков​

Список «Подписчики MAX» с полями ClientID, дата вступления, статус. Это база для рассылок и аналитики.

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

  • subscription = 0, хотя клиент подписан — клиент пришёл не из MAX. Проверьте [Messenger].
  • add не сработал — у бота нет прав добавлять. Проверьте админ-доступ в канале.
  • Кросс-публикация в один канал — указали ID Telegram-канала в действии MAX. Каналы должны быть из соответствующего мессенджера.
  • Сообщения в канале от имени бота, а не канала — настройте подпись/анонимность в админке MAX.
  • Не удаляется участник — возможно, он админ. Снять права админа можно только вручную в интерфейсе MAX.

Что дальше​