# Подключение MAX Bot

Как подключить официального бота MAX к ChatRex по токену, активировать канал и проверить сообщения.

Прямая интеграция MAX Bot передаёт в ChatRex сообщения официального бота MAX и отправляет ответы ChatRex в тот же диалог. Канал работает в личных и групповых чатах.

MAX Bot и MAX по QR-коду — разные интеграции. Выберите MAX Bot, если бот создан на платформе MAX для партнёров и у вас есть его токен.

# Перед подключением

Подготовьте:

  • аккаунт ChatRex;
  • созданного и прошедшего модерацию бота MAX;
  • токен этого бота;
  • активную подписку ChatRex со свободным местом для канала.

Создание ботов на платформе MAX для партнёров доступно организациям, ИП и самозанятым — резидентам РФ. У профиля должен быть пройден процесс верификации.

# Получение токена MAX

  1. Откройте платформу MAX для партнёров и перейдите в раздел Чат-боты.
  2. Выберите нужного бота.
  3. Откройте Расширенные настройки → Настроить.
  4. Скопируйте значение поля Токен.

Токен появляется после успешной модерации бота. Подробный порядок создания и настройки приведён в официальной документации MAX.

# Подключение в ChatRex

  1. Откройте Интеграции.
  2. Нажмите Подключить интеграцию.
  3. На вкладке Каналы найдите MAX Bot и нажмите Подключить.
MAX и MAX Bot в каталоге каналов ChatRex
  1. В поле Токен бота MAX вставьте токен.
  2. Нажмите Подключить.
  3. Убедитесь, что в списке интеграций для MAX Bot отображается статус Подключено.

ChatRex проверит токен, определит бота и автоматически настроит получение новых сообщений. Настраивать webhook вручную не требуется.

# Активация подписки

MAX Bot считается отдельным типом канала и занимает одно место в подписке. Место, используемое интеграцией MAX по QR-коду, на MAX Bot не распространяется.

Если подписка неактивна:

  1. Добавьте MAX Bot в подписку.
  2. Проверьте доступное количество каналов.
  3. Убедитесь, что статус подписки изменился на активный.

# Назначение канала боту

  1. Откройте Мои боты и нажмите Изменить напротив нужного бота.
  2. Перейдите во вкладку Каналы и запуск.
  3. В блоке Условия по каналам нажмите Добавить канал.
  4. Выберите подключённый MAX Bot.
  5. При необходимости настройте условия и рабочее время.
  6. Сохраните изменения.
Добавление канала во вкладке Каналы и запуск

# Проверка

  1. Откройте подключённого бота в MAX.
  2. Отправьте ему тестовое текстовое сообщение.
  3. Дождитесь ответа ChatRex в том же диалоге.
  4. Откройте Историю или Чаты в ChatRex и найдите тестовый диалог.
  5. При необходимости повторите проверку в групповом чате, в который добавлен бот MAX.

В первой версии интеграция обрабатывает текстовые сообщения. События, содержащие только вложение без текста, не передаются боту ChatRex.

Если ответа нет, проверьте:

  • действителен ли токен и принадлежит ли он боту MAX;
  • подключён ли MAX Bot к активной подписке;
  • назначен ли канал нужному боту ChatRex;
  • подходят ли время и другие условия запуска;
  • добавлен ли бот MAX в групповой чат, если проверяется группа;
  • достаточно ли средств на балансе ChatRex.

# Замена токена и отключение

Если токен был обновлён или отозван, откройте Настроить у существующей интеграции MAX Bot, отключите соединение и подключите его повторно с новым токеном.

После отключения ChatRex перестаёт принимать новые сообщения этого бота и отправлять ответы. Токен хранится на сервере ChatRex в зашифрованном виде и не передаётся боту ChatRex или в текст диалога.