MAX Bot APIMAX · 4 мин

Как подключить чат-бота к MAX: персональный бот, платформенный режим и проверка запуска

Полная инструкция по интеграции с MAX: создание или выбор бота, подключение токена, запуск через deep link и контроль первого ответа в живом чате.

Открыть полное руководство

Когда использовать

Материал рассчитан на запуск с нуля: можно переслать клиенту или редактору статьи без дополнительных пояснений и внутренних ссылок.

Что подготовить до подключения

У вас уже создан чат-бот внутри AI Chatbot Platform и сохранены его основные настройки.
Для персонального режима нужен token существующего MAX-бота.
Для платформенного режима достаточно, чтобы общий бот продукта был настроен администратором платформы.

Пошаговая инструкция

1. Определите сценарий запуска

Персональный MAX-бот нужен, если вы хотите собственное имя, отдельный token и независимое продвижение канала.
Платформенный бот подходит для быстрого старта: пользователь открывает общий бот продукта и попадает сразу в нужный чат-бот по start payload.
Если запускаете персональный режим, заранее подготовьте понятное имя и публичный username.

2. Откройте вкладку MAX в настройках интеграций

Перейдите в проект, выберите чат-бота и откройте раздел «Интеграции».
Нажмите вкладку MAX.
Выберите режим подключения без удаления существующей интеграции.

3. Подключите MAX-канал

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

4. Проверьте вход в чат

Откройте ссылку «Открыть в MAX» и убедитесь, что диалог запускается именно для текущего чат-бота.
Если приложение не открыло deep link автоматически, используйте резервную start-команду из интерфейса.
Отправьте первое сообщение и дождитесь ответа ассистента прямо в MAX.

5. Проверьте боевое поведение

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

Чек-лист после запуска

Открытие в MAX ведёт в правильный чат и не требует ручного поиска бота.
Ответ ассистента приходит без финального дубля после стриминга.
Чат и сообщения отображаются в платформе у нужного проекта и чат-бота.

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

Нужен ли token в платформенном режиме?

Нет. В платформенном режиме используется общий MAX-бот продукта, а переход в конкретный чат-бот выполняется через start payload и служебную ссылку открытия.

Что проверять первым, если MAX-бот не отвечает?

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