Бот в мессенджере MAX
Кроме виджета на сайте ассистента можно подключить к мессенджеру MAX (max.ru): вы создаёте бота, вставляете его токен в кабинет — и клиенты общаются с вашей базой знаний прямо в мессенджере.
Подготовка бота
- Зайдите на платформу MAX для партнёров (dev.max.ru) в раздел «Чат-боты» и создайте бота.
- После модерации откройте бота: ⋮ → Настройки и нажмите значок копирования справа от поля с токеном.
- Скопируйте токен — он понадобится в кабинете.
Подключение в кабинете
- В шапке чата нажмите «🤖 MAX-бот».
- Вставьте токен в поле и нажмите «💾 Сохранить и подключить».
- Система проверит токен в MAX, покажет имя бота и подключит доставку сообщений. Статусная строка покажет: имя бота, режим доставки, сколько ответов дано сегодня и всего.
Если кнопка сообщает, что MAX не принял вебхук — бот всё равно работает, но в резервном режиме опроса. Вебхук требует публичного HTTPS-адреса на порту 443; напишите в поддержку сервиса, и режим переключат на основной.
Настройки
| Поле | Что делает |
|---|---|
| Токен бота | Ключ доступа бота из «MAX для партнёров». Поле показано маской — нажмите 👁, чтобы увидеть, и замените значение при необходимости |
| Дневной лимит ответов | Максимум ответов всем собеседникам за сутки — защита от перерасхода вашего LLM-ключа |
| Бот отвечает собеседникам | Выключатель: бот перестаёт отвечать, подключение сохраняется |
| Приветствие собеседнику | Текст, который человек получает при старте бота. Пусто — берётся общее приветствие (окно «📝 Мой промт»), а если и его нет — приветствие из роли в промте |
| Отключить | Убирает подключение: MAX перестаёт слать события, токен удаляется из системы |
Приветствие
Когда человек запускает бота и пишет ему первое сообщение, бот здоровается. Текст берётся так:
- Своё приветствие бота — поле «Приветствие собеседнику» в панели «🤖 MAX-бот».
- Общее приветствие аккаунта — окно «📝 Мой промт» в шапке чата: одна фраза сразу для всех виджетов и для MAX-бота.
- Если нигде не задано — бот представляется ролью из вашего персонального промта.
Приветствие приходит один раз — когда человек запускает бота. Если диалог у него уже был (MAX повторно событие запуска не присылает), проверьте текст командой /new: бот начнёт новый диалог без прежнего контекста и поздоровается тем же приветствием. Так же работают «/новый», «/начать» и «начать заново».
Ссылка для клиентов
В кабинете показана ссылка вида https://max.ru/ваш_бот — её можно отправлять клиентам, разместить в шапке сайта, в подписи письма или в QR-коде на витрине. Отдельно ставить что-то на сайт не нужно: человек открывает ссылку в MAX и пишет боту как обычному контакту.
Что видит и что не видит собеседник
- ✅ Ответы из вашей базы знаний в личном диалоге с ботом.
- ✅ Приветствие — своё у этого бота, общее для всех каналов или собранное из вашего персонального промта: бот «говорит голосом компании».
- ❌ Ссылок на файлы-источники собеседник не видит — они остаются только в вашем основном чате.
- Все вопросы из MAX попадают к вам в 📊 Аналитику вместе с вопросами из чата и виджета.
Безопасность
- Токен хранится в защищённом хранилище кабинета (в базе данных), а не в файлах проекта; в интерфейсе он показан маской.
- На канал действуют лимиты: не более 10 сообщений в минуту от одного собеседника и дневной лимит на весь канал.
- Переписка каждого собеседника изолирована: люди не видят переписку друг друга, и она не смешивается с вашим основным чатом.
- Приём событий подписан секретом: посторонний не может подделать сообщение боту.
Ответы вручную
Бот не обязан отвечать всегда: возьмите разговор на себя в разделе «📥 Диалоги» — собеседник получит ответ от менеджера прямо в мессенджере, а бот в этом диалоге замолчит. Там же видно, кто ждёт ответа. Подробно: Диалоги и ответы вручную.
Частые вопросы
Подключил бота, но он не отвечает. Проверьте статусную строку в панели: если стоит резервный режим опроса — напишите в поддержку, включим вебхук. Также убедитесь, что переключатель «Бот отвечает собеседникам» включён и дневной лимит не исчерпан.
Бот отвечает, но не на все вопросы. Проверьте, есть ли тема в вашей базе знаний: ассистент не выдумывает ответы, а ищет в загруженных документах. Полезные темы пополняйте в разделе «📄 Мои документы».
Хочу отключить бота. В панели есть две возможности: снять галку «Бот отвечает собеседникам» (пауза, всё настраивается обратно одним кликом) или нажать «Отключить» (полное удаление подключения).
Можно подключить нескольких ботов? Нет: один аккаунт — один бот MAX. Если нужен второй бот, зарегистрируйте для него отдельный аккаунт сервиса.