Перейти к содержимому
← Все статьи
8 мин чтения

Бот для MAX: как создать, как устроен API и чем он отличается от Telegram-бота

Чат-бот для MAX создаётся на партнёрской платформе мессенджера и работает через HTTPS Bot API. Устроен он похоже на Telegram-бота, но опубликовать его может только верифицированная российская организация, ИП или самозанятый, а в проде события приходят по вебхуку. Ниже: как работает платформа, что переносится из Telegram, какие есть ограничения и когда бот не нужен.

Что такое чат-бот для MAX

MAX — мессенджер с партнёрской платформой для бизнеса: чат-боты, мини-приложения, каналы и Цифровой ID. Бот там — программа, которая получает события от пользователей по HTTPS API и отвечает сообщениями, кнопками и файлами. В документации сценарии описаны так: автоответы, справочные сценарии, приём заказов.

Создать бота можно тремя путями. Конструкторы партнёров без кода работают по готовым шаблонам. Официальный Bot API подходит для своей логики: в документации есть библиотеки для JavaScript и Go и OpenAPI-схема. Если бот должен работать с вашей базой, оплатой или CRM, реалистичен именно путь через API.

Мини-приложения — отдельный продукт: веб-приложения на HTML, JavaScript и CSS, которые общаются с клиентом MAX через библиотеку MAX Bridge. Бот и мини-приложение часто работают вместе, как Telegram-бот и Telegram Mini App.

Для разработчика важно, что платформа задаёт рамки. Правила размещения ботов и требования к приложениям вынесены в отдельные юридические разделы документации, и их стоит прочитать до начала работы. Описание бота должно соответствовать деятельности вашей организации, а нецензурная лексика, контент 18+ и данные других компаний в карточке и логотипе запрещены.

Кто может создать бота для MAX и что требует платформа

Здесь главное отличие от Telegram, где бота создают за минуту без юрлица. В MAX сначала подключаются к платформе. По документации, она открыта для юрлиц, ИП и самозанятых — резидентов РФ. Физлица, которые не самозанятые, и нерезиденты верификацию пока пройти не могут.

Верификация идёт через Госуслуги или банковский ID, подтверждать должен руководитель или администратор, а не обычный сотрудник. Только после этого выбирают сервис «чат-боты» и создают бота. Сколько ботов можно создать, зависит от типа профиля, актуальный лимит смотрите в кабинете.

  • Создайте профиль (организация, ИП или самозанятый) в мини-приложении «MAX для бизнеса» или на веб-платформе.
  • Пройдите верификацию через Госуслуги или банковский ID.
  • В разделе «Чат-боты» заполните карточку: логотип, название и описание. Актуальные требования к размеру и длине смотрите в документации платформы.
  • Правила никнейма задаёт платформа; уточните их, прежде чем печатать никнейм где-либо.
  • Бот уходит на модерацию; заложите на неё время до даты запуска; статус виден рядом с названием бота.
  • После публикации бота можно найти по никнейму. Правка опубликованного бота снова отправляет его на модерацию.

Бот для MAX и Telegram-бот: чем они отличаются

Принцип тот же: токен, HTTP API, входящие события и исходящие сообщения. Различия в правилах и деталях, и на план проекта они влияют сильнее, чем на код.

Главное — доступ. Telegram-боту не нужна компания за спиной. Боту MAX нужен верифицированный российский профиль и модерация, а правка карточки запускает её снова. Учитывайте это до того, как назовёте бизнесу дату запуска.

Есть и мелочи, которые всплывают на интеграции. Ник бота в MAX формируется автоматически, поэтому красивый адрес, как в Telegram, пока не получится. Кроме того, группы и каналы, куда добавлен бот, документация предлагает получать через подписки, а не через список чатов, так что код получения чатов лучше сверять с актуальным разделом API.

  • Кто публикует: в Telegram — любой. В MAX — верифицированные российские организации, ИП и самозанятые.
  • Модерация: у обычного Telegram-бота её нет. В MAX карточку проверяют перед публикацией.
  • Транспорт в проде: в Telegram можно вебхук или long polling. В MAX документация рекомендует вебхук на всех этапах, а long polling называет инструментом для разработки.
  • Вебхук: MAX принимает только HTTPS на порту 443 и не поддерживает самоподписанные сертификаты. Telegram разрешает самоподписанный, если загрузить его.
  • Текст сообщения: в MAX до 4000 символов, в Telegram до 4096.
  • Кнопки: в inline-клавиатуре MAX есть callback, link, open_app, request_geo_location, request_contact, message и clipboard; до 7 кнопок в ряду и 30 рядов.

