Боты для VK и MAX
Кроме Telegram, AutoHoster запускает ботов сообществ ВКонтакте и ботов мессенджера MAX. Бот из репозитория работает так же, как телеграм-бот: платформа собирает образ, запускает контейнер и передаёт ему токен через переменные окружения. Платформа выбирается при создании бота (переключатель Telegram / VK / MAX перед полем токена) и потом не меняется — для другой платформы создайте отдельного бота.
Если писать код не хочется, соберите бота в конструкторе: один сценарий работает сразу в Telegram, VK, MAX и чатах Avito.
Как получить токен VK
- Откройте своё сообщество → Управление → Работа с API → Ключи доступа → Создать ключ.
- Отметьте права «Сообщения сообщества» и «Управление сообществом». Без второго права нельзя подключиться к Long Poll API, и платформа ключ не примет — покажет, каких прав не хватает.
- Скопируйте ключ и вставьте его в поле токена на 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_PLATFORM | telegram, vk или max |
TELEGRAM_BOT_TOKEN / VK_BOT_TOKEN / MAX_BOT_TOKEN | тот же токен под «родным» именем платформы; имя можно поменять в настройках бота |
VK_GROUP_ID | id сообщества — только у ботов 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 для бизнеса».