Коротко: Готовых интеграций 1С с мессенджером MAX нет, поэтому обмен приходится строить напрямую через API MAX. Мы разработали универсальный коннектор: он создаёт бота и получает токен, разбирает JSON потоком, учитывает маркеры пагинации и время в миллисекундах, поддерживает HTML-форматирование и inline-клавиатуры. Коннектор работает на любой конфигурации, с БСП и без неё.
Задача клиента
У клиента был Telegram-бот, который присылал уведомления о критичных событиях из 1С. По корпоративной политике импортозамещения компания переходит на российский мессенджер MAX, а для пользователей внутри ИТ-периметра компании Telegram заблокирован.
MAX стал официальным каналом связи, но готовых интеграций 1С → MAX нет. Команда клиента тратила часы на разбор API, потому что документация MAX скудная и почти всё приходилось выяснять экспериментами.
С чем пришлось разбираться
- нюансы JSON-структур в ответах API;
- обработка маркеров пагинации;
- перенос строк через
\n; - время в timestamp, указанное в миллисекундах.
Что мы сделали
Мы разработали готовый коннектор, который связывает 1С с MAX через API. Он умеет:
- создавать бота в MAX и получать токен;
- читать JSON через поток, что быстрее разбора ответа целиком;
- корректно работать с маркерами пагинации: значение
marker = -1приводится к 0; - переводить время из миллисекунд в локальное;
- форматировать сообщения в HTML, в том числе многострочные;
- показывать клавиатуры (inline keyboard) для интерактивных сценариев;
- работать на медленных соединениях за счёт увеличенных таймаутов.
Коннектор универсальный и работает на любой конфигурации 1С, с БСП и без неё.
Результат
- Уведомления из 1С приходят в MAX корректно и быстро.
- Коммуникации перевели на отечественный мессенджер без потери функциональности.
- Боты для согласований, оповещений и бизнес-процессов работают в MAX.
- Команде клиента не пришлось тратить недели на разбор API.
Частые вопросы
Есть ли готовая интеграция 1С с мессенджером MAX?
Готовых интеграций 1С → MAX нет. Обмен нужно строить через API MAX, документация к которому скудная, так что многие детали приходится выяснять экспериментально.
С какими сложностями сталкиваются при работе с API MAX из 1С?
Основные сложности — нюансы JSON-структур, обработка маркеров пагинации, перенос строк через \n и время в timestamp с миллисекундами. В коннекторе маркер со значением -1 приводится к 0, а время из миллисекунд переводится в локальное.
На каких конфигурациях 1С работает коннектор к MAX?
Коннектор универсальный и работает на любой конфигурации, с БСП и без неё. Через него можно делать ботов для согласований, оповещений и бизнес-процессов.