Как Bot API доставляет события: вебхук и long polling

API работает на platform-api2.max.ru, токен передаётся в заголовке Authorization; передача в query-параметре больше не поддерживается. У API есть лимит запросов, при превышении приходит 429, поэтому отправляйте через очередь с ограничителем скорости. События приходят двумя способами, одновременно их использовать нельзя.

Long polling — это GET /updates. В документации сказано, что он ограничен по скорости и сроку хранения событий и предназначен только для разработки и тестов. В проде нужен вебхук: POST /subscriptions с HTTPS-адресом, необязательным списком типов событий и необязательным секретом. MAX возвращает секрет в заголовке X-Max-Bot-Api-Secret, и запросы с другим значением нужно отклонять.

Правила доставки влияют на архитектуру. Эндпоинт должен ответить 200 в течение 30 секунд. Сбои повторяются до 10 раз с растущим интервалом, а если 8 часов нет успешного ответа, бот автоматически отписывается. Поэтому тяжёлую работу выносят в очередь: приняли событие, сохранили, обработали воркером. Та же логика, что в нашем разборе вебхука и long polling в Telegram, плюс проверка подписи вебхука.

Что переиспользуется из Telegram-бота

Если Telegram-бот написан аккуратно, большая часть его кода не про Telegram. Бизнес-правила, база, интеграции с CRM и оплатой, уведомления и админка стоят за интерфейсом. Специфична для канала только тонкая граница: разбор входящих событий и вызовы API отправки.

Это паттерн адаптера канала. Адаптер превращает нативное событие во внутреннее (пользователь, текст, нажатие кнопки, вложение) и внутренний ответ — в нативный вызов. Ядро не импортирует клиенты Telegram или MAX. Добавить MAX тогда значит написать адаптер, обработчик вебхука и сопоставление идентификаторов, а не второго бота.

  • Переиспользуется как есть: сценарии и состояние, интеграции с CRM и 1С, логика платежей, фоновые задачи, админка, аналитика.
  • Нужен адаптер: разбор входящих событий, отправка сообщений, клавиатуры, загрузка файлов, регистрация команд.
  • Решение по каждому каналу: формат разметки, лимиты кнопок, что делать, если функция есть только в одном мессенджере.
  • Хранить отдельно по каналу: внешний id пользователя, id чата, согласие и статус отписки.

Как вести два канала без дублирования логики

Заведите одну запись пользователя с несколькими идентичностями каналов и состояние диалога, не зависящее от мессенджера. Наш разбор состояния диалога бота подходит напрямую: автомат должен опираться на внутренний id пользователя, а не на chat id Telegram.

Делайте обработчики идемпотентными. Обе платформы повторяют недоставленные вебхуки, поэтому одно событие может прийти дважды. Сохраняйте id события или хеш и пропускайте повторы, как описано в материале про идемпотентность API и повторы. Исходящие сообщения отправляйте через очередь с лимитером на канал: лимиты у площадок разные.

Практичный порядок такой: сначала вынесите ядро из Telegram-бота и покройте его тестами, потом добавьте адаптер MAX и подключите вебхук в тестовой среде, затем отправьте карточку на модерацию. Пока бот на модерации, настройки менять нельзя, поэтому всё нужное должно быть готово заранее. Токен и секрет вебхука храните в переменных окружения, а не в репозитории.

Тесты пишите на внутреннее событие, а не на сырые payload. Тогда новому каналу нужны только тесты адаптера. И заранее фиксируйте разрыв по функциям: если сценарий зависит от возможности, которая есть в одном мессенджере, определите запасной вариант, а не находите проблему в проде.

Когда бот для MAX вам не нужен

Не стоит делать бота только потому, что канал существует. Если ваша аудитория за пределами России или клиенты не пользуются MAX, отдачи не будет. Со стороны бизнеса платформа открыта резидентам РФ, поэтому иностранная компания сейчас опубликовать бота там не может.

Разработка тоже не нужна, если сценарий закрывает конструктор без кода: простой FAQ, меню, форма заявки. Начните с шаблона и переходите к коду, когда нужны своя база, сложное состояние или интеграции. А если вы не знаете, сколько ваших клиентов сидит в MAX, спросите их или проведите пилот: в просмотренной нами официальной документации данных об аудитории нет.

