Документация

Быстрый старт

Нужны три вещи: публичный или приватный GitHub-репозиторий с уже написанным ботом (Python или Node.js), токен бота от @BotFather (для MAX — см. ниже) и, если репозиторий приватный, токен доступа к нему. В форме «Новый бот» это всё — ссылка на репозиторий, при необходимости токен доступа, ветка (по умолчанию main), команда запуска (можно оставить пустым — определим сами) и токен бота.

Экосистема определяется по файлу в корне репозитория: requirements.txt → Python,package.json → Node.js. Если не нашли ни то, ни другое — деплой падает на этом шаге с понятной ошибкой (см. раздел про ошибки ниже).

Команда запуска по умолчанию для Python — python плюс главный файл из корня: main.py, bot.py, app.py или единственный .py-файл; для Node.js — npm start, если в package.json есть scripts.start, иначе node плюс значение поля main, а если и того нет — node index.js.

Боты для MAX

Бот для MAX деплоится так же, как Telegram-бот. Создать бота в MAX могут организации, ИП и самозанятые: после модерации токен появляется в карточке бота на business.max.ru. Его и вставляйте в поле «Токен бота».

Бот должен получать сообщения через long-polling — вебхуки пока не поддерживаются. Мы передаём токен в переменной BOT_TOKEN, а библиотека maxapi по умолчанию ищет MAX_BOT_TOKEN, поэтому передайте токен явно:

# requirements.txt
maxapi

# bot.py
import asyncio, os
from maxapi import Bot, Dispatcher

bot = Bot(token=os.getenv("BOT_TOKEN"))
dp = Dispatcher()
# ... ваши обработчики ...
asyncio.run(dp.start_polling(bot))

Приватные репозитории

Та же ссылка вида https://github.com/владелец/репо, просто дополнительно нужен токен доступа.

1. Откройте страницу создания токена на GitHub (fine-grained).
2. В Repository access выберите именно этот репозиторий, не «All repositories».
3. В Repository permissions выставьте Contents: Read-only — больше ничего не нужно ни на один пункт.
4. Сгенерируйте токен, вставьте его в поле «Токен доступа к репозиторию» при деплое.

Токен используется только на момент клонирования и нигде не сохраняется в открытом виде — хранится зашифрованным, как и токен бота. В коде или образе собранного бота его не остаётся. Поменять токен или добавить его к уже существующему боту можно на странице бота, в блоке «Доступ к приватному репозиторию» — это пересоберёт бота с новым токеном.

Частая причина ошибки доступа — у токена не хватает прав. GitHub в этом случае отвечает Write access to repository not granted, хотя речь идёт о чтении: убедитесь, что Contents действительно выставлен в Read-only, а не оставлен на «No access» по умолчанию.

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

На странице бота можно добавить любые переменные окружения — они передаются в контейнер при каждой сборке. Значения хранятся зашифрованными и после сохранения не показываются обратно, только пометка «задано». Токен бота (BOT_TOKEN) — такая же переменная, просто заводится сразу при создании.

Лимиты и бесплатная бета

Пробный период — 30 дней с момента первого успешного запуска, все функции включены без урезаний. Он один на аккаунт: удаление и пересоздание бота его не перезапускает. За 7, 3 и 1 день до конца придёт напоминание, оплатить можно заранее прямо на странице бота — оплаченные дни добавятся после пробного периода. Тем, кто зарегистрировался до появления пробного периода, первый бот остаётся бесплатным без срока. Мест ограниченное количество — если свободных нет, форма деплоя предложит оставить контакт.

Вебхуки пока не поддерживаются — у контейнера бота нет публичного адреса, только исходящие long-polling запросы к Telegram или MAX. Очень нужны — напишите в поддержку.

Безопасность и изоляция

Контейнер бота: без доступа к хосту и приватным сетям, без привилегий (--cap-drop ALL), файловая система на чтение (кроме /data и /tmp). Это не настройка «на выбор» — так устроено всегда, для всех ботов.

Токен бота и токен доступа к репозиторию хранятся зашифрованными и нигде не показываются обратно в интерфейсе — видно только «задано». Код публичного репозитория и так открыт на GitHub; приватный клонируется только на время сборки и в образе бота не остаётся.

Ошибки — что значат и как чинить

При создании бота

При сборке (вкладка «Сборка» в логах)

После деплоя (статус бота)

Тарифы

Пробный период — 30 дней, без урезаний. Дальше — 299 ₽ за бота в месяц, на 6 и 12 месяцев дешевле (до −25%), от 3 ботов ещё скидка; без автосписания: оплата на странице бота, места для новых ботов — на странице Тарифы.