Содержание
После установки Green MAX подключается без командной строки. Вы создаёте чат-бота в MAX, копируете один токен и вставляете его в LEVBOT DEPLOY. Адрес webhook, секрет, подписку и серверную настройку DEPLOY делает сам.
Важно: токен MAX - секрет, почти как пароль. Не отправляйте его в чат, не публикуйте на скриншотах и не вставляйте на сайт.
Что понадобится
- подтверждённый профиль в MAX;
- созданный чат-бот MAX;
- установленный или готовый к установке Green;
- LEVBOT DEPLOY;
- доступ по SSH к серверу Green.
Шаг 1. Откройте MAX для бизнеса
В мобильном приложении MAX откройте настройки профиля и выберите «MAX для бизнеса».
Шаг 2. Пройдите верификацию
Чат-бот можно создать после подтверждения профиля. Нажмите «Пройти верификацию» и заполните данные, которые запросит MAX.
Проверка может завершиться не сразу. Когда появится сообщение «Верификация пройдена», нажмите «Создать чат-бот».
Шаг 3. Создайте чат-бота
Заполните карточку:
- название бота;
- ник;
- телефон и сайт - при необходимости;
- короткое описание.
Нажмите «Создать».
После создания откройте данные бота и перейдите в «Расширенные настройки».
Шаг 4. Скопируйте токен
В разделе «Расширенные настройки» найдите поле «Токен доступа» и нажмите кнопку копирования.
Переключатель «Добавление в групповые чаты» для обычного сценария можно оставить выключенным. Тогда Green будет работать в личном диалоге с клиентом.
Шаг 5. Вставьте токен в LEVBOT DEPLOY
Откройте LEVBOT DEPLOY:
- Включите «Подключить MAX».
- Вставьте токен в поле «Токен бота».
- Нажмите «Проверить».
DEPLOY должен показать, что токен работает и бот найден.
Для нового Green
Заполните обычные данные сервера и модели, затем нажмите «Запустить Льва». MAX подключится в ходе установки.
Для уже работающего Green
Введите SSH-доступ к серверу и нажмите «Перенастроить Льва». Повторно вводить Yandex API Key и Folder ID не требуется, если они уже сохранены на сервере.
Что DEPLOY делает автоматически
Пользователю не нужно вручную создавать webhook или выполнять команды. DEPLOY сам:
- проверяет токен и находит бота;
- создаёт защищённый адрес
/maxна техническом домене Green; - генерирует секрет webhook;
- добавляет серверный обработчик MAX;
- настраивает nginx;
- создаёт или обновляет подписку MAX;
- перезапускает Green;
- проверяет подключение.
Шаг 6. Проверьте работу
Откройте созданного бота в MAX и отправьте сообщение, например:
Привет, это проверка LEVBOT
Green должен ответить в том же диалоге. Затем отправьте второй вопрос, чтобы проверить продолжение контекста. Для проверки зрения можно отправить фотографию.
Если не работает
DEPLOY пишет «Неверный токен». Скопируйте токен заново без пробелов. При необходимости сгенерируйте новый токен в расширенных настройках MAX.
Токен проверен, но бот молчит. Нажмите «Перенастроить Льва» и дождитесь статуса успешного подключения MAX.
Токен попал на публичный скриншот или в переписку. Немедленно обновите токен кнопкой со стрелками в MAX, затем вставьте новый токен в DEPLOY и повторно перенастройте Green.
Бот не отвечает в группе. Базовый режим LEVBOT рассчитан на личные диалоги. Групповой режим включается и настраивается отдельно.
Коротко
MAX для бизнеса
→ пройти верификацию
→ создать чат-бота
→ скопировать токен
→ вставить токен в DEPLOY
→ Проверить
→ Запустить Льва / Перенастроить Льва
→ отправить тестовое сообщение
После этого Green работает в MAX на том же ядре, что публичный чат, виджет, Telegram и Bitrix24.