Как подключить бота MAX к Chatix

Для подключения MAX к Chatix нужен проверенный чат-бот и его токен. Бот создаётся на платформе MAX для партнёров, проходит модерацию, а затем подключается к AI-агенту Chatix одним секретом. Chatix сам проверяет токен и регистрирует webhook — отдельный сервер и ручная настройка API не нужны.

Текущая реализация канала предназначена для текстовых обращений в личном диалоге пользователя с ботом. Групповые сообщения и вложения без текста агент не обрабатывает.

Что потребуется#

Перед началом подготовьте:

• верифицированный профиль организации, ИП или самозанятого в MAX;
• доступ к платформе MAX для партнёров;
• созданный и прошедший модерацию чат-бот;
• AI-агент Chatix с актуальной базой знаний;
• права на подключение каналов в рабочем пространстве Chatix.

По актуальной справке MAX создать чат-бота можно только для верифицированного бизнес-профиля. Проверка и модерация происходят на стороне MAX, а не Chatix.

1. Создайте профиль на платформе MAX#

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

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

2. Создайте и отправьте бота на модерацию#

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

До завершения модерации расширенные настройки и рабочий токен могут быть недоступны. Не пытайтесь подключать к Chatix черновой секрет или данные от другого бота.

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

3. Получите токен MAX-бота#

После модерации откройте:

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

Скопируйте токен полностью. Это секрет авторизации API, а не публичный username бота. Не вставляйте его в статью, скриншот, задачу или общедоступный документ.

Если токен раскрыт посторонним, обновите его в MAX и переподключите канал. Chatix хранит переданный токен в зашифрованном виде и не возвращает его в открытом виде через публичные данные канала.

4. Подключите MAX в Chatix#

Откройте нужного агента Chatix и перейдите в раздел Каналы. На карточке MAX нажмите Подключить.

Вставьте токен в поле Bot token и нажмите Подключить. Chatix выполнит четыре действия:

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

MAX принимает webhook только по публичному HTTPS-адресу на стандартном защищённом порту. Это серверная настройка Chatix: пользователю не нужно вводить URL webhook или секрет вручную.

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

5. Проверьте личный диалог#

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

Проверьте точность фактов и появление нового диалога в helpdesk Chatix. Если ответ не найден, используйте гайд по диагностике базы знаний.

Ограничения текущего канала MAX#

Chatix принимает текст новых сообщений из личного диалога. Ответ длиннее лимита одного сообщения автоматически разбивается на части. Канал соблюдает ограничение MAX по частоте API-запросов и повторно не обрабатывает одно и то же входящее событие.

Сейчас важно учитывать:

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

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

Как обновить или отключить подключение#

При смене токена переподключите MAX-канал. Если нужно временно остановить автоматические ответы, отключите канал в Chatix. При удалении подключения Chatix снимает зарегистрированную webhook-подписку, но не удаляет самого бота из кабинета MAX.

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

Чек-лист перед запуском#

• Профиль организации, ИП или самозанятого верифицирован.
• Бот прошёл модерацию MAX.
• Токен скопирован из расширенных настроек нужного бота.
• Chatix показал успешное подключение канала.
• Тест выполнен в личном диалоге на типовых вопросах клиентов.
• Команда знает, что группы и вложения без текста пока не обрабатываются.
• База знаний агента проверена и не содержит противоречий.

Возможности канала также описаны на странице AI-бота MAX в Chatix. Для дополнительного канала используйте тот же опубликованный агент: повторно загружать источники не требуется.