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

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

Расширение ставят в базу, назначают роли, вводят лицензионный ключ и заполняют справочники подсистемы. Карточка бота и токен — уже в создании первого бота.

Что должно быть до установки

• Платформа 1С:Предприятие 8.3.25 и выше. Понижение версии платформы возможно — уточняйте перед приобретением.
• Конфигурация на управляемых формах (типовая или нет).
• С сервера 1С должен уходить HTTPS к API Max (порт 443).
• Файл поставки расширения, полученный после оплаты.
• Лицензионный ключ из комплекта поставки.

Ставит программист 1С в конфигураторе. Юридические условия — в лицензионном соглашении.

Подключение расширения

1. Откройте конфигурацию в конфигураторе.
2. Расширения конфигурации → добавьте расширение из файла поставки.
3. Имя в метаданных: АретеСерверМессенджеров, префикс объектов — АСМ_.
4. Назначение — дополнение (AddOn), интерфейс Taxi.
5. Снимите безопасный режим у расширения: иначе исходящие HTTP-запросы к Max, скорее всего, не пройдут.
6. Обновите конфигурацию базы данных.

В панели разделов должен появиться раздел АСМ с подсистемой Первые шаги.

Роли

В расширении две роли. Назначьте их в типовом профиле или напрямую пользователям.

• АСМ — Администратор подсистемы — раздел АСМ, лицензия, инициализация, боты, журнал, регламенты.
• АСМ — Чат-бот — для пользователя, под которым выполняются регламентные задания опроса и рассылок.

Администратору базы недостаточно прав «администратора системы» самой 1С: без роли АСМ раздел и команды первых шагов не откроются.

Лицензионный ключ

1. Войдите в 1С:Предприятие под пользователем с ролью администратора подсистемы.
2. Раздел АСМ → Первые шаги → команда Лицензия.
3. Введите ключ из поставки и сохраните. Ключ пишется в константу АСМ_ЛицензионныйКлюч.

Без действующего ключа служебный код подсистемы не выполняет обращения к API. Проверка ключа на сайте: /asm/client (если поставщик выдал ссылку с параметром).

Инициализация подсистемы

Первые шаги → Инициализация подсистемы. На форме четыре действия — выполните все:

1. Заполнение методов Max — каталог методов Max Bot API.
2. Заполнение справочников роутинга — зарезервированные слова и операторы сравнения.
3. Заполнение справочника эмодзи — каталог эмодзи Unicode.
4. Регламентные задания — создайте и включите задание вида «Очистка журнала».

Без первых трёх шагов не заработают выбор методов API, язык роутов и подстановка эмодзи. Повторная загрузка справочников роутинга перезаписывает написания значениями из поставки — свои синонимы после этого нужно вернуть вручную. Подробнее — в руководстве по роутингу.

Как понять, что готово

• В панели разделов есть АСМ и «Первые шаги».
• Команда «Лицензия» показывает сохранённый ключ.
• Справочники зарезервированных слов, операторов сравнения, методов Max и эмодзи не пустые.
• Регламент «Очистка журнала» создан и включён.

Карточку бота, токен и «Кто я» на этом шаге ещё не проверяют — это уже запуск бота.

Что дальше

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

Частые ошибки

• Расширение осталось в безопасном режиме — нет исходящего HTTPS.
• Пользователю не назначена роль АСМ — Администратор подсистемы — раздела АСМ не видно.
• Ключ не записан — служебные вызовы API не выполняются.
• Инициализацию пропустили — роутинг и эмодзи «пустые».
• С сервера 1С закрыт порт 443 наружу — всплывёт на команде «Кто я», когда дойдёте до бота.
• После обновления файла расширения не обновили конфигурацию БД и не прогнали инициализацию заново, если в поставке изменились справочники.