Подключение бота в MAX — это три действия: взять токен у служебного аккаунта @MasterBot, вставить его в сервис, который будет отвечать за бота, и выдать боту права там, где он должен работать. Сам мессенджер за это денег не берёт, а вся техническая часть укладывается в один вечер.
Дальше — каждый шаг подробно: как обращаться с токеном, чем подключение к личным диалогам отличается от группы, как убедиться, что бот отвечает, и почему чаще всего он молчит.
Если бота у вас ещё нет — сначала прочитайте как создать бота в MAX: там про регистрацию, выбор имени и развилку «кнопочный или с искусственным интеллектом». Эта статья — про следующий шаг: у вас уже есть бот, и его нужно поставить на работу.
Шаг 1. Где взять токен и что это такое #
Токен — единственный ключ к вашему боту. Это длинная строка символов, которую MAX выдаёт один раз при создании и по запросу перевыпускает. Никаких логинов и паролей у бота нет: кто держит токен, тот и управляет ботом.
Получить или посмотреть токен можно только у @MasterBot:
- Откройте MAX и найдите аккаунт @MasterBot.
- Если бот уже создан — запросите список своих ботов и выберите нужного.
- В меню бота есть пункт получения токена. Строка приходит сообщением в переписку.
- Скопируйте её целиком, без пробелов по краям.
Три правила обращения с токеном, которые экономят потом нервы:
- Не пересылать в общие чаты и не хранить в заметках на телефоне. Чем меньше копий ключа гуляет по мессенджерам, тем лучше.
- Не выкладывать в код на GitHub. Публичные репозитории сканируют автоматически, утёкший ключ находят за минуты.
- Утёк — перевыпускайте немедленно. Старый ключ перестаёт работать сразу, новый нужно заново вставить в сервис.
Токен не протухает сам по себе: у него нет срока годности. Но он перестаёт работать в двух случаях — если вы перевыпустили его через @MasterBot и забыли обновить в сервисе, или если бота удалили. Поэтому диагноз «токен просрочен» почти всегда означает «токен перевыпущен, а в настройках остался старый».
Шаг 2. Куда вставить токен #
Токен сам по себе не делает ничего. Нужна сторона, которая принимает входящие сообщения и формирует ответы. Вариантов два.
Свой сервер #
MAX даёт HTTP-API: вы поднимаете сервер, регистрируете адрес для входящих событий и обрабатываете их сами. Нужен программист, хостинг и время на поддержку.
Здесь сразу две грабли, о которые бьются в первый день.
Токен передаётся без приставки Bearer. В большинстве API принято писать Authorization: Bearer <токен>, и привычный код из соседнего проекта тут просто не заработает — сервер вернёт отказ авторизации, а вы будете искать ошибку в самом ключе. В MAX токен идёт напрямую.
Голосовые приходят файлом, а не текстом. В мессенджерах люди охотно наговаривают вопрос вместо того, чтобы печатать, так что без отдельной системы распознавания речи бот будет отвечать «не понял» на заметную часть обращений — подробнее в статье про голосовые сообщения.
Готовый сервис #
Здесь всё сводится к одному полю. У нас в DoEasy это выглядит так: в кабинете открываете карточку канала MAX, вставляете токен, нажимаете подключить. Сервис сам проверяет ключ и запрашивает у платформы имя и номер бота. Дальше бот отвечает по вашей базе знаний, расшифровывает голосовые и передаёт разговор менеджеру, когда клиент просит человека или когда вопрос выходит за пределы базы.
Шаг 3. Какие права выдать #
Дальше зависит от того, где бот должен работать. Личные диалоги и группы устроены по-разному, и это главная причина, по которой «у меня всё подключено, но бот молчит».
Личные диалоги #
Здесь ничего дополнительно выдавать не нужно. Как только токен принят рабочей стороной, бот отвечает любому, кто напишет ему первым. Ссылка на бота — его адрес вида max.ru/имя_бота, её ставят на сайт, в подпись и в рекламу. Адрес задаётся при создании и не меняется, так что осмысленное имя стоит выбрать сразу.
Группы и рабочие чаты #
Тут порядок строже, и шагов больше:
- Разрешить боту состоять в группах. У нового бота добавление в группы по умолчанию запрещено — это включается в настройках бота на платформе MAX. Пока переключатель выключен, бота просто не получится добавить.
- Добавить бота в чат. Это делает администратор группы, не вы и не сервис.
- Выдать право читать сообщения. В MAX нет аналога телеграмного privacy-режима: либо у бота есть право администратора на чтение всего потока чата, либо ему не приходит ничего. Промежуточного варианта платформа не даёт.
Отсюда важное следствие, о котором стоит знать заранее. Раз платформа отдаёт боту весь поток, фильтр «обратились ко мне или нет» должен делать сервис на своей стороне. У нас он устроен так: бот отвечает, только если его позвали по нику или ответили на его сообщение. Всё остальное отбрасывается до того, как попадёт в базу и в аналитику — чужая переписка коллег в системе не оседает. Подробнее это разобрано в статье про чат-бота в групповом чате.
Шаг 4. Проверить, что бот отвечает #
Проверка занимает пару минут и делается по порядку — так вы сразу поймёте, на каком уровне обрыв.
- Напишите боту в личку с другого аккаунта. Так вы увидите ровно то же, что увидит клиент.
- Задайте вопрос своими словами, а не командой из меню. Хорошая проверка — вопрос про цену или условия доставки: сразу видно, отвечает бот по вашим материалам или общими фразами.
- Отправьте голосовое. Если расшифровка подключена, ответ придёт такой же, как на текст.
- Попросите позвать человека. Бот должен замолчать и передать разговор менеджеру.
- Для группы — позовите бота по нику. Он отвечает ответом на ваше сообщение. Потом напишите в той же группе что-то без упоминания: бот обязан промолчать.
Если все пять пунктов прошли — канал подключён рабочим, а не формально.
Сколько стоит подключение #
Сам MAX за бота денег не берёт: и создание, и токен, и API бесплатны. Платить приходится за сторону, которая отвечает клиентам, — за разработку и сервер, если делаете сами, или за сервис, если берёте готовый.
Цены на 18 сентября 2026 года:
| Что | Стоимость |
|---|---|
| Тариф «Старт»: 500 диалогов, один канал и одна база знаний | 7 000 ₽/мес |
| Тариф «Бизнес»: 2 000 диалогов | 15 000 ₽/мес |
| Тариф «Про»: 5 000 диалогов | 30 000 ₽/мес |
| Настройка под ключ (разово) | от 15 000 ₽ |
| Пакет сверх тарифа: 200 диалогов | 1 500 ₽ |
Один канал и одна база знаний уже входят в тариф — отдельно за них платить не нужно. Абонентская плата за канал появляется, только когда каналов больше одного:
| Дополнительно | Стоимость |
|---|---|
| Подключение MAX отдельным каналом | 8 000 ₽ разово |
| Второй канал: подключение со скидкой 30% | 5 600 ₽ разово |
| Второй канал: абонентская плата | 2 000 ₽/мес |
| Третий канал: подключение со скидкой 50% | 4 000 ₽ разово |
| Дополнительная база знаний | 10 000 ₽ разово + 2 500 ₽/мес |
API MAX бесплатен до 2027 года, после возможно платное лицензирование. Точную сумму под ваш набор каналов считает калькулятор на странице тарифов, а общий разбор бюджета есть в статье сколько стоит чат-бот.
Если бот молчит #
Почти все обращения «подключили, а он не отвечает» сводятся к четырём причинам.
Токен старый. Самая частая. Бота перевыпустили, ключ поменялся, а в настройках остался прежний. Лечится заменой строки.
Токен скопирован с лишними символами. Пробел в начале или обрезанный хвост — платформа отвечает отказом авторизации, и выглядит это так же, как неверный ключ. Скопируйте заново, целиком.
В группе не выдано право читать сообщения. Бот в чате состоит, в списке участников виден, но события до него не доходят. Проверяется в правах бота в самом чате: администратор должен разрешить ему читать сообщения.
Боту запрещено состоять в группах. Переключатель в настройках бота на платформе не включён — тогда добавление в чат либо не проходит, либо проходит, но событий нет.
Отдельная категория — бот отвечает, но не то. Это уже не про подключение, а про базу знаний: модель без ваших данных начинает придумывать цены и условия. Как собирать материалы, чтобы этого не было, разобрано в статье про базу знаний для бота.
И сразу про то, чего мы не делаем: рассылки, парсинг чужих чатов и объявлений, накрутку подписчиков. Бот отвечает тем, кто написал первым, и только по вашим материалам.
Частые вопросы #
Где посмотреть токен, если я его потерял? #
У @MasterBot. Откройте переписку с ним, выберите своего бота в списке и запросите токен заново. Если функция выдаёт новый ключ вместо старого — не забудьте обновить его в сервисе, иначе бот замолчит.
Можно ли подключить одного бота сразу к личным диалогам и к группам? #
Да, это один и тот же бот и один токен. Режим определяется сам по типу чата: в личке бот отвечает на любое сообщение, в группе — только когда его позвали. Отдельно ничего переключать не нужно.
Нужен ли программист, чтобы подключить бота? #
Для готового сервиса — нет: вся работа сводится к тому, чтобы вставить токен и выдать права в чате. Для своего сервера программист нужен и на запуск, и на поддержку: API меняется, ошибки надо ловить, сервер обновлять.
Чем подключение к каналу MAX отличается от группы? #
Канал — это вещание на подписчиков, групповой чат — переписка участников между собой. Наш групповой режим сделан именно под чаты: бот отвечает тому, кто к нему обратился. Работу с комментариями и каналами мы разбирали отдельно — в статье про ботов для комментариев и каналов.
Сколько времени занимает подключение? #
Техническая часть — минуты: вставить токен и выдать права. Всё остальное время уходит на подготовку базы знаний, чтобы боту было чем отвечать. Обычно от старта до запуска проходит от 3 до 10 дней.
Нужно ли что-то менять, если я потом добавлю Telegram? #
Нет, база знаний общая. Каналы подключаются к ней по очереди, и бот одинаково отвечает везде. Разницу между площадками мы разбирали в статье MAX или Telegram.
