Публикация

MAX в Битрикс24: приёмка сообщений и PDF

MAX и открытые линии: контур на 20 аккаунтов, ответы менеджера, проверка PDF и восстановление без повторных отправок.

Мессенджеры и CRM 4 мин
Проверка маршрута MAX — открытая линия — ответ менеджера

Сообщение появилось в CRM — это только начало проверки интеграции. Нужно убедиться, что ответ уйдёт с нужного аккаунта, PDF останется читаемым, а перезапуск не отправит клиенту старые сообщения ещё раз.

Контур объединяет 20 обычных аккаунтов MAX. 22 октября KMVSG проверил выделенный пилотный маршрут с открытыми линиями Битрикс24 на согласованной паре аккаунтов. Рассказываем о подтверждённом маршруте и о том, какие сценарии ещё требуют приёмки.

Проверенный пилот

От сообщения до подтверждённого ответа

  1. 01Аккаунт
  2. 02Диалог
  3. 03Ответ
  4. 04Сверка
  • Аккаунт и внешний диалог определяют маршрут в CRM.
  • PDF сверяется после получения с другой стороны.
  • Перезапуск проверяется по отсутствию новых отправок.

Разделите аккаунты до импорта диалогов

В пилоте созданы раздельные открытые линии с одним согласованным оператором. Личные и групповые диалоги получили собственные привязки. Даже два представления одной группы сохранили принадлежность к исходному аккаунту.

Название чата помогает человеку ориентироваться, но для маршрутизации нужны устойчивые идентификаторы аккаунта и диалога. Это позволяет ответить из правильной учётной записи при совпадающих именах собеседников. Рабочие линии компании в этом испытании не перенастраивались.

Проверьте настоящий ответ менеджера из открытой линии

Документация Битрикс24 описывает пользовательский коннектор открытых линий: внешнее сообщение передаётся с данными отправителя и чата, а приложение получает идентификаторы созданного диалога. Для приёмки дополнительно нужен обратный путь из обычного интерфейса менеджера.

В согласованной паре проверены реальный текст из MAX и ответ из Битрикс24. Ответ зарегистрирован другим MAX-аккаунтом ровно один раз. Отдельно сверены настоящие события доставки и прочтения. Прочтение диалога не используется как доказательство просмотра содержимого PDF.

Скачайте PDF с обеих сторон

Появление значка вложения подтверждает лишь наличие сообщения с файлом. В нашем тесте PDF прошёл из MAX в Диск Битрикс24 и обратно из штатного интерфейса CRM в MAX. Полученные байты прочитали на стороне назначения и сравнили контрольные суммы SHA-256 с исходником.

Совпадение подтвердило сохранность конкретного тестового PDF в обоих направлениях. Проверка небольшого документа не определяет допустимый размер любого вложения и ничего не говорит о воспроизведении голосовых или видео.

Повторите запуск без повторной переписки

Шлюз хранит связь исходного события, операции отправки и результата. Если ответ внешней системы потерян, повторять отправку вслепую нельзя: сначала нужно установить, выполнилась ли первая операция.

После перезапуска и повторного чтения сохранённых событий число MAX-операций проверяемых аккаунтов не изменилось. Восстановление истории отметок прочтения также не создало новых сообщений. Эта проверка закрывает конкретный сценарий повторной обработки; длительная эксплуатация оценивается отдельно.

Разделите живой пилот и испытание крупных медиа

Для маршрута Битрикс24 подтверждены текст, PDF, принадлежность исходным аккаунтам и события доставки. Фото, аудио, видео, редактирование, удаление и первый исходящий новому контакту в его живую приёмку не входили. Использован технический шлюз для обычных аккаунтов MAX; его совместимость и сопровождение нужно отдельно оценивать перед внедрением.

В другом изолированном стенде с тестовым внешним каналом проверялись медиа до 50 МиБ и плееры Chatwoot. Этот результат нельзя переносить на реальный MAX или считать проверкой тех же файлов в Битрикс24. Автозапуск пилотного маршрута после перезагрузки сервера и производственный SLA также требуют отдельного согласования.

Короткий чек-лист

  • Выбрать согласованную пару тестовых аккаунтов
  • Проверить принадлежность каждого диалога
  • Отправить ответ из обычного интерфейса CRM
  • Скачать PDF на стороне назначения и сверить SHA-256
  • Проверить восстановление без новых отправок
  • Отдельно принять медиа, права команды и эксплуатационный режим

Ссылки и исходный код