Справочник методов API

Добавить подписчика в группу или убрать из неё.

Создать группу подписчиков.

Удалить группу вместе с членством. Подписчики остаются. Необратимо.

Подписчики бота с признаками «закрыл чат» и «заблокирован».

Подписчики группы.

Группы подписчиков (сегменты).

Профиль подписчика: поиск по id, логину, телефону или email.

Отменить запланированную рассылку. Ушедшую в отправку отменить нельзя — её останавливает StopBroadcast.

Разовая рассылка подписчикам: сейчас или по расписанию. Тратит деньги и внимание аудитории.

Разовые рассылки бота со статусом (запланирована / отправляется / останавливается / отправлена / остановлена / прервана) и ходом отправки: done из total, intervalMs, remainingSec, stoppable.

Отправить сообщение конкретным подписчикам или группе. Списывает средства.

Остановить идущую рассылку (в GetBroadcasts stoppable=true): следующая волна не уйдёт, списание — только за отправленное. Тем, кому она уже ушла, сообщение останется.

Справочник переменных бота (id, ключ, лимит длины, тип значения).

Записать значение переменной подписчику. Если у переменной задан тип (число, дата, телефон, почта, да/нет), значение проверяется и приводится к единому виду — телефон, например, к +7…

Типы внутренних балансов бота и курсы обмена.

Изменить курс обмена типа баланса.

Изменить внутренний баланс подписчика. Движение денег — операция необратимая.

Создать способ оплаты бота. Ключи, без которых платёж не пройдёт, обязательны сразу. На MAX и ВКонтакте внешних шлюзов нет — там допустим только тип manual.

Удалить способ оплаты. Действия «Оплата», ссылавшиеся на него, останутся с висячей ссылкой и уведут подписчика по маршруту ошибки — их число вернётся в actionsAffected. Необратимо.

Денежные настройки бота: реферальная программа (выплата пригласившему за подтверждённый платёж) и уведомления владельца об оплатах.

Способы оплаты бота: тип, баланс, настройки чека 54-ФЗ и признак готовности (ready/missing). Токены и ключи эквайринга не возвращаются — только признак «задано» в secrets.

Изменить денежные настройки бота (частично). Реферальная выплата начисляется пригласившему в момент подтверждённого платежа приглашённого и тратит баланс бота на каждой оплате.

Изменить способ оплаты (частично: переданные поля обновляются, остальные сохраняются). Смена реквизитов перенаправляет оплаты клиентов на другой счёт.

Профили оповещений бота — кому уходят заявки, файлы хранилища, запросы доступа, оплаты и брони: получатели с состоянием доставки, переменные, число мест, где выбран профиль, и справочники для получателей (chats — каналы и группы бота, members — команда бота, variables). active=false — профили в окружении ещё не включены, действуют старые «Уведомления».

Создать профиль оповещений (без id) или изменить его частично (с id): не переданные поля сохраняются. recipients добавляет новых получателей и меняет тему сохранённых чатов, remove убирает — список целиком не заменяется. Подписчик бота ({kind:"botuser"}) молча не добавляется: в ответе придёт subscriberLink, человек подтверждает подключение в боте. Выбрать профиль в действиях и объектах брони — через MCP.

Пост в канал или группу бота: черновик, по расписанию или сразу. Опубликованное сразу видят все подписчики канала.

Создать инвайт-ссылку канала.

Удалить пост из плана публикаций. Уже опубликованное сообщение остаётся в канале — его убирают в самом мессенджере.

Отозвать инвайт-ссылку. Необратимо.

Изменить инвайт-ссылку.

Посты канала: черновики, запланированные и опубликованные, свежие сверху.

Каналы и группы, к которым подключён бот.

Инвайт-ссылки канала со статистикой переходов.

Заявки на доступ с даты.

Структура бота: списки рубрик и рубрики внутри них.

Сигналы (события сценариев) с даты.

Файлы и тексты, присланные подписчиками, с даты.

Одобрить или отклонить заявку на доступ. allow — подписчик получает текст «доступ открыт» и идёт дальше по сценарию; deny — текст отказа. Повтор того же статуса ничего не меняет; deny по уже одобренной заявке отзывает доступ без сообщения (при следующем входе «Запрос доступа» не пустит).

Одна бронь по id.

Брони объекта на ближайшие дни.

Свободные слоты объекта по услугам.

Объекты бронирования (готовые к записи).

Услуги бронирования: длительность и цена.

Справочник статусов брони.

Подтвердить или отклонить бронь (как во «Входящих» панели).