Commend VirtuoSIS and CyberGate

this guide describes how to connect a commend virtuosis intercom server to microsoft teams using the cybergate service it is intended for administrators of both cybergate and virtuosis after configuration, microsoft teams users can answer incoming intercom calls — with 2 way audio and live video — on the teams desktop client, teams desk phone, or teams smartphone app, and open the door for visitors cybergate runs as an application in microsoft azure for instructions on how to purchase and configure the cybergate service, see cybergate purchase and setup docid\ ma524juznu6zqjc4mcf34 how virtuosis connects to cybergate for this document we used an od5 tdcm outdoor station configured behind a virtuosis intercom server (from now on named 'virtuosis') to connect to the cybergate service (from now on named 'cybergate') all other commend stations that can be connected to virtuosis can also communicate with cybergate video on teams is only supported with video compatible devices virtuosis communicates with cybergate via a session initiation protocol (sip) trunk the sip trunk is one active connection to cybergate that allows all intercom systems connected to virtuosis to communicate with microsoft teams cybergate has a sip trunk option that needs to be enabled it allows you to create a sip trunk account with unique credentials once this sip trunk account is configured in virtuosis, each device that communicates via virtuosis through the sip trunk to cybergate will automatically be added as a 'sip trunk device' in cybergate this guide is divided into three sections configure cybergate for virtuosis — the necessary configuration in the cybergate admin portal configure the sip trunk in virtuosis — the configuration of the sip trunk on the virtuosis side appendix install the cybergate app — the installation and usage of the cybergate app for microsoft teams installation of the cybergate app is highly recommended to configure virtuosis for cybergate, technical knowledge of virtuosis and the connected commend devices is required sip trunk device licensing in cybergate each sip trunk device needs a cybergate license each sip trunk device can be edited to change its name edited to enable / disable two way video deleted if more sip trunk devices are detected than cybergate licenses available, the newly added sip trunk devices are disabled by default you can free up licenses by deleting (no longer used) sip trunk devices or by adding licenses (in the menu license overview ) added licenses will be active within a few minutes after adding as soon as extra licenses are available, the disabled device(s) automatically become active what the cybergate app for microsoft teams adds use the cybergate app for microsoft teams to open the door of the intercom by simply clicking on an open door button see the status of your intercom and call the intercom from teams by clicking on just one button set your availability status in a configured cybergate multi ring group with one click installation of the cybergate app for microsoft teams is highly recommended see the appendix install the cybergate app configure cybergate for virtuosis follow the steps in this section to configure cybergate for virtuosis in the cybergate admin portal enable sip trunk support log in to the admin portal of cybergate https //admin cybergate cybertwice com https //admin cybergate cybertwice com navigate to the tenant settings menu trunk support is disabled by default click the blue enable trunk support button to enable trunk support after trunk support is enabled, a new menu is added called sip trunk settings add a sip trunk in cybergate navigate to the sip trunk settings menu click the blue add sip trunk button to add a sip trunk provide the following information add sip trunk name name the sip trunk (in this example we name it virtuosis) click the blue add button when done a sip trunk with the provided name is generated the authentication username and password are automatically generated; you need them later to configure virtuosis check the sip trunk in device settings navigate to the device settings menu the sip trunk is shown, but no devices are detected yet each device that calls to microsoft teams through cybergate will be automatically added create a multi ring group in cybergate the virtuosis sip trunk and the calls that have to be routed through that sip trunk are always addressed as numbers teams however works with teams usernames (e g koos ridder\@domain com mailto\ koos ridder\@domain com ) to address this, you need to create at least one multi ring group in cybergate this multi ring group must have a number as a name (e g 123) when called from a device behind virtuosis, it will then ring all teams users configured in this multi ring group navigate to the multi ring settings menu click the blue add multi ring group button to create a multi ring group provide the following information add multi ring group name name the multi ring group (in this example '123') description describe this multi ring group (in this example 'demo group') click the blue save button when done add at least one teams user to this multi ring group configuration in the cybergate admin portal is now finished continue with the next section to configure virtuosis configure the sip trunk in virtuosis configure the sip settings of the trunk log in to virtuosis and navigate to interfaces sis sip t trunks trunk01, sip settings provide / change the following information primary host sip server ip address/hostname cybergate cybertwice com transport protocol tcp registration registration enable sip server ip address/hostname cybergate cybertwice com username use the sip trunk authentication username provided by the cybergate service contact user use the sip trunk authentication username provided by the cybergate service authentication user use the sip trunk authentication username provided by the cybergate service password use the password provided by the cybergate service call handling enable outgoing authentication username use the sip trunk authentication username provided by the cybergate service password use the password provided by the cybergate service dial plan enable force ringing assign a channel to the trunk navigate to trunks channels common provide the following information for the desired call number / channel (in this case 901) channel > trunk assignment trunk01 this links channel 901 to trunk01 configure video for the channel navigate to trunks channels video provide the following information for the desired call number (in this case 901) mode camera and monitor camera number 901 configuration of the sip trunk in virtuosis is now completed call a teams user from a virtuosis device to call from a device behind virtuosis you need two things the call number for the sip trunk use this as prefix to get the call routed through the sip trunk to cybergate the number defined in the multi ring group in cybergate that contains the teams user(s) to call by dialing the prefix + the multi ring group number, the teams user will be called example trunk number 901 multi ring group number 123 teams user programmed in the multi ring group koos ridder\@domain com mailto\ koos ridder\@domain com program your device to call 901123 to dial out to teams user koos ridder\@domain com mailto\ koos ridder\@domain com if configured correctly, the teams client will notify you of an incoming call answer it by clicking the camera symbol the call will be established and video will be displayed within ±3 seconds