ЧБТ ЧБТ конструктор чат-ботов
Создать бота
Возможности
Продавцам ИИ-продавец Wildberries Интернет-магазин QR-код на вкладыш
Мессенджеры Telegram MAX ВКонтакте Чат на сайте
Шаблоны Тарифы Блог Помощь
Войти Создать бота

Главная · Блог · Как создать бота в MAX

Как создать бота в MAX

· обновлено · Команда ЧБТ · MAX, Старт

MAX моложе Telegram: инструкций мало, а официальная документация написана для разработчиков. При этом схема запуска бота ничем принципиально не отличается: регистрируете бота на платформе, получаете токен, подключаете его к «мозгу», который отвечает на сообщения. В ЧБТ таким мозгом служит сценарий из блоков, а MAX — один из каналов проекта рядом с Telegram, ВКонтакте и виджетом. Ниже — полный путь: от кабинета «MAX для бизнеса» до проверки на телефоне, с упором на то, чем MAX отличается и что из-за этого поменять в сценарии.

Что нужно заранее

Три вещи, без которых дальше не пройти.

  • Аккаунт в MAX. Приложение установлено, номер подтверждён. С этого аккаунта вы войдёте в кабинет для бизнеса и с него же потом будете тестировать бота — удобно иметь второй номер или коллегу для проверки «глазами клиента».
  • Кабинет «MAX для бизнеса» — business.max.ru. Именно там создаются боты и выдаются токены. Кабинет один на компанию; если ботов будет несколько, все они живут в нём.
  • Проект в ЧБТ. Регистрация на app.chbt.io по e-mail и паролю, затем «Создать бота». В терминах ЧБТ «Бот» — это проект: к нему подключаются каналы, и один сценарий работает во всех. На Бесплатном тарифе один проект, 30 диалогов в месяц и все каналы без ограничений по типу — MAX включён.

Если бот уже работает в Telegram, отдельный проект для MAX не нужен: канал добавляется в существующий, сценарий подхватывается тот же. Если MAX — первый канал, начинайте с пустого проекта.

Шаг 1. Зарегистрировать бота в MAX для бизнеса и получить токен

Войдите на business.max.ru под своим аккаунтом MAX и создайте бота. Платформа попросит название, аватар и короткое описание — то, что клиент увидит в карточке бота до первого сообщения. Название пишите так, как называется бизнес, без слова «бот»: «Стоматология Улыбка», «Доставка Сакура». Описание — одна-две фразы о том, что бот умеет: «Запишу на приём, напомню о визите, отвечу по ценам».

После создания на странице бота появится токен — длинная строка, которой ЧБТ будет представляться платформе от имени бота. Правила обращения с ним те же, что и для любого секрета: не пересылать в чаты, не оставлять на скриншотах, не хранить в заметках. Единственное место назначения — поле «Токен» в разделе «Каналы» ЧБТ. Если токен всё же попал не туда, в кабинете MAX его можно перевыпустить; старый после этого перестанет работать, и канал в ЧБТ придётся подключить заново.

Формулировки пунктов в кабинете MAX меняются от версии к версии, поэтому ориентируйтесь на смысл: вам нужен раздел про ботов и в нём — строка с токеном. Если кабинет спрашивает про webhook или адрес для уведомлений, ничего заполнять не нужно: ЧБТ установит подписку на события сам при подключении.

Шаг 2. Подключить канал в ЧБТ

В проекте откройте раздел «Каналы». Среди карточек каналов найдите MAX и нажмите «Подключить MAX». Два поля: «Название канала» — для себя, чтобы отличать каналы в списке, и «Токен» — строка из кабинета MAX, целиком и без пробелов. Нажмите «Подключить».

Дальше ЧБТ делает то, что в самостоятельной разработке заняло бы вечер. Сначала проверяет токен: запрашивает у платформы данные бота — если токен неверный, вы сразу увидите статус «Ошибка» и текст «Неверный токен MAX или API недоступен». Затем оформляет подписку на события бота: сообщает MAX адрес https://app.chbt.io/webhook/max/ID_канала, куда платформа будет присылать каждое входящее сообщение, нажатие кнопки и факт открытия бота. Никакого сервера и домена с вашей стороны. Если подписка удалась, статус переключится на «Работает»; если поле «Название канала» оставили пустым, в него подставится имя бота из MAX.

Если что-то пошло не так, в таблице каналов под статусом мелким текстом будет причина — ответ платформы. Кнопка «Переустановить webhook» повторяет подписку с тем же токеном: пригодится, если подписка слетела. Токен в существующем канале не редактируется: при смене токена канал удаляют кнопкой «Удалить» и подключают заново. Контакты при этом не теряются — они привязаны к проекту и идентификатору пользователя MAX, а не к каналу. А вот переписка удалённого канала из «Диалогов» пропадёт, и восстановить её нельзя. Краткая версия этого шага — в справке по подключению MAX.

