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

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

Ниже приведён короткий путь от идеи до запуска на примере MAXorg. Для базовой воронки свой сервер не нужен. Потребуются зарегистрированный бот MAX, токен, готовые тексты и сотрудник, который будет обрабатывать обращения.

1. Выберите задачу и границы сценария

Сформулируйте результат одним предложением: «бот собирает заявку на консультацию и уведомляет менеджера». Не ставьте цель «автоматизировать продажи». Она не задаёт ни конец сценария, ни способ проверки.

Запишите маршрут клиента в 5-7 шагах. Для каждого шага укажите действие бота, ожидаемый ответ человека и следующий переход. Отдельно предусмотрите отказ, неверный ответ и просьбу связаться с оператором.

• Одна цель первого запуска.
• Не больше 5-7 основных шагов.
• Один ответственный за заявки.
• Указанное время ответа сотрудника.

Посмотрите примеры в разделе ботов MAX, но не копируйте чужую воронку целиком. Сценарий должен соответствовать вашему процессу, графику команды и данным, которые действительно нужны.

2. Подготовьте бот и токен

Создайте карточку бота на платформе MAX для партнёров или через «MAX для бизнеса». Подключение сервисов платформы доступно верифицированным юридическим лицам, ИП и самозанятым, являющимся резидентами РФ. Заполните профиль и пройдите модерацию. Поля интерфейса могут меняться, поэтому сверяйтесь с текущей справкой MAX.

После проверки скопируйте токен из расширенных настроек. Это секрет доступа, а не публичная ссылка. Храните его в менеджере паролей, не отправляйте в общий чат и не вставляйте в открытые документы. При утечке обновите токен на стороне MAX и замените его во всех подключённых сервисах.

1. Проверьте имя, username и аватар бота.
2. Скопируйте токен без кавычек и пробелов.
3. Сохраните его в защищённом хранилище.
4. Назначьте владельца доступа.

3. Подключите бота к MAXorg

Создайте аккаунт в кабинете MAXorg, откройте раздел ботов и добавьте новый проект. Вставьте токен. Название можно не указывать: тогда сервис возьмёт имя из профиля MAX.

При сохранении MAXorg проверяет токен через метод /me Bot API и получает идентификатор, имя, username и аватар. Если секрет верный, карточка получает активный статус. Один бот нельзя подключить как несколько независимых проектов.

При ошибке 401 заново скопируйте актуальный токен и проверьте, не был ли он отозван. Сообщение о недоступности platform-api2.max.ru обычно связано с сетью, DNS, сертификатом или временной проблемой API. Менять из-за него текст воронки бессмысленно.

4. Соберите короткую воронку

Создайте воронку со стартовым узлом. Первое сообщение должно за два-три предложения объяснить пользу и следующий шаг. Затем добавьте только нужные блоки: сообщение, условие, вопрос, запрос email, бронирование, уведомление, оплату через ЮKassa или вебхук.

Каждый экран выполняет одну функцию. Вопрос собирает один ответ, подтверждение сообщает следующий шаг, уведомление передаёт заявку сотруднику. Не просите телефон и email одновременно, если для результата достаточно одного контакта.

• Кнопка-ссылка ведёт только на http или https.
• Callback открывает отдельную ветку сценария.
• Запрос контакта просит телефон у пользователя.
• Open app подходит только для зарегистрированного в MAX мини-приложения.

У каждой ветки должен быть понятный конец. После оплаты или передачи оператору не возвращайте клиента в начало. Свободный текст и неожиданный ответ направляйте к повторному выбору либо сотруднику, а не в бесконечный цикл.

5. Проверьте тексты, кнопки и данные

Текст сообщения в проекте ограничен 4000 символами и поддерживает markdown или HTML. Для обычного шага достаточно нескольких строк. Ссылки, переносы и выделения проверяйте в приложении MAX, поскольку предпросмотр конструктора не показывает все особенности телефона.

Медиа добавляйте только для решения задачи. Фото и видео можно объединить в группу до 12 элементов. Файл или аудио отправляются отдельно и не смешиваются в одном сообщении с фото и видео. Если нужны PDF и ролик, разделите их на два шага.

Проверьте, куда попадают собранные данные. Телефон, email, выбранная услуга и время записи должны относиться к нужному контакту. Если используется вебхук, заранее согласуйте поля и обработку ошибки на стороне CRM.

6. Пройдите тест и запустите малый трафик

Тестируйте с другого аккаунта и начинайте с чистого диалога. Сначала пройдите правильный путь, затем выберите другую ветку, введите неожиданный текст, откажитесь от контакта и попросите оператора. После каждого прохода проверяйте диалоги, аудиторию, уведомления и внешнюю систему.

1. Старт срабатывает один раз.
2. Кнопки ведут в нужные ветки.
3. Ссылки открываются на телефоне.
4. Заявка видна менеджеру.
5. Все конечные ветки завершаются.
6. Пользователь знает, когда ждать ответ.

После теста активируйте воронку и разместите ссылку в одном контролируемом источнике. Первые дни смотрите, где люди выходят, какие вопросы задают и как быстро отвечает команда. После любого изменения снова проходите основной маршрут.

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