Бот с разработкой: подготовка и настройка
Привет! Я прошёл весь путь создания бота в MAX с нуля — от регистрации до продакшена. В этом разделе расскажу, как подготовиться и настроить бота, если ты планируешь писать код. Это не «клик-клик-готово» — здесь нужно понимать, что делаешь. Но после моего гайда у тебя всё получится.
Кто может создать бота с разработкой
Создавать ботов в MAX могут юридические лица, ИП и самозанятые — резиденты Российской Федерации. Если ты физлицо без статуса — увы, платформа пока не даёт такой возможности. Мне, как самозанятому, процесс регистрации дался легко: загрузил документы, дождался проверки (это заняло около суток) — и вперёд.
Уровень сложности: продвинутый. Тебе понадобятся навыки работы с HTTP API, опыт развёртывания веб-сервера (HTTPS обязателен) и понимание базовых принципов обработки событий.
Получение токена
Токен — это твой ключ доступа к API MAX. Без него бот не сможет отправлять сообщения. Получить его можно через платформу MAX для партнёров:
- Зайди в раздел Чат-боты на платформе
- Нажми Перейти рядом с нужным ботом
- Открой Расширенные настройки
- Нажми Настроить
- Там будет твой токен — скопируй его и сохрани в надёжном месте
abc123def456ghi789jkl012mno345pqr678stu901vwx234.env) или в секретах твоего
хостинга. Если токен скомпрометирован — сбрось его через те же расширенные настройки.
Настройка вебхука
Чтобы бот реагировал на сообщения пользователей, MAX отправляет POST-запросы на твой сервер при каждом событии. Этот механизм называется вебхук (webhook).
Требования к серверу
- HTTPS обязателен — HTTP-эндпоин ты не принимаются. Нужен валидный SSL-сертификат (Let's Encrypt подойдёт).
- Лимит запросов: 30 запросов в секунду (rps). Если твой бот популярный — проектируй архитектуру с учётом этого ограничения.
-
Сервер должен отвечать
200 OKв течение 3 секунд на каждый входящий вебхук. Если не успел — MAX будет повторять запрос, и ты
рискуешь получить дубликаты событий.
Базовые шаги настройки бота
Вот минимальный чеклист того, что нужно сделать после получения токена:
- Разверни сервер с HTTPS (можно на VPS, например, за 300–500 ₽/мес)
- Настрой эндпоинт для вебхука (например,
/webhook) - Зарегистрируй URL вебхука через API MAX (метод
- Реализуй обработку входящих событий: текст, колбэки, команды
- Настрой логирование — без него отладка превратится в ад
- Протестируй на своём аккаунте перед запуском для пользователей
setWebhook)
Библиотеки для разработки
MAX предоставляет официальные библиотеки, которые сильно упрощают работу с API. Вот что есть на сегодня:
- Библиотека JavaScript/TypeScript — для Node.js, с типизацией и удобными хелперами.
- Библиотека Golang — для тех, кто предпочитает Go, с идиоматичным API.
Я сам писал бота на чистом Node.js без библиотеки, потому что на старте её ещё не было. Но сейчас, если бы начинал заново — взял бы JS-библиотеку не думая. Она закрывает рутину: формирование запросов, обработку ошибок, типы событий.
Мои советы
Дальше — выбирай библиотеку (JavaScript или Golang) и смотри примеры. Удачи!