+7 (961) 805-51-93ТелеграмMAXОставить заявку
К описанию приложения
Установка

Установка: Интеграция с МАКС

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

Установка и настройка

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

  • Права администратора Битрикс24.
  • Токен бота MAX из личного кабинета MAX.
  • Портал, доступный извне по HTTPS с доверенным сертификатом: MAX принимает события только так.
  • Для коробочного Битрикс24 — обновления модулей «Мгновенные сообщения» 26.250.0 и «Чат-боты Битрикс24» 26.50.0.

Шаг 1. Установите приложение

Установите приложение из Маркета Битрикс24 и откройте его. На главной странице два раздела — «Открытые линии» и «Чат-бот». Настраивать нужно только тот канал, которым будете пользоваться.

Шаг 2. Добавьте бота MAX

Общий шаг для обоих каналов.

  1. Нажмите «Добавить бота MAX».
  2. Укажите имя — оно нужно только для интерфейса — и вставьте токен из личного кабинета MAX.
  3. Сохраните. В списке должно появиться состояние «вебхук подключён». Если появилась «ошибка», рядом будет её текст; после устранения причины нажмите переподписку.
  4. Добавьте бота в нужный чат MAX. Чат появится в списке для выбора автоматически.

Шаг 3а. Если нужен канал открытых линий

  1. Нажмите «Зарегистрировать коннектор». Приложение не ставит коннектор при установке: он нужен только этому каналу.
  2. Выберите открытую линию портала и нажмите «Подключить линию» — коннектор активируется на ней автоматически.
  3. Нажмите «Добавить связку» и выберите бота MAX и линию. Оставьте поле «Чат MAX» пустым, чтобы в линию шли все чаты бота (каждый станет отдельным обращением), либо выберите конкретный чат.
  4. Сохраните.

Шаг 3б. Если нужен канал чат-бота

  1. Нажмите «Создать бота» и укажите его имя.
  2. Добавьте созданного бота в нужный чат Битрикс24.
  3. Нажмите «Добавить связку», выберите бота MAX, чат-бота, чат Битрикс24 (можно найти поиском или ввести идентификатор вручную), затем укажите чат MAX.
  4. Сохраните.

Шаг 4. Проверьте

Напишите тестовое сообщение с одной стороны и убедитесь, что оно пришло с другой. Затем ответьте обратно.

Настройки связки

На каждой связке отдельно включаются:

  • направления передачи — можно оставить только одно;
  • передача вложений;
  • перенос правок сообщений и режим их отображения;
  • подпись сообщений именем автора;
  • пометка сообщений из MAX префиксом в чате Битрикс24;
  • временное отключение связки без удаления настроек.

Если что-то не работает

Симптом Что проверить
У бота MAX состояние «ошибка» Текст ошибки рядом со статусом; адрес портала должен быть доступен извне по HTTPS с доверенным сертификатом
Сообщения из MAX не приходят Бот добавлен в чат MAX; связка активна и включено направление «из MAX в Битрикс24»
Оператор отвечает, а в MAX ничего Линия подключена в приложении, связка активна, включено направление «из Битрикс24 в MAX»
Не удаётся удалить бота MAX На него ссылается связка — сначала удалите связку
Не удаётся снять коннектор Подключена открытая линия — сначала отключите её
Бот не может написать пользователю MAX Ограничение мессенджера: в личном диалоге первым должен написать пользователь