Чем MAX-бот отличается от Telegram: пять особенностей для сценария

Сценарий один на все каналы, но некоторые привычки из Telegram в MAX не переносятся. Учесть их лучше до того, как вы начнёте править тексты.

  1. Правило первого сообщения. Бот в MAX не может написать человеку, который сам не открывал с ним диалог. Пока клиент не нажал «Начать» или не написал первым, адресата для сообщений не существует — ни у ЧБТ, ни у кого-либо ещё. Загрузить список телефонов и разослать «мы теперь в MAX» невозможно. База для рассылок и напоминаний равна списку тех, кто уже писал боту. Как выстроить уведомления с учётом этого правила, разобрано в статье о служебных уведомлениях через MAX-бота.
  2. Открытие бота — это уже событие. Когда человек впервые открывает бота и нажимает «Начать», MAX присылает событие старта, и ЧБТ обрабатывает его как /start. Значит, триггер «Команда /start» в сценарии сработает и в MAX — отдельный триггер не нужен. Если бота открыли по ссылке с параметром, параметр приходит в том же событии и ловится триггером «Deeplink». Формат такой ссылки уточняйте в документации MAX для бизнеса — QR-кампании ЧБТ пока строят диплинки только для Telegram.
  3. Кнопки — под сообщением, в один ряд. В MAX-канале ЧБТ кнопки блока «Сообщение» выводятся под текстом одной строкой. Два типа: переход в ветку сценария и ссылка. Постоянного меню под полем ввода нет. Практический вывод: не больше трёх кнопок на сообщение, подписи в одно-два слова («Записаться», «Цены», «Адрес»), а стартовое меню повторяйте в конце длинных веток — иначе человеку придётся писать текстом, чтобы вернуться.
  4. Только текст и кнопки. Фото, PDF и видео в MAX через ЧБТ не отправить. Прайс — ссылкой в тексте, схему проезда — ссылкой на карту.
  5. Нет индикатора «печатает». В Telegram-канале ЧБТ показывает его, пока готовит ответ; в MAX ответ появляется сразу. На длинных сообщениях пауза перед появлением текста заметна, поэтому режьте сообщения на два-три коротких.

Ограничения на частоту исходящих сообщений задаёт платформа. Сценарные ответы под них не попадают, а рассылки ЧБТ отправляет через очередь с троттлингом — но если аудитория большая, разбивайте рассылку по тегам на несколько частей.

Шаг 3. Первый сценарий: шаблон и правки под MAX

Откройте раздел «Сценарии», создайте сценарий и в редакторе нажмите «Из шаблона». Для MAX хорошо стартуют три: «Запись клиентов» — услуга кнопками, время текстом, телефон; «Автоответчик FAQ» — ключевые слова про цены и график, остальное оператору; «Согласие на рассылку» — если главная цель — собрать базу тех, кому потом можно писать. Шаблон раскладывается в блоки: триггер «Команда /start», «Сообщение» с кнопками, «Сбор данных» с проверкой формата, «Действие» с уведомлением вам.

Теперь правки под MAX, по списку из предыдущего раздела.

  • Сократите приветствие до двух-трёх строк и оставьте в нём не больше трёх кнопок. Если в шаблоне пять услуг — сгруппируйте: «Стрижка», «Окрашивание», «Другое».
  • В конец каждой ветки добавьте блок «Сообщение» с кнопкой «В начало» — заменяет отсутствующее меню.
  • Ссылки на прайс, карту и политику давайте кнопкой типа «Ссылка», а не текстом: на телефоне на неё проще нажать.
  • Добавьте триггер «Любое сообщение» с возвратом в меню: он поймает тех, кто напишет «здравствуйте» вместо нажатия «Начать».
  • Если тот же сценарий работает и в Telegram, а тексты хотите разные, поставьте блок «Условие» по каналу: ветка «MAX» — короткий текст, ветка «иначе» — полный. Подробно этот приём разобран в статье про один сценарий на MAX и Telegram.

На Бесплатном тарифе редактор работает в режиме «Шаги» — линейный список блоков; на Базовом открывается «Холст» с ветками и стрелками. Изменения сохраняются автоматически, кнопка «История» (история версий) откатывает неудачные правки. Последнее и обязательное: включите сценарий. На карточке сценария стоит плашка «Включён» или «Черновик» и переключатель рядом — он же есть на странице «Обзор»; новый сценарий и копия, сделанная кнопкой «Дубликат», создаются черновиками.

