Smart Apps¶

С помощью Smart Apps участники вашей команды могут добавлять в Compass почту, ЭДО, календари, задачники, AI-ассистентов и корпоративные сервисы в 2 клика.

Чтобы перейти в каталог приложений, нажмите кнопку «+» в чате. Выберите любое приложение и подтвердите добавление.

Чтобы добавить собственное приложение, которое будет доступно только вам, нажмите «Добавить новое» на экране каталога.

Любое приложение можно открывать внутри Compass, либо в отдельном окне. Индикаторы запущенных приложений помогут вернуться к нужному приложению, когда оно свернуто.

Чтобы перейти к настройкам приложения, нажмите правой кнопкой мыши на ярлык приложения в чате и выберите «Изменить». С удобством настраивайте размер окна, звук и фоновую работу каждого сервиса.

Конфигурация каталога Smart Apps¶

Compass On-premise поддерживает возможность редактирования каталога Smart Apps в файле configs/smart_apps.yaml. Для настройки конфигурации воспользуйтесь инструкцией изменения каталога Smart Apps

# Включено ли ограничение на добавление приложений из каталога Smart Apps на сервере.
smart_apps.is_create_from_catalog_disabled: false

# Включено ли ограничение на добавление кастомных Smart Apps на сервере.
smart_apps.is_create_custom_smart_apps_disabled: false

# ----------------------------------------------
# Конфигурация каталога Smart Apps
# ----------------------------------------------
# Доступные параметры:
#
# catalog_item_id: ID приложения в рамках каталога.
#
# is_popular: должно ли приложение отображаться в списке популярных.
#
# sort_weight: значение для сортировки приложения в списке популярных. Чем больше значение,
# тем выше располагается приложение в списке популярных. Параметр действителен только при
# значении is_popular: 1
#
# catalog_category: категория каталога, в которой располагается приложение.
#
# uniq_name: уникальный ID приложения.
#
# title: название приложения, видимое пользователям.
#
# url: URL-адрес, который открывается при запуске приложения.
#
# is_need_custom_user_agent: требуется ли использование специального user-agent при
# открытии приложения.
#
# is_need_show_in_catalog: требуется ли отображать приложение в каталоге.

smart_apps.catalog_config:
  - catalog_item_id: 1
    is_popular: 1
    sort_weight: 10
    catalog_category: "office_apps"
    uniq_name: "googledocs"
    title: "Google Документы"
    url: "https://docs.google.com/document/"
    is_need_custom_user_agent: 1
    is_need_show_in_catalog: 1

Изменение каталога Smart Apps¶

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

Чтобы добавить своё приложение:

Откройте файл configs/smart_apps.yaml любым текстовым редактором.
Найдите раздел smart_apps.catalog_config
Добавьте новую запись, указав все обязательные параметры:
```
- catalog_item_id: 103
  is_popular: 1
  sort_weight: 5
  catalog_category: "other"
  uniq_name: "my_custom_app"
  title: "Мое приложение"
  url: "https://example.com"
  is_need_custom_user_agent: 0
  is_need_show_in_catalog: 1
```
Внимание

Значения catalog_item_id и uniq_name должны быть уникальными и не должны пересекаться с уже занятыми ID в каталоге.
Установка аватара приложения (опционально)

Если не установить аватар, будет использоваться аватар приложения по умолчанию.

Чтобы установить аватар:

Добавьте файл аватара с именем smart_app_avatar_<ID_приложения>.png в директорию root_mount_path/custom_files. Можно использовать изображения в форматах PNG, JPG, JPEG.
```
# Пример для ID приложения 103
cp avatar.png /path/to/root_mount_path/custom_files/smart_app_avatar_103.png
```
Сохраните файл и выполните обновление серверной части:
```
sudo python3 script/update.py
```

Чтобы скрыть приложение из каталога:

Откройте файл configs/smart_apps.yaml любым текстовым редактором.
Найдите запись приложения, которое нужно скрыть, в разделе smart_apps.catalog_config
Измените параметр is_need_show_in_catalog на 0
Сохраните файл и выполните обновление серверной части:
```
sudo python3 script/update.py
```

Примечание

Не рекомендуется удалять приложения из списка или изменять их ID, так как это может отразиться на работе уже добавленных пользователями приложений. Для временного скрытия используйте параметр is_need_show_in_catalog: 0.

Ограничение на добавление Smart Apps¶

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

Откройте файл configs/smart_apps.yaml любым текстовым редактором.
Найдите параметры smart_apps.is_create_from_catalog_disabled и smart_apps.is_create_custom_smart_apps_disabled

Установите нужные значения для параметров:

# Включено ли ограничение на добавление приложений из каталога Smart Apps на сервере.
#
# Тип данных: булево значение, true\false
smart_apps.is_create_from_catalog_disabled: true

# Включено ли ограничение на добавление кастомных Smart Apps на сервере.
#
# Тип данных: булево значение, true\false
smart_apps.is_create_custom_smart_apps_disabled: true

Сохраните файл и выполните обновление серверной части:
```
sudo python3 script/update.py
```

Напишите нам в пространстве поддержки On-premise, Telegram или на почту support@getcompass.ru, чтобы получить индивидуальную демонстрацию функционала и помощь по вопросам интеграции мессенджера в вашей компании.