Интеграция с внешними ВКС через календари CommuniGate Pro

Интеграция призвана дать возможность единообразно планировать видеоконференции простым созданием событий в календарях аккаунтов на CGPro безотносительно используемого календарного клиента и протокола. Таким образом автоматическое планирование конференций станет возможным и при работе в ThunderBird, подключенным к календарю по протоколу CalDAV, и из мобильных клиентов Gmail/Nine/AppleMail, работающих по ActiveSync, и используя собственные клиенты семейства Samoware, базирующиеся на протоколе XIMSS.

Данная интеграция доступна начиная с версии CommuniGate Pro 6.4. На момент написания данной инструкции официальный релиз 6.4 еще не состоялся, а потому единственным вариантом использования интеграции является установка beta версии, которая доступна на нашем FTP сервере, в частности DEB и RPM пакеты возможно загрузить по ссылкам ниже:

https://ftp.communigate.ru/pub/stuff/Linux/CGatePro-Linux_6.4c-2h_amd64.deb

https://ftp.communigate.ru/pub/stuff/Linux/CGatePro-Linux-6.4c-2h.x86_64.rpm

Взаимодействие с API внешних систем видеоконференций выполняется с помощью синхронных скриптов (Подробнее о синхронных скриптах). Точкой входа является скрипт vchandler.scgp. В верхней части данного скрипта в глобальной переменной supportedVCS через запятую указываются названия всех доступных и сконфигурированных ВКС, которые могут быть использованы для автоматического планирования конференций. Например, для случая настроенной интеграции с vinteo и webinar, переменная в скрипте будет иметь следующий вид:

const supportedVCS = "vinteo,webinar";

Если же доступна только одна ВКС (например, webinar), значение переменной будет таким:

const supportedVCS = "webinar";

После редактирования скрипта, его необходимо загрузить в безымянный общесерверный интерфейс в случае односерверной (standalone) инсталляции (рисунок 1), либо в безымянный общекластерный интерфейс в случае если конфигурация сервера кластерная (рисунок 2).

Интеграция с каждой ВКС выполняется в виде одноименного модуля с расширением scgi (например, vinteo.scgi, webinar.scgi). Данные скрипты вызываются из скрипта диспетчера vchandler.scgp на основании выбранной при создании события ВКС.

Рисунок 1.

Рисунок 2.

Интеграция с Webinar

Функционал интеграции реализован в модуле webinar.scgi. Для работы с Webinar API необходим ключ авторизации, узнать который возможно в личном кабинете Webinar (рисунок 3)

Рисунок 3.

Данный ключ необходимо указать в конфигурационной секции файла webinar.scgi в переменной authToken. В конфигурации также указывается и API URL, который на данный момент является одинаковым для всех клиентов. Пример конфигурационной секции:

const authToken = "<КЛЮЧ API>";
const apiURLBase = "https://userapi.webinar.ru/v3/";

Как и файл vchandler.scgp, модуль webinar.scgi необходимо загрузить либо в безымянный общесерверный интерфейс, либо в безымянный общекластерный интерфейс – в зависимости от конфигурации инсталляции.

Для автоматического планировиня видеоконференции необходимо при создании события в поле место (Location) указать название ВКС с префиксом "vc-". Например, vc-webinar, vc-vinteo, vc-trueconf.

Видео с демонстрацией работы интеграции доступно по ссылке Интеграция webinar.

Для получения более подробной информации пишите на support@communigate.ru