Шаг 4. Проверить бота: тест-чат и телефон

Сначала в редакторе. Кнопка «Проверить сценарий» открывает тест-чат рядом со схемой. Пройдите все ветки, нажмите каждую кнопку, введите телефон с ошибкой и убедитесь, что бот переспрашивает вашим текстом, а не стандартным. Тест-чат работает без подключённого канала и ведётся от имени служебного контакта «Тест»; в месячный лимит диалогов он не входит. Логику ловите здесь.

Потом в MAX. Найдите бота в приложении по названию или откройте его страницу из кабинета MAX для бизнеса, нажмите «Начать». Приветствие должно прийти в течение секунды-двух. Нажмите кнопку перехода — сценарий должен продолжиться; нажмите кнопку-ссылку — должен открыться браузер. Дойдите до сбора телефона, оставьте номер.

Затем в кабинете ЧБТ. В «Диалогах» — переписка с пометкой канала MAX; в «Контактах» — карточка с именем из профиля MAX и телефоном; на почте — письмо о новой заявке, если уведомления включены в «Аккаунт → Уведомления». Если сценарий заканчивается блоком «Оператор», ответьте из «Диалогов» и проверьте, что ответ пришёл в MAX.

Обязательный последний тест — со второго устройства или аккаунта коллеги. Вы знаете, куда нажимать; посторонний человек за минуту найдёт ветку, где текст обрывается или кнопка ведёт не туда. Помните, что на Бесплатном тарифе каждый новый собеседник в MAX, включая ваш второй аккаунт и аккаунт коллеги, — один из 30 диалогов месяца.

Если бот MAX молчит

Причины почти всегда те же, что у любого бота на ЧБТ, плюс две специфичные для MAX. Идите сверху вниз.

  • В «Каналах» статус «Ошибка». Прочитайте текст под статусом. «Неверный токен MAX или API недоступен» — токен скопирован не целиком или перевыпущен: удалите канал и подключите заново с актуальным (переписка удалённого канала пропадёт, контакты останутся). Ошибка подписки — нажмите «Переустановить webhook».
  • Статус «Работает», но на «Начать» тишина. Сценарий в черновике (включите переключателем на его карточке) или в нём нет триггера «Команда /start».
  • На старт отвечает, на обычный текст — нет. Нет триггера «Любое сообщение», а слово не совпало ни с одним ключевым.
  • Отвечает фразой про лимит диалогов. На Бесплатном тарифе 30 собеседников в месяц уже было, и новым людям бот вместо сценария отправляет короткую заглушку, а те, кто уже писал в этом месяце, получают ответы как обычно. Проверьте счётчик «N из 30» на странице «Обзор» бота. Решение — дождаться нового месяца или Базовый за 650 ₽ за бота в месяц.
  • Рассылка не доходит до части базы. Люди заблокировали бота или никогда ему не писали — MAX не даёт написать первым. В статистике рассылки это строка «ошибки»; чистить руками не нужно.
  • Бот отвечает, но с задержкой в несколько секунд на длинных сообщениях. Это не поломка: в MAX нет индикатора «печатает». Разбейте текст на короткие сообщения.

Короткий чеклист для закладки — в справке «Бот MAX молчит». Если задача бота — отвечать на входящие вопросы вне рабочего времени, посмотрите разбор бота-автоответчика в MAX: там условие по времени суток и передача оператору.

Один проект — MAX и Telegram вместе

Сценарий, который вы только что собрали для MAX, без изменений отвечает и в Telegram: в «Каналах» добавляете токен от @BotFather — и тот же бот работает в обоих мессенджерах. Контакты из обоих каналов собираются в одних «Контактах» с пометкой канала, переписка — в одних «Диалогах», заявки — в одной CRM. Цена — за проект, а не за канал, так что второй мессенджер ничего не добавляет к счёту. Как зарегистрировать бота в Telegram и что там настраивать у BotFather, пошагово описано в статье как создать Telegram-бота.

Когда каналы стоит разделить на два проекта: если аудитории принципиально разные (розница в MAX, партнёры в Telegram) и сценарии не пересекаются, или если вам нужны отдельные команды операторов. В остальных случаях один проект проще: одна правка сценария — и она сразу в обоих каналах.

Итого на бота в MAX уходит вечер: полчаса в кабинете MAX для бизнеса, пять минут в «Каналах», час на правки шаблона и полчаса на проверку с двух телефонов. Создать бота в MAX бесплатно →

Конструктор ботов MAXСправка: подключить MAXЗапись клиентов в MAXУведомления клиентам через MAX-ботаMAX или Telegram: где запускать бота

Ещё в блоге