Когда нужен подрядчик

Подрядчик оправдан, когда бот — часть системы и от него зависят процессы компании: читает заказы из CRM, пишет платежи, работает с очередями и не должен падать при деплое. Ещё один случай — у вас уже есть Telegram-бот и нужен второй канал без переписывания: тогда основная работа — рефакторинг под адаптеры.

Своими силами остаются профиль, верификация и владение аккаунтом. Бот принадлежит вашей организации на платформе, поэтому доступ и токен храните у себя, а разработчику давайте только то, что нужно для интеграции. Как мы подходим к задаче — на странице разработки Telegram-ботов и ботов для мессенджеров, а что влияет на бюджет — в статье о стоимости бота.

Вопросы

Частые вопросы

Не нашли ответ — спросите на созвоне или в Telegram.

Как создать бота для MAX?

Подключитесь как организация, ИП или самозанятый — резидент РФ, пройдите верификацию через Госуслуги или банковский ID, в разделе «Чат-боты» заполните карточку. Затем бот уходит на модерацию, заложите на неё время, точный срок в проверенной документации не зафиксирован. После публикации вы получаете токен для работы с API.

Может ли физлицо создать чат-бот для MAX?

По документации платформы, верификация открыта для юрлиц, ИП и самозанятых — резидентов РФ. Физические лица без статуса самозанятого и нерезиденты пока пройти её не могут. Перед планированием проверьте актуальные правила на dev.max.ru: платформа меняется, и мы опираемся на документацию на момент написания.

В MAX вебхук или long polling?

Есть оба способа, но документация рекомендует вебхук на всех этапах, а long polling (GET /updates) описывает как инструмент для разработки и тестов. Одновременно они не работают, подписка отключает long polling. Для вебхука нужен HTTPS-адрес на порту 443 с доверенным сертификатом; самоподписанные не поддерживаются.

Можно ли использовать код Telegram-бота для MAX?

Бизнес-логику, базу и интеграции можно, если они отделены от клиента Telegram. Разбор входящих событий, отправку сообщений и клавиатуры нужно вынести в адаптер MAX. Если вызовы Telegram размазаны по логике, сначала потребуется рефакторинг: это обычно дешевле, чем поддерживать две копии бота.

Какие лимиты у Bot API MAX?

При превышении лимита запросов API отвечает 429, поэтому отправляйте через очередь. По документации: текст сообщения до 4000 символов, до 12 вложений в сообщении. В inline-клавиатуре до 7 кнопок в ряду и 30 рядов. На доставку вебхука нужно ответить кодом 200 в течение 30 секунд, иначе событие считается недоставленным и повторяется.

Нужен ли бот для MAX, если уже есть Telegram-бот?

Только если ваши клиенты действительно пользуются MAX. Для российской аудитории это может быть второй канал с той же логикой внутри, если вы сначала проверили, что клиенты там есть. Для международной он мало что даёт. Ориентируйтесь на то, где клиенты пишут вам сейчас, и добавляйте MAX через адаптер, а не копией бота.

Связанная услуга

Разработка Telegram-ботов для бизнеса

Бот — это вход в вашу систему там, где клиенты и сотрудники уже общаются. Разрабатываем ботов как полноценные приложения: с базой данных, правами доступа и интеграциями, а не как набор кнопок.

Об услуге
Другие статьи
6 мин чтения

Разработка телеграм бота на заказ: архитектура, интеграции и скрытые затраты

Разработка телеграм бота на заказ: от чего зависит стоимость проекта, выбор между конструктором и кодом, платежи, интеграции, серверы и поддержка.

Читать статью: Разработка телеграм бота на заказ: архитектура, интеграции и скрытые затраты →
6 мин чтения

Оплата в телеграм боте: архитектура, платежные шлюзы и надежная обработка

Оплата в телеграм боте: выбор между Stars и ЮKassa, обработка pre_checkout_query, успешные платежи, идемпотентность и возвраты.

Читать статью: Оплата в телеграм боте: архитектура, платежные шлюзы и надежная обработка →
Контакт

Обсудим вашу задачу?

Тридцать минут созвона — и у вас есть понимание архитектуры, сроков и формата работы. Без обязательств.

Или напишите в Telegram →Читайте наш канал в Telegram →

Укажите Telegram или email, чтобы мы могли ответить.

Отвечаем в течение 15 минут.