+7 (999) 881-15-11

«Арете — сервер мессенджеров, Max edition»

Руководство по установке

Проверьте соответствие конфигурации техническим требованиям

  • Версия платформы 1С:Предприятия 8.3.25 или выше
  • Режим совместимости не установлен или не ниже 8.3.25
  • Управляемые формы
Как узнать режим совместимости?

  • Откройте 1С:Предприятие в режиме конфигуратора
  • Нажмите "Конфигурация" -> "Открыть конфигурацию"
  • Режим совместимости указан в значении свойств "Режим совместимости"
  • Откройте свойства конфигурации
Где находятся свойства конфигурации 1C
Где находятся свойства конфигурации 1C

Что делать если формы "обычные"

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

Проверьте доступность API Max-ботов

Если используется клиент-серверный вариант работы 1С:Предприятия (рекомендуется), то проверять доступность необходимо с рабочей машины сервера 1С:Предприятия. Для файлового варианта работы — с машины, на которой будет запускаться обмен.

  • Откройте командную консоль — CMD, Bash или Powershell
  • Выполните команду:

CMD, Bash
curl -i -X GET "https://platform-api2.max.ru/me" -H "Authorization: {access_token}"

Powershell
Invoke-WebRequest -Uri "https://platform-api2.max.ru/me" -Method Get -Headers @{Authorization = "{access_token}"}

где {access_token} — это ключ вашего бота, выданный ранее в личном кабинете business.max.ru

Пример ключа Max-бота
f9WHodD0cOIYXVjz8UGZWxS_38FqECtDyWJ-Xkftm-L-tswIncoJsGdhJgKj1aHGkuCN8ZMKBrCES-_QRbB2

Если связь установлена, то команда вернёт ответ. Если в ответе содержится код 200, то всё в порядке. Для команды CMD или Bash это будет строка вида "HTTP/1.1 200 OK". Для команды Powershell это будет строка вида "StatusCode: 200". Если ответ возвращает другой код, то связь есть, однако, нужно обратить внимание на код и тело ответа — в них содержится описание ошибки. Если же выполнение команды вообще ничего не вернуло, значит, с этой машины ресурс API Max-ботов недоступен и нужно устранять ошибку на уровне локальной сети и настроек безопасности (вероятно, через системного администратора)

Отдельно стоит ошибка проверки сертификата — сообщение вида unable to get local issuer certificate или SSL certificate problem. Это не сеть: на машине не добавлен корневой сертификат Минцифры, смотрите следующий шаг.

Настройте доверие к сертификату Минцифры

API Max (platform-api2.max.ru) использует SSL-сертификат, выданный УЦ Минцифры. Windows и Linux по умолчанию этому удостоверяющему центру не доверяют — пока его корневой сертификат не добавлен в систему, 1С не сможет подключиться к Max по HTTPS.

На сервере 1С — нужно всегда (GET /updates и Webhook)

1С сама обращается к platform-api2.max.ru при любом способе работы: запрашивает события через GET /updates, регистрирует вебхук через POST /subscriptions, отправляет сообщения. Платформа проверяет сертификаты через хранилище операционной системы, поэтому корневой сертификат Минцифры нужно установить на ту машину, с которой 1С выходит в интернет:

  • клиент-серверная база — на сервер 1С:Предприятия (на рабочие места пользователей и на отдельный веб-сервер ставить не нужно)
  • файловая база — на компьютер, где запускается обмен

Скачайте корневой сертификат Russian Trusted Root CA на сайте Госуслуг (прямая ссылка на файл). Промежуточный сертификат ставить не нужно — сервер Max передаёт его сам.

  • Windows: откройте скачанный файл .crt → «Установить сертификат» → «Локальный компьютер» → «Поместить все сертификаты в следующее хранилище» → «Доверенные корневые центры сертификации». Выбирайте именно «Локальный компьютер», иначе служба сервера 1С сертификат не увидит
  • Linux (Debian, Ubuntu, Astra Linux): скопируйте файл .crt в /usr/local/share/ca-certificates/ и выполните sudo update-ca-certificates

После установки перезапустите службу сервера 1С:Предприятия, чтобы она подхватила обновлённое хранилище. Если вы получаете события опросом (GET /updates), больше ничего с сертификатами делать не нужно.

На веб-сервере — дополнительно для Webhook

При работе через Webhook уже сам Max подключается снаружи к опубликованному HTTP-сервису 1С и проверяет SSL-сертификат вашего домена. В 1С здесь ничего не настраивается: база всегда опубликована через Apache или IIS, а перед ними часто стоит nginx, поэтому сертификат домена ставится только на самый внешний веб-сервер:

  • перед Apache или IIS стоит nginx — сертификат и закрытый ключ прописываются в nginx; внутри сети до Apache или IIS трафик идёт по обычному HTTP, сертификат им не нужен
  • nginx нет — сертификат настраивается напрямую в Apache (SSLCertificateFile / SSLCertificateKeyFile) или привязывается к сайту в IIS

