===== Интеграция с TrueConf =====

В этом материале я настрою интеграцию //Exchange// и //MS-Outlook// с сервером ВКС //TrueConf//. 

Интеграция необходима, чтобы можно было создавать конференции прямо из почтового клиента при создании встреч. Существует два способа осуществить интеграцию: через старый COM-плагин //TrueConf//, который распространяется в msi-пакете или через более актуальную веб-версию. В данном материале я использую интеграцию через веб-версию плагина. 

==== Информация о COM-надстройке ====

:!: COM-плагин версии //1.2.0.47// у меня не заработал. При разборе логов выяснилось, что плагин падал в //403 Forbidden// при попытке получить серверную лицензию.

Для сведений: логи плагина можно обнаружить здесь:

  C:\Users\%USERNAME%\AppData\Local\TrueConf\OutlookAddIn

==== Требования для развёртывания интеграции через веб-плагин ====

1. Аккаунт на сервере //TrueConf//, который имеет права на создание конференций. При необходимости можно сначала протестировать создание конференций через обычный веб-интерфейс //TrueConf//, чтобы убедиться в том, что прав данного пользователя хватает. 

2. Манифест-файл плагина для его установки и распространения через веб-админку //Exchange//. 

Данный xml-файл можно загрузить через интерфейс администратора //TrueConf// в разделе //"Почтовые плагины"//. Вот как это выглядит:

;#;
{{:soft:tc_plugin_download.jpg?600|}}
;#;

3. Кроме загрузки через данный файл, непосредственно в //Outlook// этот плагин можно установить через штатную функцию установки плагинов Outlook //Get-Addins// и поиск по "TrueConf". Однако, в этом случае нам будет необходима авторизация с аккаунтом //MS// в магазине и мы не сможем установить плагин централизованно через админку //Exchange//, поэтому лучше скачать файл-манифест.

==== Установка веб-версии плагина конкретному пользователю ====

Идём в //OWA// и выбираем раздел //Manage add-ins//.

;#;
{{:exchange:owa_manage_addins.jpg?400|}}
;#;

Добавляем плагин и выбираем xml-файл манифеста, подтверждаем установку. Убеждаемся, что плагин появился.
;#;
{{:exchange:owa_manage_addins_add.jpg?800|}}
;#;

=== Troubleshooting установки надстройки ===

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

Выясняем под какой политикой работает ящик, в который мы устанавливаем расширение и копируем её название:

  Get-Mailbox TestMailbox | fl RoleAssignmentPolicy

Выполняем на эту политику запрос:

<code>
Get-ManagementRoleAssignment -RoleAssignee "Default Role Assignment Policy" | ? {$_.Role -like "My * Apps"} | ft Role,RoleAssigneeName
</code>

В выводе должно присутствовать следующее: //My Custom Apps//.

И на всякий случай можно проверить настройку на уровне организации:

  Get-OrganizationConfig | fl AppsForOfficeEnabled
=== Настройка веб-плагина в почтовом клиенте ===

Плагин, установленный на предыдущем этапе через //OWA// - должен через какое-то время появиться в десктопном почтовом клиенте //АВТОМАТИЧЕСКИ// (распространение может занять до 24-х часов, но на практике хватило минут 15-ти).

Для проверки и использования плагина необходимо создать //New Appointment// или //New Meeting//. Если плагин успешно приплыл в //Outlook Desktop// - мы увидим кнопку //TrueConf Meeting//. Пример:

;#;
{{:exchange:outlook_test_tc_appointment.jpg?800|}}
;#;

При первом запуске плагин попросит следующее: имя //TrueConf//-сервера (или его IP), имя пользователя и пароль. 

После ввода настроек откроется окно, содержащее параметры создаваемой в //TrueConf// конференции, а ссылка на неё в письме появится после нажатия кнопки //NEW TRUECONF MEETING//.

;#;
{{:soft:trueconf_meeting_creation_outlook.jpg?600|}}
;#;

{{tag>Exchange Microsoft Mail PowerShell TrueConf}}