MAX Messenger#

MAX — мессенджер, который можно подключить к APX Chat как ещё один канал общения. Обращения пользователей попадают в общее окно «Диалоги» рядом с остальными каналами.

Что понадобится#

• Для личного аккаунта — MAX на телефоне и доступ к сканеру QR-кода.
• Для бота — его токен, полученный на стороне MAX.

Личный аккаунт MAX Personal

Этот способ подключает существующий личный аккаунт. Для авторизации используется QR-код, а не токен бота.

1. Добавьте личный аккаунт

   В Управление → Каналы связи нажмите «Добавить канал» и выберите MAX Personal. Начните авторизацию: APX покажет QR-код.

2. Подтвердите сеанс в MAX

   На телефоне откройте Настройки → Устройства → Сканировать QR-код и отсканируйте код из APX. Если аккаунт запросит дополнительный пароль, введите его для текущей проверки. Пароль не сохраняется.

3. Назначьте сотрудников и проверьте ответ

   Укажите название канала, выберите сотрудников и завершите подключение. Получите новое сообщение от клиента и ответьте ему из раздела «Диалоги». Для работы канала нужна активная связанная сессия MAX.

Сценарии конструктора предназначены для MAX Bot; в личном аккаунте они не запускаются.

Бот MAX

Этот способ подключает отдельного бота по его токену. Клиент начинает общение с ботом, после чего сотрудники отвечают из APX.

1. Добавьте канал

   В Управление → Каналы связи нажмите «Добавить канал» и выберите MAX Messenger.

2. Введите токен бота

   Укажите название канала и вставьте токен бота, полученный на стороне MAX.

3. Назначьте сотрудников и завершите

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

После подключения#

• Все сообщения из MAX собираются в едином окне «Диалоги».
• На канал можно включить AI-оператора.
• Сценарии конструктора работают в боте MAX. В личном аккаунте MAX чат-бота нет.
• Подключение, как и у других каналов APX Chat, бесплатное.

Чат-бот в MAX#

• Запуск. Кнопка «Начать» работает как команда /start. Если клиент пришёл по ссылке max.ru/ваш_бот?start=метка, метка попадает в переменную {{start_param}} — как в Telegram.
• Триггеры: команда, ключевое слово, inline-кнопка, любое сообщение, webhook и расписание.
• Кнопки приходят под сообщением. Блока «Меню» (нижней клавиатуры) в MAX нет, запроса геолокации — тоже.
• Опрос приходит текстом со списком вариантов — проголосовать нельзя.
• «Печатает…» бот показывает, пока готовит ответ.
• Действия с группой из личного диалога: добавить в чат, исключить, закрепить сообщение. Закреп работает только в группе или канале, где бот — администратор: в личном диалоге MAX закреплять не даёт.

Группы#

Сообщения групп MAX, где состоит бот или аккаунт, приходят в «Диалоги» одним диалогом: у каждого сообщения видно имя автора, ответ сотрудника уходит в группу. Сценарий чат-бота в группах не запускается — по сценарию бот отвечает только в личном диалоге. AI-оператор отвечает в группе, только если на канале включено «Отвечать в групповых чатах».