Как создать чат-бота в MAX: пошаговое руководство для начинающих

Найти MasterBot

В поиске MAX набрать «MasterBot» и начать с ним диалог командой /create.

Задать имя и username

Имя видно пользователям, username — уникальный идентификатор, оканчивающийся на «bot».

Получить токен

MasterBot выдаёт секретный токен доступа к Bot API. Его нельзя публиковать и хранить в открытом коде.

import requests, time

API = "https://botapi.max.ru"
TOKEN = "ВАШ_ТОКЕН"
marker = None

while True:
    resp = requests.get(
        f"{API}/updates",
        params={"access_token": TOKEN, "marker": marker, "timeout": 30}
    ).json()

    for upd in resp.get("updates", []):
        msg = upd.get("message")
        if msg and msg.get("text"):
            chat_id = msg["chat_id"]
            requests.post(
                f"{API}/messages",
                params={"access_token": TOKEN, "chat_id": chat_id},
                json={"text": msg["text"]}
            )
    marker = resp.get("marker", marker)
    time.sleep(0.5)

{
  "updates": [
    {
      "update_type": "message_created",
      "message": {
        "chat_id": 123456,
        "text": "Привет, бот!",
        "sender": { "user_id": 98765 }
      }
    }
  ],
  "marker": 15782
}

✕ Токен в открытом коде

Храните токен в переменных окружения или конфиге вне репозитория. Утечка означает полный контроль над ботом у посторонних.

✕ Игнорирование маркера

Без marker бот снова получает старые обновления и отвечает на одно сообщение по несколько раз.

✕ Нет обработки ошибок

Сетевой сбой без try/except уронит весь цикл. Оборачивайте запросы и добавляйте повторные попытки с паузой.

✕ Ответ «одними текстами»

Бот, который понимает только точный текст, разочаровывает пользователей. Добавляйте кнопки, команды и подсказки.