Требования Max к HTTPS-адресу вебхука:

  • только HTTPS на стандартном порту 443 (обычный HTTP и другие порты не поддерживаются)
  • SSL-сертификат выдан на ваш домен любым доверенным УЦ (например, Let's Encrypt) или УЦ Минцифры — специально выпускать сертификат в Минцифры не нужно, Max просто принимает его наравне с обычными. Самоподписанный сертификат не подойдёт
  • веб-сервер отдаёт полную цепочку сертификатов вместе с промежуточным (для nginx в ssl_certificate указывается файл fullchain, а не только сертификат домена)

Создайте архивную копию базы перед установкой расширения

Действие, необходимое перед любыми изменениями конфигурации рабочей базы 1С

Установите расширение «Арете — сервер мессенджеров, Max edition»

Уведомление: расширение скорее всего не получится установить через "Управление расширениями конфигурации" в режиме 1С:Предприятия, потому что этот способ ожидает одинакового режима совместимости расширения и основной конфигурации, а это встречается довольно редко.

  • Откройте 1С:Предприятие в режиме конфигуратора
  • Нажмите "Конфигурация" -> "Расширения конфигурации"
  • Нажмите "Добавить". Имя, синоним и префикс не меняйте, позже они поменяются автоматически. В поле "Назначение" укажите "Дополнение". Нажмите "ОК".
    Добавление расширения
    Добавление расширения
  • Спозиционируйтесь на добавленном расширении, нажмите "Конфигурация" —> "Загрузить конфигурацию из файла". Важно: не перепутайте пункт меню "Конфигурация" расширения с пунктом меню "Конфигурация" основной конфигурации
    Загрузка расширения
    Загрузка расширения
  • После загрузки, нажмите "Конфигурация" -> "Обновить конфигурацию". Исправьте возникшие "ошибки режима совместимости" через "установить свойство из основной базы". Дождитесь обновления конфигурации, принимая через кнопку "Принять" все изменения.
  • Снимите безопасный режим у расширения: иначе исходящие HTTP-запросы к Max, скорее всего, не пройдут.
  • Если Вы планируете разрабатывать во внешней обработке, то снимите также и защиту от опасных действий. Обращение ко внешней обработке действительно является потенциально опасным действием (код внешней обработки легко меняется недоверенными лицами)
  • При желании, переназначьте добавленной подсистеме "АСМ" картинку с "АСМ_Подсистема16" на "АСМ_Подсистема32" — для интерфейсов с более крупными картинками
  • При возникновении трудностей и сомнений при установке помните — поддержка рядом. Пишите, звоните, и получите квалифицированную помощь.
Если решение «Арете — сервер мессенджеров, Max edition» было установлено корректно, то в режиме 1С:Предприятия появится пункт интерфейса "АСМ":
АСМ
АСМ

Назначьте роли выделенным пользователям

Роль АСМ — Администратор подсистемы — администратору подсистемы. Роль АСМ — Чат-бот обеспечивает минимально необходимые права для работоспособности бота пользователю, от имени которого работают вебхуки или регламентные задания. Если бот будет менять основные объекты конфигурации, добавляйте права на изменение в эту роль.

Введите выданный с покупкой лицензионный ключ

В режиме 1С:Предприятия откройте пункт меню "Лицензия" и введите лицензионный ключ — он обеспечит работоспособность решения.

Инициализируйте подсистему

В режиме 1С:Предприятия откройте пункт меню "Инициализация подсистемы" и везде последовательно нажмите "Заполнить" — заполнение метдов Max, заполнение справочников роутинга, справочника эмодзи. Создайте регламентное задание очистки журнала.

Что дальше?

Создайте первого бота
Подключите к созданному боту демонстрационный обработчик

Возможные проблемы и способы их решения

  • Нет исходящего HTTPS — расширение осталось в безопасном режиме. Выключите безопасный режим или создайте профиль безопасности, включив в него обращение к интернет-ресурсу по адресу https://platform-api2.max.ru
  • Ошибка сертификата при соединении с Max — корневой сертификат Минцифры не добавлен в доверенные на той машине, которая обращается к API. Проверьте, что он лежит в «Доверенных корневых центрах» локального компьютера (Windows) или в системном хранилище (Linux), а затем перезапустите службу сервера 1С:Предприятия
  • Отсутствует раздел "АСМ" в режиме 1С:Предприятия — пользователю не назначена роль АСМ — Администратор подсистемы
  • Не выполняются никакие методы — не была выполнена инициализация подсистемы


Другие руководства