Боты для VK и MAX

Кроме Telegram, AutoHoster запускает ботов сообществ ВКонтакте и ботов мессенджера MAX. Бот из репозитория работает так же, как телеграм-бот: платформа собирает образ, запускает контейнер и передаёт ему токен через переменные окружения. Платформа выбирается при создании бота (переключатель Telegram / VK / MAX перед полем токена) и потом не меняется — для другой платформы создайте отдельного бота.

Если писать код не хочется, соберите бота в конструкторе: один сценарий работает сразу в Telegram, VK, MAX и чатах Avito.

Как получить токен VK

Видеоинструкция: ключ доступа сообщества за минуту
  1. Откройте своё сообщество → Управление → Работа с API → Ключи доступа → Создать ключ.
  2. Отметьте права «Сообщения сообщества» и «Управление сообществом». Без второго права нельзя подключиться к Long Poll API, и платформа ключ не примет — покажет, каких прав не хватает.
  3. Скопируйте ключ и вставьте его в поле токена на AutoHoster.

При создании бота отметьте «Настроить сообщество автоматически» (включено по умолчанию): платформа включит Long Poll API версии 5.199 с нужными событиями (входящие сообщения, нажатия кнопок, разрешение и запрет сообщений), сообщения сообщества, возможности ботов и кнопку «Начать». Если что-то не получилось, в журнале бота появится строка [AutoHoster] … с подсказкой, что включить вручную: Управление → Работа с API → Long Poll API и Управление → Сообщения → Настройки для бота.

Как получить токен MAX

Ботов MAX создают в разделе «MAX для бизнеса» → «Чат-боты». Заранее учтите две вещи:

  • нужен верифицированный профиль организации, ИП или самозанятого — без него создать бота нельзя;
  • бот становится доступен пользователям только после модерации — заложите на неё время.

После создания бота MAX выдаёт токен — его и нужно вставить на AutoHoster. Платформа проверит токен запросом GET /me; если MAX ответит «токен недействителен», ошибка будет «MAX отклонил токен».

Получать события в MAX можно либо long polling, либо вебхуком — одновременно нельзя. Если у бота настроена подписка на вебхук, платформа предупредит об этом при проверке токена: пока подписка активна, бот на long polling не получает сообщений.

Переменные окружения

Платформа задаёт эти переменные сама, вручную их добавить нельзя:

ПеременнаяЧто в ней
BOT_TOKENтокен бота — у всех платформ
BOT_PLATFORMtelegram, vk или max
TELEGRAM_BOT_TOKEN / VK_BOT_TOKEN / MAX_BOT_TOKENтот же токен под «родным» именем платформы; имя можно поменять в настройках бота
VK_GROUP_IDid сообщества — только у ботов VK

Код, который читает BOT_TOKEN, запускается без изменений на любой платформе; для конкретной библиотеки удобнее «родное» имя.

Пример бота VK на vkbottle

requirements.txt:

vkbottle>=4.3

main.py:

import os

from vkbottle.bot import Bot, Message

bot = Bot(os.environ["VK_BOT_TOKEN"])


@bot.on.message(text=["Начать", "start"])
async def start(message: Message):
    await message.answer("Привет! Я работаю на AutoHoster.")


@bot.on.message()
async def echo(message: Message):
    await message.answer(message.text or "Пришлите текст")


bot.run_forever()

vkbottle сама узнаёт id сообщества по токену. Если ваша библиотека просит его явно (например, VkBotLongPoll(session, group_id) в vk_api), берите int(os.environ["VK_GROUP_ID"]).

Пример бота MAX на maxapi

requirements.txt:

maxapi

main.py:

import asyncio
import os

from maxapi import Bot, Dispatcher, F
from maxapi.types import BotStarted, MessageCreated

bot = Bot(os.environ["MAX_BOT_TOKEN"])
dp = Dispatcher()


@dp.bot_started()
async def on_start(event: BotStarted):
    await bot.send_message(chat_id=event.chat_id, text="Привет! Я работаю на AutoHoster.")


@dp.message_created(F.message.body.text)
async def echo(event: MessageCreated):
    await event.message.answer(event.message.body.text)


async def main():
    await dp.start_polling(bot)


asyncio.run(main())

maxapi умеет брать токен из MAX_BOT_TOKEN и сама, если вызвать Bot() без аргументов.

Ограничения

  • Только long polling. VK-бот получает события через Bots Long Poll API, MAX-бот — через GET /updates. Вебхуки (Callback API VK, подписки MAX) платформа к контейнеру не пробрасывает.
  • Нет спящего режима. У VK и MAX нет способа «подсмотреть» новые сообщения, не забрав их: проснувшийся бот начал бы слушать с текущего момента и потерял бы сообщение, которое его разбудило. Поэтому боты VK и MAX работают постоянно на любом тарифе, а переключатель сна для них недоступен.
  • Один токен — один бот. Тот же бот Telegram, сообщество VK или бот MAX нельзя подключить к AutoHoster дважды (ни как бота из репозитория, ни как канал конструктора): два процесса с одним токеном мешали бы друг другу. Платформа ответит «Этот бот уже подключён к AutoHoster».
  • MAX: верификация и модерация — см. выше.

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

  • «У ключа нет прав: …» — ключ создан без «Сообщений сообщества» или «Управления сообществом». Создайте новый ключ с обоими правами.
  • «Это не ключ сообщества» — вставлен ключ пользователя или приложения. Нужен ключ из настроек самого сообщества.
  • Бот VK запущен, но молчит — проверьте, что Long Poll API включён и отмечены события «Входящее сообщение» и «Действие с сообщением» (для кнопок), а в настройках сообщества включены сообщения.
  • «MAX отклонил токен» — токен отозван или скопирован не полностью; выпустите новый в «MAX для бизнеса».