Интеграция с MAX

Интеграция Wikilect с MAX позволяет создать AI-бот для мессенджера MAX на основе вашего AI-консультанта. Это даёт возможность пользователям взаимодействовать с вашим ботом через чат MAX.

Настройка интеграции с MAX

Шаг 1: Создание бота в MAX

Перед настройкой интеграции в Wikilect необходимо создать бота в MAX:

1. Откройте business.max.ru/self
2. Перейдите в раздел Чат-боты
3. Создайте нового бота: задайте название, описание и прочие параметры
4. В разделе Чат-боты → Интеграция нажмите Получить токен и скопируйте Access Token

Шаг 2: Настройка интеграции в Wikilect

1. Перейдите в раздел Настройки → Консультанты
2. Выберите навык, для которого хотите настроить интеграцию с MAX
3. На вкладке Интеграции выберите MAX
4. Заполните необходимые поля:

Поля интеграции

• Название — имя интеграции для отображения в системе
• Access Token — токен, полученный на шаге 1
• API Token — уникальный идентификатор вебхука (генерируется автоматически). Используется как часть URL вебхука: /api/bots/max_bot/webhook/{api_token}
• Webhook Secret — опционально, секрет для проверки подлинности запросов от MAX (X-Max-Bot-Api-Secret). Рекомендуется задать для безопасности
• Приветственное сообщение — текст, отправляемый при начале нового диалога (по умолчанию: Привет! Чем могу помочь?)

5 Сохраните интеграцию. Wikilect автоматически зарегистрирует вебхук в MAX.

Шаг 3: Проверка подключения

После сохранения интеграции убедитесь, что:

1. MAX успешно принял URL вебхука (отсутствуют ошибки при сохранении)
2. Бот отвечает на тестовое сообщение в мессенджере MAX

Возможности интеграции с MAX

Автоматические ответы на сообщения

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

Обработка команд

Бот поддерживает следующие команды для управления диалогом:

• /start или начать — начало нового диалога с ботом
• bot_started — событие первого запуска бота пользователем (обрабатывается автоматически)
• Любое другое сообщение обрабатывается AI-консультантом

Индикатор набора текста

Во время генерации ответа бот показывает пользователю индикатор "печатает...", создавая более естественное ощущение общения.

Панель управления чатами

В личном кабинете Wikilect в разделе Внешние консультанты вы можете управлять чатами MAX-бота:

• Просматривать историю сообщений
• Отвечать пользователям вручную (отключив автоответы)
• Видеть информацию о пользователях MAX
• Просматривать статистику использования бота

Переключение между ботом и оператором

Функция "отвечает AI консультант" позволяет при необходимости отключить автоматические ответы и перейти на ручное общение с пользователем:

1. В чате с пользователем выключите переключатель "отвечает AI консультант"
2. Теперь вы можете отвечать пользователю напрямую из интерфейса Wikilect
3. Пользователь не будет знать, что общается с оператором, а не с ботом

Использование плагинов с MAX-ботом

Плагины Wikilect работают в интеграции с MAX:

• Вызов менеджера — переключение на живого оператора при определённых условиях
• Поисковик по контексту — использование базы знаний для ответов
• API и другие плагины для расширения функциональности

Рекомендации по использованию MAX-бота

1. Оперативные ответы — пользователи ожидают быстрых ответов, настройте систему для минимальной задержки
2. Понятные ответы — используйте простой и понятный язык
3. Доступность — обеспечьте работу бота 24/7
4. Безопасность — всегда задавайте Webhook Secret для защиты вебхука
5. Тестирование — регулярно тестируйте бота с различными сценариями использования
6. Мониторинг — следите за статистикой и качеством ответов бота

Решение проблем

Бот не получает сообщения

1. Убедитесь, что URL вебхука доступен по HTTPS на порту 443
2. Проверьте, что используется сертификат от доверенного центра (не самоподписанный)
3. Убедитесь, что access_token актуален и не отозван
4. Проверьте, что api_token в URL совпадает с сохранённым в интеграции

Ошибка проверки секрета

1. Убедитесь, что webhook_secret в Wikilect совпадает с тем, что было передано в MAX при регистрации вебхука
2. Если вы изменили секрет, необходимо пересоздать вебхук — сохраните интеграцию заново

Бот не отвечает на сообщения

1. Проверьте, что навык активен и правильно настроен
2. Убедитесь, что у тенанта активна подписка (статус не EXPIRED)
3. Проверьте логи на наличие ошибок в обработке сообщений

Бот отвечает только на первое сообщение

Убедитесь, что переключатель "отвечает AI консультант" включён в панели управления чатами.