MAX Messenger канал

Кратко

Интеграция с MAX Messenger позволяет принимать и отправлять сообщения клиентам через бота в MAX. Работает по аналогии с Telegram: входящие сообщения создают заявки, ответы операторов доставляются через бота. Поддерживаются текстовые сообщения, фотографии и документы. Помимо личных сообщений, MAX и Telegram можно подключить и как виджет чата на сайт — см. Чат на сайт через Telegram и MAX.

Кто имеет доступ

Где найти

Настройка: Настройки -- Интеграции -- карточка MAX. Число ботов MAX ограничено тарифом: Free -- 1, Starter -- 2, Pro -- 3, Business -- 5, Enterprise -- без ограничения. Обзор всех доступных каналов поддержки — в статье Каналы технической поддержки клиентов.

Использование: входящие сообщения из MAX отображаются в чате заявки с пометкой канала.

Как работает

Архитектура интеграции

Платформа работает с MAX Messenger через MAX Bot API. Принцип работы:

1. Клиент отправляет сообщение боту в MAX Messenger
2. MAX Bot API доставляет обновление через вебхук на платформу
3. Платформа создаёт заявку или добавляет сообщение к существующей
4. Оператор отвечает в чате заявки
5. Платформа отправляет ответ через MAX Bot API
6. Клиент получает ответ от бота в MAX

Входящие сообщения

При получении сообщения от пользователя MAX:

• Новый пользователь (MAX ID не найден): создаётся контакт и новая заявка
• Существующий пользователь с открытой заявкой: сообщение добавляется к заявке
• Существующий пользователь без открытых заявок: создаётся новая заявка

Данные контакта заполняются из профиля MAX (имя, username).

Исходящие сообщения

Ответы оператора автоматически отправляются клиенту через бота MAX. Поддерживается текстовое форматирование.

Поддержка медиафайлов

Настройка

Создание бота в MAX

1. Откройте MAX Messenger
2. Найдите @MasterBot (в настройках есть кнопка «Создать бота в MAX»)
3. Отправьте /newbot и придумайте имя бота
4. Получите токен бота
5. Скопируйте токен

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

1. Перейдите в Настройки -- Интеграции -- MAX
2. Вставьте токен в поле «Токен бота MAX»
3. Нажмите «Подключить»
4. Система автоматически зарегистрирует вебхук в MAX Bot API; после подключения откроется MAX -- нажмите Start для активации
5. Появится надпись «MAX бот подключён и готов к работе»

Настройка профиля бота

После подключения в карточке MAX можно изменить имя бота (кнопка «Сохранить имя»). Аватар и описание бота настраиваются в самом MAX.

Чтобы подключить ещё одного бота, нажмите «Добавить линию». Отключить бота можно кнопкой «Отключить».

Проверка подключения

После настройки отправьте тестовое сообщение боту в MAX. Если всё настроено корректно:

• Сообщение появится в платформе как новая заявка
• Ответ оператора будет доставлен в MAX

Частые вопросы

Чем MAX отличается от Telegram в плане интеграции?

Принцип работы идентичен: бот, вебхуки, создание заявок. Отличается только API-эндпоинт и формат данных. Для пользователей платформы поддержки разницы в функциональности нет. Пошаговая настройка на стороне Telegram описана в статье Настройка Telegram канала — для MAX шаги аналогичны.

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

Проверьте: (1) токен бота корректен, (2) в карточке MAX видна надпись «MAX бот подключён и готов к работе», (3) MAX Bot API доступен. Попробуйте переподключить бота.

MAX Messenger -- что это?

MAX Messenger -- мессенджер со своим Bot API. Интеграция позволяет обслуживать клиентов, которые предпочитают этот мессенджер.

Поддерживаются ли групповые чаты в MAX?

Да, сообщения из групп MAX, где состоит бот, обрабатываются общей логикой групповых чатов, ответ уходит в ту же группу. Об упоминаниях бота MAX не сообщает, поэтому признак упоминания для MAX недоступен.

Связанные статьи

• Telegram канал -- аналогичная интеграция с Telegram
• WhatsApp канал -- интеграция с WhatsApp
• Email канал -- приём заявок по email
• Триггеры автоматизации -- автоматические действия при получении сообщений