Partners Blog Contact Us

Deploying VidyoEngage for Genesys

Follow

Prerequisites

Prior to the installation and configuration of this software, the following prerequisites should be considered:

  • Vidyo User Accounts (for agents)
  • Operating system specific
    • Linux root access
    • Windows administrator privileges
  • Third-party software deployed
    • Apache Tomcat 8, 9 for ORS scripts
    • Apache Tomcat 8, 9 for Web Widgets
    • Java and JDK 1.8
  • Firewall setting between
    • Customer Side (Web Widget) and Genesys
    • WDE agent network and VidyoWorks
  • Workspace Desktop
    • .NET Framework 4.5 or 4.6
    • Workspace version 8.5.117.xx or 8.5.122.xx (see the "Installing the Workspace" section for more information)
  • Configuration of VidyoEngage for Genesys
    • Agent Roles (Can use Vidyo for Click-to-Vidyo; can use IM for Invite Expert)
    • Workspace out-of-box options
  • Feature specific
    • Voice escalation to Vidyo
      • Genesys T-Server SIP
    • Chat escalation to Vidyo
      • Genesys eServices and/or Web Engagement
    • Click-to-Vidyo
      • Genesys Orchestration Server (configured to route multimedia interactions)
      • Verified SSL certificate file for secured Vidyo Server communication (for test instance, a self-signed certificate is enough)

For detailed information about supported components versions, see the "Supported Components" section.
 

Licensing

The Vidyo Adapter is sold with a video license. This license is a technical license of open media interactions. For Click-to-Vidyo, it is necessary to have ics_custom_media_channel licenses. The number of these licenses is set using the interaction server options. If this license is missing, the agent is able to see the Vidyo channel, but is not able to log in. The license is included in the 3rd Party Video License for Vidyo Adapter sellable item.

The Invite Expert feature uses a SIP-based IM channel integrated to WDE. The WDE application must be IM channel enabled. The agent must be assigned with one voice seat DN license to be allowed to use IM. Seat DN licenses are controlled by the SIP Server option num-sdn-licenses. Without this license, the  agent will not be able to log in to the IM channel and will not be able to send invite expert requests.

More detailed information about Genesys licensing can be found in the Genesys Licensing Guide.


Supported Platforms

The specification of the systems and platforms for the Genesys Vidyo Adapter is governed by the product Out of Box specifications and direct software dependencies of the Adapter.

The Adapter has been evaluated with the following versions of software:

COMPONENT VERSION
Operating System Server

Windows Server 2008 64-bit, CentOS 6.6

For the Genesys components, see the Genesys Supported
Operating Environment Reference Manual
.
Operating System Desktop Windows 7 64-bit, Windows 10 64-bit
Genesys Platform

CIM version 8

Interaction Server        8.5.100.18

Orchestration Server   8.1.400.45

TServer SIP 8.1
Web Browsers

Chrome version 48 and later

Firefox® version 38.7.0 ESR, and earlier than version 52

Internet Explorer version 11

Safari® version 9.0.3 and later

Third Party to support Click-to-Vidyo

Apache Tomcat 8, 9

Java and JDK 8

Workspace Desktop Edition 8.5.117.xx, 8.5.122.xx
Vidyo Server

18.3.0.2

 

It is recommended to use the same specs as the small configuration referenced in the Genesys Hardware Sizing Guide for the Vidyo Server.


Tasks Summary

  1. Install the third-party software.

  2. Perform the Genesys Administrator (optionally CME) and GAX changes to framework:
    • Set vidyo media type.
    • Set new capacity rule (can be set with CME Resource Capacity Wizard plugin).
    • Set agent skill, group, Person object (agent, expert).

  3. Set Routing script web container and deploy scripts in GA:
    • Deploy web container (Tomcat).
    • Deploy routing scripts.
    • Configure routing scripts in GA.

  4. Deploy the Vidyo Server application object:
    • Deploy the application object.
    • Set connections and options.

  5. Deploy the WDE application object:
    • Configure open media channels.
    • Set the agent roles for vidyo and expert.

The Genesys software is normally installed in the GCTI folder. For Windows installations, create “C:\GCTI\vidyo”. For Linux distributions, create the “/opt/gcti/vidyo” folder. The server-side software will be located in these folders.

 

Installation Package Contents

The installation package contains multiple components to support the video conferencing feature.

Vidyo Server: VidyoServer_<release version>_<release date>.zip

  • VidyoServer-<release version>.jar
  • Configuration Files
    • config-server-user.properties
    • EnhancedRouting_VidyoApplications.default_vidyo.RouteToAgent.cfg
    • InteractionQueue_VidyoIxnQ.cfg
    • InteractionQueueView_VidyoIxnQ.VidyoInbound.cfg
    • InteractionSumitter_VidyoIxnQ.VidyoInbound.submitter.cfg
    • VidyoServer.apd
  • gaa-pass-util.jar


Workspace Plugin for Vidyo are two separate files for WDE release 8.5.111.xx and 8.5.117.xx:

WorkspacePlug-in_Vidyo_<release version>-<wde version>_<release date>.zip

  • Languages
    • Genesyslab.Desktop.Modules.CustomVidyo.en-US.xml>
  • Snapshots
    • >Default.bmp
    • >tmp
  • Genesyslab.Desktop.Modules.CustomVidyo.dll
  • Genesyslab.Desktop.Modules.CustomVidyo.module-config
  • VidyoClientDll.dll.config
  • VidyoClientDll.dll
  • ca-certificates.crt
  • >ca-certificates-base.crt

 

The content of InteractionWorkspace.exe.config as related to the Vidyo plugin was moved in version 18.1.0 to VidyoClientDll.dll.config. InteractionWorkspace.exe.config doesn’t need to be modified or replaced anymore. It was removed from the install package.

 

WorkspacePlugin_Templates_<release version>_<release date>.zip (GA WDE application template)

ORSApp: 
ORSApp_<release version>_<release date>.zip (ORS routing application)


VidyoApplications:
VidyoApplications_<release version>_<release date>.zip (Composer project to modify ORS routing)


WebIntegrationSamples:
 

  • WebIntegration_Vidyo_<release version>_<release date>.zip (Standalone samples)
    • <release version> - is Vidyo plugin release
    • <wde version> - is target WDE version. Vidyo plugin included in this package is compiled and tested with this WDE version.

 

Third-Party Software Deployment

The information in this section assumes that the customer doesn’t provide a web container for ORS routing and Web Integration samples.

Before you begin, download the following:

ORS Tomcat

ORS tomcat will run the ORS application released with the Vidyo Adapter package (ORSApp_<release version>_<release date>.zip).

Windows

  1. Unzip the Tomcat binaries from apache-tomcat-9.0.0.M26.zip to C:\GCTI\vidyo\orsweb.

  2. Open orsweb\conf\server.xml:

    • Set shutdown port, port="9015" shutdown="SHUTDOWN"
    • Connector port="9010" protocol="HTTP/1.1"
    • Connector port="9019" protocol="AJP/1.3"

  3. Navigate to orsweb\bin:

    • Open the command line.
    • Execute startup.bat.

  4. Verify whether Apache Tomcat is running at http://<server>:9010.

<server> is the FQDN or hostname of the server that is running the Apache Tomcat container.

Linux

  1. Unzip the Tomcat binaries from apache-tomcat-9.0.0.M26.zip to /opt/gcti/vidyo/orsweb.

  2. Open orsweb\conf\server.xml:

    • Set shutdown port, port="9015" shutdown="SHUTDOWN"
    • Connector port="9010" protocol="HTTP/1.1"
    • Connector port="9019" protocol="AJP/1.3"

  3. Navigate to orsweb\bin:

    • Open the command line.
    • Execute startup.sh.

  4. Verify whether Apache Tomcat is running at http://<server>:9010.

Web Widgets Tomcat

Apache Tomcat will run Sample widgets as a customer-side example integration.

Generating the Keystore for Web Widgets Tomcat

Due to the latest security updates of browsers, you must enable the https port on Widgets Tomcat. This requires a certificate to be generated. For test purposes, you can generate a self-signed certificate.

The same procedure is applied as described in the "Creating the Keystore File for Tomcat" section later in this article.

To perform the installation:

  1. Create the keystore file as described in the "Creating the Keystore File for Tomcat" section later in this article.
  2. Copy the final keystore.jks to the websrv\conf\ folder.

If Web Widgets Tomcat is running at the same host as the Vidyo server, it is possible to reuse the same keystore file.

<name-of-keystore> - is by default keystore.jks

Windows

  1. Unzip the Tomcat binaries from apache-tomcat-9.0.0.M26.zip to C:\GCTI\vidyo\websrv.

  2. Set Tomcat https and management ports:

    • Open websrv\conf\server.xml.
    • Set shutdown port, port="9025" shutdown="SHUTDOWN"
    • Connector port="9020" protocol="HTTP/1.1"
    • Connector port="9029" protocol="AJP/1.3"

  3. Enable Tomcat https port:

    • Open websrv\conf\server.xml.
    • Define the https port:
      <Connector port="9023" protocol="org.apache.coyote.http11.Http11NioProtocol" maxThreads="150" SSLEnabled="true">
                <SSLHostConfig>
                     <Certificate certificateKeystoreFile="conf/<name-of-keystore>" type="RSA" />
                </SSLHostConfig>
           </Connector>
    • <name-of-keystore> - is the file name of the keystore defined in the "Generating the Keystore for Web Widgets Tomcat" section above.

  4. Navigate to websrv\bin:

    • Open the command line<./li>
    • Execute startup.bat.

  5. Verify whether Apache Tomcat is running at http://<server>:9020 and http://<server>:9023.

 

Linux

  1. Unzip the Tomcat binaries from apache-tomcat-9.0.0.M26.zip to /opt/gcti/vidyo/websrv.

  2. Open websrv\conf\server.xml:

    • Set shutdown port, port="9025" shutdown="SHUTDOWN"
    • Connector port="9020" protocol="HTTP/1.1"
    • Connector port="9029" protocol="AJP/1.3"

  3. Define the https port:
         <Connector port="9023" protocol="org.apache.coyote.http11.Http11NioProtocol"           
               maxThreads="150" SSLEnabled="true">
                     <SSLHostConfig>
                          <Certificate certificateKeystoreFile="conf/<name-of-keystore>" type="RSA" />
                     </SSLHostConfig>
            </Connector>


  4. Navigate to websrv\bin:

    • Open the command line.
    • Execute startup.sh.

  5. Verify whether Apache Tomcat is running at http://<server>:9020 and http://<server>:9023.

For the https port, the browser will open a security exception dialog. Confirm this security exception and continue with the normal browser operation. It is possible to export and install self-signed certificates locally, and the security exception dialog will not appear.


Java 8

Install Java into the operating system, if it is not there already. Verify whether Java is installed by opening the command line and typing java –version.

The expected response to the command line is the version of the Java package installed.

java version "1.8.0_121"

Java(TM) SE Runtime Environment (build 1.8.0_121-b13)

Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)

If your OS can identify that Java 1.8 is installed, it is not necessary to re-install it. Instead, perform the steps in the following subsections.

Windows

Create a C:\GCTI\java directory and install Java into it. For detailed information about how to perform the install procedure, refer to the Oracle documentation at https://docs.oracle.com/javase/8/docs/technotes/guides/install/windows_jdk_install.html#CHDEBCCJ.

Linux

Create a /opt/gcti/java directory and install Java into it. For detailed information about how to perform the install procedure, refer to the Oracle documentation at https://docs.oracle.com/javase/8/docs/technotes/guides/install/linux_jdk.html#BJFGGEFG.

 

Installing Routing Scripts

 

Deploying ORS Scripts

Navigate to the installation package folder “ORSApp”. Unzip the package and copy the “ORSApp” folder into the web container “webapps” deployed in the "ORS Tomcat" section above.

  1. For windows and Linux based installation is procedure the same. Navigate to web container installation folder /opt/gcti/vidyo/orsweb or C:\GCTI\vidyo\orsweb.

  2. Open the webapps folder.

  3. Unzip the content of ORSApp_<version>_<releasedate>.zip into the webapps folder.

  4. Start Tomcat ORS web container.

  5. Open a web browser (IE, Firefox, or Chrome).

  6. Navigate to http://<server>:9010/ORSApp/ors/src-gen/IPD_default_vidyo_RouteToAgent.scxml.

  7. Navigate to http://<server>:9010/ORSApp/ors/src-gen/IPD_default_defaultWorkflow.scxml.

The URLs executed in steps 6 and 7 must respond with SCXML structure into the browser window. The ORS will access these scripts during the Vidyo interaction routing. If these scripts are not accessible, routing will not work.

Sample results are shown in the following illustrations:

RoutingScriptSample1.png

 

RoutingScriptSample2.png

 

Change Interaction Routing (Optional)

The Genesys Composer project used to generate the scripts provided with the solution may be extended as needed.

  1. Locate the Composer .project file.

  2. Open Eclipse, which includes the Composer plugin (Composer version 8.1.410.14).

  3. Import the project as 'Existing Project into Workspace'.

  4. Use Workflows/RouteToAgent.workflow as the entry point to the strategy. From here the extension may begin.

  5. Once the new strategy is complete, compile the whole project (not just the RouteToAgent.workflow).

  6. Do NOT publish the IPD, but export the project as a .war file.

  7. Deploy the .war file on a web application server.

  8. Update the 'Enhance Routing Script' object to point to the new server.


Administrator Provisioning

The Genesys Administrator (Administrator) is the application used to enter provisioning data. This includes role-based access control and the data that controls the hierarchical provisioning levels of the application, tenant, agent group, and agent.

The provisioning data specified in this article pertains to the custom options only. There are additional OOB parameters that may be set to non-default values as needed, but are not represented here. Please refer to the VidyoEngage Genesys Product documentation for an all-inclusive list of the OOB parameters.


Framework Changes

The release files listed previously include the Application Template (*.apd) and configuration files (*.cfg) that must be uploaded and imported into Administrator after dependent objects are created.

Click-to-Vidyo requires changes to support a new media type of vidyo.


Add Media Type

To add a media type:

  1. Go to Routing/eServices > Business Attributes.

  2. Select Media Type > Attribute Values.

  3. Enter new Name = vidyo.

  4. Click Save.

     


Capacity Rules

Capacity rules may be modified to support the new media type and accept voice and chat interactions.

To modify capacity rules:

  1. Log in to GAX or use the Configuration Manager Resource Capacity Wizard.

  2. Go to Accounts > Capacity Rules.

  3. Select + to Add Capacity Rule.

  4. Set the name "capacity-voice-chat-vidyo".

  5. Click + to add media.

  6. Select vidyo from the list and click Ok.

  7. Select voice from the list and click Ok.

  8. Select chat from the list and click Ok.

    The final configuration will look like this:

    CapacityRule.png

 

Caution: The capacity rules must be set by the wizard or GAX only. Setting the value manually will cause issues during the interaction routing. That is, the interaction will not be delivered to the agent even if the agent is assigned the capacity rule.

 


Add a Virtual Queue

A virtual queue is an object for the new Interactions of media type vidyo to collectively wait to be routed.

To add a virtual queue, open GA and:

  1. Go to Switching > Switches > <Switch Name>.

  2. Select the DNs tab.

  3. New

    • Name = vq_vidyo
    • Alias = vq_vidyo_SIPSwitch

  4. Click Save.

    <Switch Name> is the name of the switch preconfigured in the Genesys system. It is required for Voice to Vidyo escalation. The agent must be able to handle inbound voice interactions.


Add a Skill

A new skill can be added for skills-based routing to agents.

To add a skill:

  1. Go to Accounts > Skills.

  2. New

    • Name = vidyo.

  3. Click Save.



Agent Configuration

Add a new Person object with Agent type and assign it with Access Group valid for other WDE-enabled agents.

To configure agents:

  1. Go to Accounts > Users.

  2. New

    • General Info:
      • First Name = Vidyo
      • Last Name = 1
      • Employee ID = vidyo01
      • User Name = vidyo01
      • Agent = checked (True)
      • State = checked (Enabled)
    • Agent Info:
      • Capacity Rule = capacity-voice-chat-vidyo
      • Skill = vidyo, Level = 5
      • Agent logins = <Switch-Login-Id>
    • Member of:
      • <WDE-access-group>

  3. Make agent vidyo01 a registered Vidyo portal user. Set agent Annex with section vidyo.

    • Option username=<vidyoportalusername>
    • Options password=<vidyoportalpassword>

  4. Click Save.


<Switch-Login-Id> - Switch login ID must be assigned for voice to vidyo escalation. Agent must be able to log in to voice channel and handle inbound voice interactions.

<WDE-access-group> - Access group for agents who are enabled to use WDE application for inbound vice and chat channels.

<vidyoportalusername> - Username that is configured at the Vidyo portal to be used with Adapter.

<vidyoportalpassword> - Password for an agent.

Each agent must have their account configured at the Vidyo portal.


Agent Group

An Agent Group object can be a target for the new Interactions of media type vidyo. The Vidyo Interactions may be routed to Agents in this group.

To add an agent group:

  1. Go to Accounts > Agent Groups.

  2. New

    • Name = AgentGroupVidyo (example)

  3. Add Agent vidyo01 to the Agent Group.

  4. Click Save.


Vidyo Server

The Vidyo server has its own application object. The server connects to the application object at startup to read the configuration and set up the Vidyo interface services.


Add the Application Template

To add the application template:

  1. Copy the template from the package contents to the GA server.

  2. Go to Environment > Application Templates.

  3. Go to Task > Create > Upload Template.

  4. New

    • Add
    • Select VidyoServer.apd

  5. Click Save.


Add an Application

A VidyoServer Application object uses the new template to define the options.

To add an application:

  1. Go to Environment > Applications.

  2. Click New.

  3. General

    • Name = VidyoServer
    • Template = VidyoServer
    • Connections > Add
      • Interaction Server
      • Orchestration Server
      • Solution Control Server

  4. Server Info

    • Tenants = <Tenant Name>
    • Host = <Server-Host-Name>
    • Listening Ports
      • Add
        • Default = 9030
        • https = 9032
    • Working Directory = <*>
    • Command Line = <*>

  5. Click Save.

    Note that <*> are not used by the server, but must contain any information for the enable application object to be saved to the configuration database. Insert “.” (dot) as a fake application option value and save the application object.




Vidyo Server Options

In order for the Vidyo Server to work with the sample routing delivered within the installation package, you must set the following options in the application object.

Section service.click-to-vidyo

OPTION COMMENTS
 _external_url http://<server>:9010/ORSApp/ors/src-gen/IPD_default_defaultWorkflow.scxml
 _ors http://<ors-server>:<http-port>
 _queue vq_vidyo_SIPSwitch
_target ?:(vidyo>1)@<stat-server>.GA
_hide_KVP_values false
_agent_reserve_timeout

30

_media_type vidyo
_ttl 3600


_external_url - URL of the ORSApp workflow (IPD_default_defaultWorkflow.scxml).

_ors – configuration of ORS http port. This option overrides the setting of “Connections” if required. To find <http-port> or ORS, navigate to ORS application object > Configuration > Server Info > Listening Ports. Read port with ID = http.

_target – low-level routing expression. The explanation of items are ?:(skill-name>skill-level)@<stat-server>.GA

  • <skill-name> - name of skill assigned to vidyo agent
  • <Skill-level> - minimum skill level that meets interaction routing criteria
  • <stat-server> - name of statistical server application object name used by URS for routing vidyo interactions to an agent
  • .GA – internal URS identifier for group of agents
  • The target expression “?:(vidyo>1)@StatServerNameHere.GA” translated to human language means: “Select Group of Agents with skill vidyo more than 1, monitored by statistical server with name StatServerNameHere”

_agent_reserve_timeout – target selection timeout, ORS is looking for available agent for 30 seconds. On expire, it will respond to Vidyo server with no available agents error. 


Section General

ixnQueue=VidyoIxnQ, queue from the "Adding the Interaction Queue" section.

Section Log

Starting from version 18.1, the Vidyo server writes the log file with a unique name after startup. The file name specified in the log_file option is appended with the current timestamp _YYYYmmDD_HHMMSS.log. Older versions of the Vidyo server will write the log to a filename specified in the option log_file without any suffix.

  • log_file = c:\logs\vidyo\vidyoserver
  • log_level = DEBUG
  • log_max_file_size = 10MB
  • log_num_backups = 10
  • log_psdk = true
  • log_filter=<comma “,” separates list of expressions to be filtered out from vidyo log file>

For Linux deployments, use e.g. /tmp/log/genesys/vidyo/vidyoserver.


Vidyo Server Configuration Options Reference

Section general

Option Description Valid Default

IxnQueue

Name of Genesys Queue where Vidyo Server submits the interaction. String VidyoIxnQ


Section log

Option Description Valid Default

log_file

Absolute path to log file where Vidyo Server writes logs after it gets connected to the Genesys configuration server.

Note: Format was changed in version 18.1.0.

FilePath String N/A

log_level

Log level as defined by log4j library. ALL, DEBUG, FATAL, INFO, OFF, TRACE, WARN INFO

log_max_file_size

Maximum allowed file size (in bytes) before rolling over. Suffixes "KB", "MB" and "GB" are allowed. 10KB = 10240 bytes String compiled from number with one of allowed suffixes. 10MB

num_backups

Maximum number of backup files to keep Positive integer 1

log_psdk

Enable/disable write of events coming from Genesys backend true/false false

log_filter

Sets list of strings prevented to be written into log. By default, Vidyo Server filters out all passwords. Comma separated list of strings N/A

 

Section service.click-to-vidyo

Option Description Valid Default

_external_url

http link to ORS routing strategy invoked by Vidyo server on interaction created. ORS URI N/A

_ors

ORS server host and port; the port must be configured in ORS application object Info tab as http port http://<orshost>:<port> N/A

_queue

URS target selection queue used by for interaction delivery String Queue Name from Genensys configuration N/A

_target

Low-level target selection expression used for Genesys routing String target selection expression in valid routing format N/A

_hide_KVP_values

Option to hide key value pairs submitted from Web Server to Vidyo server true/false false

_agent_reserve_
timeout

Target selection timeout; after this timeout, default agent routing overflows to retry select an agent Positive integer 30

_media_type

Name of Vidyo interaction media type vidyo Vidyo

_ttl

Timeout to wait for Guestlink from Genesys. After this timeout, Vidyo server considers interaction as not served. Positive integer 3600

 

Section security

The security section is added into the configuration with the TLS connection between vidyo and the Genesys backend feature. This section is mandatory only when the TLS connection is enabled at the Genesys backend components, such as Interaction or Configuration server. If you don't have TLS enabled at the Genesys platform, proceed to the "Routing Changes" section of this article.

Option Description Valid Default

certificate

Definition of file path pointing to PEM certificate file Absolute file path to certificate file N/A

certificate-key

Definition of file path pointing to PEM certificate key file Absolute file path to certificate key file N/A

trusted-ca

Definition of file path pointing to PEM trusted certificate authority file Absolute file path to trusted certificate authority file N/A

crl

Optional definition of the Certificate Revocation List file path Absolute file path to trusted crl file N/A

sec_protocol

Optional security protocol enabled for channel SSLv23, SSLv3, TLSv1, TLSv11, TLSv12 SSLv23

 

To enable a secured channel connection between the Vidyo server and the Genesys backend, you must specify the connection to the secured backend server port.

NewConnectionInfo.png

After this configuration is done, the Vidyo server will look for certificate options in the security section, startup section, or connection advanced section. Information about how to override security setting can be found in the following section, "Overriding Security Settings in the Application Object".

Overriding Security Settings in the Application Object

Vidyo Server applies security setting in following order:

  • startup command line
  • config-server-user.properties file
  • application object
  • connection advanced section

The highest priority has the last record in the list above. The user can set the TLS settings in the startup command line as is explained in the "Vidyo Server Startup Command Line Attributes Reference" section later in this article, and can override this settings in the Genesys configuration. For a detailed description of the command line settings and configuration server TLS settings, see the "Setting Vidyo Server for TLS for Genesys Backend Components" section of the Upgrading VidyoEngage for Genesys article.More details about how to set TLS in the startup command line and config-server-user.properties, see the "Setting Option in config-server-user.properties" section of the Upgrading VidyoEngage for Genesys article. 

 

Setting TLS in the Application Object

Within the application object, you must create a “security” section and store options related to the TLS feature in it.

Setting_TLS.png

The options can be overridden in the component connection tab, if the component uses a different TLS setting.

Setting_TLS_2.png

Vidyo Server is connected to the secured backend component port.

Setting_TLS_3.png

The options used in the section security must be stored in the format option=value within semicolon “;” separated list.

Example of Vidyo Server Basic Configuration

Setting_TLS_4.png



Routing Changes

For the Click to Vidyo use case, it is necessary to deploy ORS-based routing scripts.

Configuring Scripts in GA

A collection of scripts support simple routing of the Vidyo Interactions. It is recommended that all scripts be created under a common folder entitled "Vidyo".

The options are provided as *.cfg files that may be imported into GA.


Add the Interaction Queue

To add the interaction queue:

  1. Copy the configuration files from the package contents to the GA server.

  2. Go to Environment > Scripts.

  3. New Folder

    • Name=Vidyo (example)

  4. Select new folder Vidyo.

  5. New

    • Name=VidyoIxnQ
    • Type=Interaction Queue

  6. Click Save.

  7. Select the Options tab.

  8. Import

    • Select configuration file InteractionQueue_VidyoIxnQ.cfg

  9. Click Save.


Add the Interaction Queue View

To add the interaction queue view:

  1. Go to Environment > Scripts.

  2. Select the new Vidyo folder.

  3. New

    • Name=VidyoIxnQ.VidyoInbound
    • Type=Interaction Queue View

  4. Click Save.

  5. Select the Options tab.

  6. Import

    • Select configuration file InteractionQueueView_VidyoIxnQ.VidyoInbound.cfg

  7. Click Save.


Add the Interaction Submitter

To add the interaction submitter:

  1. Go to Environment > Scripts.

  2. Select the new Vidyo folder.

  3. New

    • Name=VidyoIxnQ.VidyoInbound.submitter
    • Type=Interaction Submitter

  4. Click Save.

  5. Select the Options tab.

  6. Import

    • Select configuration file InteractionSumitter_VidyoIxnQ.VidyoInbound.submitter.cfg

  7. Click Save.


Add Enhanced Routing

To add enhanced routing:

  1. Go to Environment > Scripts.

  2. Select the new Vidyo folder.

  3. New

    • Name=VidyoApplications.default_vidyo.RouteToAgent
    • Type=Enhanced Routing

  4. Click Save.

  5. Select the Options tab.

  6. Import

    • Select configuration file EnhancedRouting_VidyoApplications.default_vidyo.RouteToAgent.cfg

  7. Click Save.

  8. Set the Configuration tab

    • Orchestration > URI
      http://<server>:9010/ORSApp/ors/src-gen/IPD_default_vidyo_RouteToAgent.scxml
    • Orchestration > Parameters
    • Add
OPTION VALUE AND COMMENT
ors_url

http://<ors-server>:<http-port>

 

<server> - URI configuration is routing script configuration; ORS will execute this script.

<ors-server> - Hostname of ORS server; ORS application object connected with VidyoServer.

<http-port> - ORS http port; ORS application object connected with VidyoServer.


Set ORS Dependencies

  1. Make sure that the solution is able to route the eServices interaction as per the Genesys Deployment Guide https://docs.genesys.com/Documentation/OS/latest/Deployment/eServices.
  2. Set option parse_start_parms=false in section orchestration.
    The ORS doesn’t need to parse input parameters; Vidyo default routing is doing it.
  3. Set the log level of ORS to x-server-trace-level = 2 (optional, only for debugging purposes).

The ORS must be able to perform Vidyo interaction routing from eServices. It must pull interactions from the interaction server and execute the agent routing strategy.



Workspace Desktop

The application template and metadata must be uploaded and imported into Administrator. Out of box GA configuration must be updated with new Role Custom Privilege: Custom – Can Use Vidyo. The new role is included in the application metadata XML file; therefore, the template and metadata xml files are used to create the Application.

  • Workspace_Desktop_Edition_*851.apd
  • Workspace_Desktop_Edition_*851_Custom.xml
     

Note that the * indicates there are multiple versions of the files. They are distinguished by the SIP Endpoint support that is needed.


Add an Application Template

To add an application template:

  1. Copy the templates from the package contents to the Administrator server.

  2. Go to Environment > Application Templates.

  3. Go to Task > Create > Upload Template.

    • Add
    • Workspace_Desktop_Edition_*851_Vidyo181.apd
    • Name=Workspace_851_Vidyo_Vidyo181

  4. Import Metadata.

    • Add
    • Workspace_Desktop_Edition_*851_Vidyo181.xml

  5. Click Save.

 

The suffix “_Vidyo181” on the application object template and metadata was introduced in version 18.1.0. Agent Roles were updated so you must upload new templates (.apd) and metadata (.xml) to reload the Roles configuration. The application template now contains a list of options used by the Vidyo plugin.

 


Add a Workspace Desktop Application

A Workspace application object defines the option values and connections to the VidyoEngage for Genesys components.

To add the workspace desktop application: 

  1. Go to Environment > Applications.

  2. New

    • Name=Workspace_Vidyo
    • Template= Workspace_851_Vidyo_Vidyo181
    • Connections > Add
      • Contact server or proxy
      • Interaction server
      • SIP server
      • Stat server

  3. Click Save.


The Step 2c “Connections” must be set with connections to the existing and pre-installed server at the customer premise. The names of the applications are custom set by the person who installed the Genesys solution at customer premise.

The following illustration shows an example configuration:

WorkspaceDesktopExampleConfig.png

All connections on the Workspace application may be set as follows:   

  • Connection Protocol=addp
  • Local Timeout=60
  • Remote Timeout=60
  • Trace Mode=Trace on Client Side

Logging

The OOB Workspace and the Workspace Plugin for Vidyo share the same log file. The traces are interleaved in support of easier debugging to avoid manual timestamp correlation.

The VidyoClient library produces its own log file and is located at the default location of the Workspace log files which is: $Application.RootApplicationData$\log\InteractionWorkspace\logs.

 

Roles and Privileges

The Workspace Plugin DLL is loaded based on a custom privilege. The privilege must be set to 'Allowed' so that the agent can have access to the Workspace Plugin features.


Create a New Role

To allow agent use of Vidyo channel functionality, it is required to set a new agent role.

To create a new role:

  1. Go to Accounts > Roles.

  2. New

    • Configuration
      • General
        • Name=Vidyo_channel
        • State=(checked) Enabled
      • Members
        • Users
          Add: vidyo01

    • Configuration
      • Add/Remove Products
        • Workspace=checked
      • Custom - Can Use Vidyo=Allowed
      • Workitem Privileges (see the "Workitem Privileges" section)

  3. Click Save.

The following illustration shows the configuration of a role privilege:

WorkspacePrivileges.png
 

Workitem Privileges

Workspace processes the Vidyo interaction type as a Workitem, which allows it to use the applicable Workitem privileges of the following:

  • Workitem – Can Decline
  • Workitem – Can Mark Done
  • Workitem – Can 1-Step Transfer
  • Workitem – Can Set Interaction Disposition
  • Workitem – Can Use Workitem Channel

The "Workitem – Can move to Workbin" privilege should be left as Unassigned since use of Workbins is not valid for Vidyo Interactions.


Workspace Option Dependency

To show the new media type of Vidyo in the Workspace requires a channel specification:

  • openmedia.workitem-channels = vidyo

 

If other custom media types are already specified in this option, add vidyo into comma separated list.

 

Invite Expert Configuration

Invite expert requires additional configuration of the agent Person object and the Genesys extension.

The agent must be ready to handle IM channel messages.

To configure invite expert:

  1. Create a new role in GA Accounts > Roles.

  2. New

    • Configuration
      • General
        • Name=Vidyo_IM
        • State=(checked) Enabled
      • Members
        • Users
          Add: vidyo01

    • Role Privileges
      • Add/Remove Products
        • Workspace=checked
      • Instant Messaging - Can Make
      • Instant Messaging - Can Use Instant Messaging Channel
      • Instant Messaging - Can Release

  3. Click Save.

  4. Assign a login ID in to user vidyo01.

  5. Go to Accounts > Users > vidyo01.

    • Agent Info
      • Agent Logins
        • Add loginID from switch defined in WDE connections

  6. Click Save.

  7. Configure vidyo-expert-01 agent.

  8. Go to Accounts > Users and create a new user.

  9. When user vidyo-expert-01 is created, open the agent Annex and delete the section "vidyo" (if it is configured).

 

The Expert role from the Vidyo point of view is the agent capable of using the Genesys IM channel. The agent has no Vidyo Tenant and Portal setting and is always joining the conference as non-registered vidyo user.

 

Setting Shared and Individual Vidyo Accounts

Depending on the Vidyo licensing module, WDE agent Vidyo accounts must be set. The WDE Vidyo portal credentials setting differs based on the number of Vidyo accounts configured at the portal. At the WDE level, it is possible to configure shared or individual Vidyo accounts.

Shared Vidyo Account

One Vidyo account configured at the portal is used by multiple agents in parallel. In this configuration, the WDE application will use a single login to the portal for all agents. The credentials will be set at the application object WDE that the agent is using for operation.

The WDE application object must be set with:

  • Section, vidyo
    • Option, username=<vidyo_portal_user>
    • Option, password=<vidyo_portal_password>
  • Section, interaction-workspace
    • Option, custom.vidyo-join-conference-guest=true

With shared Vidyo account settings, the agent is always joining the conference as a guest and is not logged into the Vidyo portal during the Vidyo session.

If there will be two agents configured with the same Vidyo account and custom.vidyo-join-conference-guest=false, the agent will not be able to establish Vidyo session in parallel. The Vidyo portal will disconnect the connected agent from the session if a new connection with the same credentials is requested.


Individual Vidyo Account

In this configuration, each agent is configured with unique Vidyo portal credentials. The setting of agent credentials must be done at the agent level.

The WDE application object must be set with:

  • Section, interaction-workspace
    • Option, custom.vidyo-join-conference-guest=false

The agent Person object Annex must be set with:

  • Section, vidyo
    • Option, username=<vidyo_portal_user>
    • Option, password=<vidyo_portal_password>

In the case of individual account settings, the agent is logged in to the Vidyo portal during the video session. The agent logs out on session release. 

 

Configuring the Snapshot Feature

Starting with Adapter version 18.1.0, the WDE plugin allows agents to take a snapshot of the video area. To enable the snapshot feature, set the agent roles to Allow agent to use Snapshot.

ConfigSnapshotFeature.png

Setting the role Allowed will enable snapshot button SnapshotButton.png visibility on the agent's Vidyo toolbar. The snapshot preview files are stored in the folder “Snapshots/tmp” created under the WDE installation folder. If the folder is missing or not available, the snapshot feature will not work.

The saved snapshot files are stored in the specified folder (see the following section " Configuration Options Reference") or in the WDE “Snapshots” folder.  

Configuring Self-Preview and Video Settings

This feature was added in the 18.2.02 release. Installation of this feature begins with importing of interaction workspace metadata into Genesys Template object. See chapter Self-Preview and video settings for more details. The agent is allowed to see whether the camera is working with Vidyo client inside of the WDE environment. The agent must be configured with this role, Vidyo - Can Use Self Preview:

If the role is not available in the Administrator, make sure that 18.2.0.2 WDE metadata has been imported to Genesys configuration correctly. 

 

To enable the agent, do devices selection, enable Vidyo – Can Select Devices Role.

The Agent is allowed to utilize these features from the Main toolbar area and Interaction Window toolbar. For more details refer to the Users Guide Document 06.

Caution: The selected devices agent preference are stored to agent Annex, interaction-workspace section. Make sure to assign the agent write access to Person object, otherwise the last configuration will not persist after the agent logs out. If the agent logs in at the computer with different devices configuration, Vidyo client uses the last client configuration or the system default.


The last Vidyo client configuration is stored to the agent annex under keys custom.vidyo-last-camera, custom.vidyo-last-microphone and custom.vidyo-last-speakers.

Configuring Video Session Transfer

The Video Session Transfer capability is available from VidyoEngage for Genesys release 18.3.0.2.

To enable the Transfer Video Session functionality; it is necessary to have: 

  • Available Vidyo and instant messaging channels for both agents (inviting and invited)
  • The invited agent must be configured with the same Vidyo portal as the inviting.
  • Both agents must have read write access rights to person object. This url is checked when the Vidyo Communicator is initialized. A matching URL determines the available video session transfer targets.

Follow the configuration steps below:

Make sure the agent has read write access to person object for updates about transfer settings.

  1. Check the agent membership to Access Group (in the example below the access group wde_agent is relevant).

    Video_Session_Transfer_main.png

  2. Check whether the Access Group has read change access to your agent person object (in example wde_agent = HR).

    Video_Session_Transfer_2.png

  3. If the agent is not able to change Person object; then assign Change Permission to it.

    Video_Session_Transfer_3.png

When the agent logs in, the WDE writes information about the current portal URI and the agent's display name within the Vidyo session of the person annex vidyo-transfer section.  The option names are portal-url=”URL to portal” and it reflects the configuration of “custom.vidyo-portal-URI” of an agent.

It is possible to add this configuration manually, but you will have to maintain an override of these options manually. It is recommended to set the write access to the person object and then let the WDE maintain this functionality on login.  On agent logout is vidyo-transfer section deleted from annex by plugin code.

Setting the Agent Role

The Role Privilege Vidyo – The Can Transfer Session allows the agent to use the Vidyo Communicator for transfer of the Vidyo session. Refer to the Vidyo - Can Transfer Session screen below.

Can_Transfer_Session.png

If an agent is allowed to perform the Vidyo Session Transfer, the option custom.vidyo-communicator-enabled is forced to be "True".

Configuring Localization Support

This feature was added in the 18.2.0.2 release. The support of localization is handled using the build in WDE mechanism. For more information, refer to the WDE documentation WDE Localization 08. 

The installation package is set with Genesyslab.Desktop.Modules.CustomVidyo.en-US.xml in Languages folder. This file contains definitions of configurable items (labels, tooltips, messages, etc.) that can be changed or translated to any desired language.

The localized content is initialized at application startup. The changes to the file are not applied dynamically and therefore, you will need to restart the application.

Localization file structure contains definition of dictionary:
<Dictionary EnglishName="English" CultureName="English" Culture="en-US">

Definition of item:
<Value Id="Vidyo.Start.Request" String="Video conference request. Select Vidyo button to start."/>
Id = identifier of resource, can’t be changed. Customization is setting the content based on this Id.
String = text to be displayed. Obtained from localization file at WDE startup.


Configuration Options Reference

All Workspace options follow the same Out Of Box (OOB) Workspace provisioning hierarchy and may be set at any of the listed provisioning levels in the Genesys Administrator (GA) when specified in Section=interaction-workspace.

This section identifies all of the custom options that may be set at the application, tenant, agent group, or agent level.  

Section = interaction-workspace

Option Description Valid Default
custom.kvp-values-hidden Don’t log KVP values if set to true.  True/False  True

custom.resize-delay-interval

 

 

Time in milliseconds Workspace will wait before allowing another video frame resize request to be sent to the VidyoClient to avoid flooding with frequent events. 50 -5000 1000

custom.vidyo-agent-extension

Used to create Room URL and is the suffix to all video room names. 

Should be unique per Agent. 

If not set, Agent EmployeeID is used if it is a numeric value.

Otherwise, a random number is generated and used.
Numeric string N/A

custom.vidyo-allow-content-sharing

Allows the agent to share desktop content from the list of executing applications.

True/False True

custom.vidyo-allow-remote-content-sharing 

 

Allows the agent to view customer shared remote content within the Workspace. True/False True 

custom.vidyo-allow-desktop-sharing 

 

Allows the agent to share the entire desktop from the list of sharing selections.

Dependency:  Only evaluated if option is used

custom.vidyo-allow-content-sharing =True.
True/False False
custom.vidyo-block-failed-recording



Automatically block/stop video conference if the recording failed to start or if it fails during an active conference.

Note: Only relevant if custom.vidyo-start-recording = true.

Present Notification to Agent upon recording failure-

  • True: Error Notification
  • False: Warning Notification
True/False False

custom.vidyo.cancel-message 

Text to show in the notification to the agent whenever a Vidyo interaction is cancelled by the customer using the Vidyo Server Cancel API. Any String The client has cancelled this request.

custom.vidyo-device-selection 

Note: This was deprecated in Release 18.2.0.2.

Specify which component determines the device selection.  Devices include camera, microphone, and speaker. Vidyo, system  Vidyo

custom.vidyo-global-tenant

Used to create Room URL and is the prefix to all video room names. Numeric string N/A

custom.vidyo-join-conference-guest 

 

Allows Agents to share a Vidyo account.  

  • False: Do not share a Vidyo account.  Display Name is whatever is defined within Vidyo account definition and is the same for all Agents using the account.

  • True: Share a Vidyo account.  Display Name is Agent’s “FirstName LastName” and should vary per Agent even though sharing the Vidyo account.
True/False False

custom.vidyo-join-mute


Note: This was changed in 18.2.0.2

When joining a conference, begin with muted devices for the Agent. The accepted values are:

  • True = wildcard value mute all devices
  • False = wildcard value unmute all devices
  • Mic = mute microphone
  • Cam = mute camera
  • Audio = mute speakers

True/False/Mic/Cam/Audio

or

comma separated list of possible values mic,cam,audio
(e.g., mic, cam = mute camera and microphone)

False

custom.vidyo-mark-done-on-release

Automatically closes the interaction window upon the agent ending a Vidyo interaction.

True/False False

custom.vidyo-portal-URI

URI to Vidyo platform. 

Example:  http://Genesys.sandboxga.vidyo.com

Any valid URI string <none>

custom.vidyo-recording-quality 

 

Specifies the quality of the recording that dictates which available recorder to use.

basic, standard, high, voice

basic

custom.vidyo-request-auto

The Workspace automatically creates and joins the agent to a video conference upon receiving a customer Vidyo request. 

If set to False, the Workspace presents a notification to the agent and the agent must manually start the video conference.

True/False

False

custom.vidyo-shutdown-delay 

 

Time in seconds to allow the VidyoClient library to shutdown and deinitialize devices before stopping. 1 – 10 2

custom.vidyo-start-recording 

 

Automatically starts recording all video conferences. True/False True

custom.vidyo-use-proxy

Uses VidyoProxy configured on the Vidyo account. True/False False

custom.vidyo.client.
log-file-name

 

VidyoClient log file absolute path Path to log file (c:\Logs\
VidyoClientDebug
\VidyoTest_)
Current WDE log folder with suffix VidyoClient_ as file name

custom.vidyo.client.
log-file-segments

 

Number of segments for log rotation Positive integer 5

custom.vidyo.client.
log-file-size

 

One log file segment size. Valid values are integer in bytes or number with suffix kB, MB.    500kB

custom.vidyo.client.
log-level-categories

 

VidyoClient log categories  warning all@App debug@AppEvents warning all@App debug@
AppEvents 

custom.vidyo-recording-system

Name of Workspace desktop application object section with SIP recorder settings.

For more information, see the following section, "Configuring SIP Recording Sections".

Comma separated list of section names Empty

custom.vidyo-client-port-max

Note: Added with the release of VidyoEngage for Genesys version 18.1.0.3

End number of port range used by Vidyo client 

Positive integer  64100 

custom.vidyo-client-port-min

Note: Added with the release of VidyoEngage for Genesys version 18.1.0.3

Startnumber of port range used by Vidyo client 

Positive integer 64000 

custom.vidyo-release-on-mark-done

Note: Added with the release of VidyoEngage for Genesys version 18.1.0.3

Allows agent to close Vidyo session by pressing mark Done button at interaction view. If this option is set false, agent will be notified to end video session before closing interaction window. 

true/false  false 

custom.vidyo-remove-query-characters

Note: Added with the release of VidyoEngage for Genesys version 18.1.0.3

Specifies list of characters to be removed from agent first and last name, when agent is joining a Vidyo session as a Guest. 

Comma “,” separated list of characters  N/A 

custom.vidyo-snapshot-target-dir

Note: Added with the release of VidyoEngage for Genesys version 18.1.0.3

Absolute path to folder accessible for user logged in to WDE. Snapshot files are saved into this folder when agent clicks Save snapshot button. When option is not specified, snapshots are stored to WDE install directory “\Snapshots” folder. 

Absolute Path to Folder  N/A 

custom.vidyo-snapshot-target-format

Note: Added with the release of VidyoEngage for Genesys version 18.1.0.3

Format of snapshot picture. Picture is converted into this format before it is saved to target snapshot directory. 

jpg/png  png 

custom.vidyo-snapshot-capture-delay

Note: Added with the release of VidyoEngage for Genesys version 18.1.0.5

Snapshot capture delay for change layout feature. After snapshot view layout is changed in Snapshot window, auto capture can be enabled by setting this option. Value = 0 will switch off auto capture. 

0, 500 – 10000
(0 = switched off; 500-10000 = number of milliseconds) 

custom.vidyo-client-webproxy

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

Specifies name of “section” where proxy settings details can be found. (Check section details later in this chapter for more information). Default value is empty and means no web proxy is used with Vidyo client.

 String  Empty

custom.vidyo-communicator-enabled

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

This option enables use of a new team communicator for Vidyo channel and interactions. For more details refer to chapter Vidyo Communicator for WDE.  True/False  True

custom.vidyo-communicator-max-objects

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

The option is setting maximum number of objects displayed in custom team communicator search results.  2-20 10

custom.vidyo-update-bindings-config

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

 

The WDE copies https bindings from VidyoClientdll.config to InteractionWorkspace.exe.config file at WDE startup when this option is set true. Then it allows administrator to adjust SOAP interface directly in InteractionWorkspace.exe.config and VidyoClientdll.config file can be removed.



 True/Fales False

vidyo.outbound-enable-use

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

The option enables WDE to create outbound vidyo interaction for reporting purposes. The interaction is created at background and not visible to an agent. For more details check chapter Enable vidyo session reporting.   True/False  True

vidyo.outbound-queue

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

Mandatory option that specified QueueName for outbound interaction. The option must be set in case when vidyo.outbound-enable-use=true. The queue name string must reflect queue name created in chapter Enable vidyo session reporting.   String VidyoOut

vidyo.outbound-userdata-map

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

Specifies key name that contains all userdata copied from parent interaction. If the option is not set, the userdata are copied to root of interaction data.

 String Empty

vidyo.outbound-userdata-map-prefix

Note: Added with the release of VidyoEngage for Genesys version 18.2.0.2

Specifies prefix of userdata to be copied. Used to filter only specific userdata from parent interaction to child. With default value all parent userdata are copied to child interaction.

String or Comma

Separated list of strings

 Empty

custom.vidyo-confirm-session-release

Note: Added with the release of VidyoEngage version 18.3.0.2

Display confirmation window before video session is released.

 True/False

False

custom.vidyo-autorelease-timeout

Note: Added with the release of VidyoEngage version 18.3.0.2

Enabling auto video session release timeout, if agent remains "alone" in the call. Alone means without customer or other "human" party. The "number" represents number of seconds until the session is  automatically released.

 Positive Integer

 (Auto Release Disabled)

custom.vidyo-autorelease-can-cancel

Note: Added with the release of VidyoEngage version 18.3.0.2

Allowing agent to reset countdown of auto release to value set in option custom.vidyo-autorelease-timeout. The "number" represents, how many times the agent can reset the counter.  

Positive Integer 

(Cannot Reset Timer)

custom.vidyo-release-on-transfer

Note: Added with the release of VidyoEngage version 18.3.0.2

Disconnects agent that initiates the video session transfer automatically after invited agent joins the video session

True/False 

False


Section = Vidyo

Option Description Valid Default

Password 

Virtual room global password shared by all agents. Any string <none>

User 

 

Virtual room global username shared by all agents. Any string <none> 

 

Both options must be set within section=vidyo at the same level only and must be lower case.


Configure SIP Recorder Sections

Section = recording system identifier (added in the release of VidyoEngage for Genesys version 17.2.1)

Option Description Valid Default

name

Name of the recorder in Connected to Vidyo portal; name will be part of invite response. String Section name

address

IP address of recording system. IP address None

audio-prefix

Audio prefix of the recording system configured at the VidyoGateway. Integer None

recorder-identifier-voice

Identifier of the recording system for voice interactions. Overrides the recorder-identifier option. dn, username, employeeid, name, vidyoextension name

recorder-identifier-eservices

Identifier of the recording system for eservices interactions. Overrides the recorder-identifier option. dn, username, employeeid, name, vidyoextension name

recorder-identifier

Identification of the recording system within the Vidyo configuration. The name must match the endpoint invite response to detect if the recording system joined the session. dn, username, employeeid, name, vidyoextension name
invite-recorder-timeout

 

Timeout for invite recorder event. Positive integer 30

interaction.
parameters.
voice-to-vidyo

Interaction userdata to be mapped to INVITE recorder request. Comma-separated list of strings CallUUID

interaction.
parameters.
chat-to-vidyo

Interaction userdata to be mapped to INVITE recorder request. Comma-separated list of strings Interactionid

interaction.
parameters.
click-to-vidyo

Interaction userdata to be mapped to INVITE recorder request. Comma-separated list of strings Interactionid

custom.vidyo-
block-failed-
recording

Stop conference if recording invite fails. True/False False

custom.vidyo-
start-recording

Start recording when agent joins conference. True/False False

agent-notifications

Send agent notifications to WDE. The settings allow the agent to see whether the recording system joined the session. True/False False


The following screenshot shows a sample recording configuration (vidyo-recording-system=list of sections):
RecordingConfig_1.png

The following screenshot shows a sample rec1 and rec2 configuration:
RecordingConfig_2.png


The # prefix in the Options column is for temporary disabling these options. The option name must exactly match the exact definition described in the documentation; otherwise, it will not be accepted.


Configuring the Web Proxy Section

This feature is available with the VidyoEngage for Genesys 18.2.0.2 version. After setting the  configuration option custom.vidyo-client-webproxy with name of the section; it is necessary to set the section in WDE application object. Refer to the screenshots at the end of this section for an example of this configuration.

 

Option Description Valid Default

Address 

IP or FQDN of proxy server
Numeric port value or proxy server

String


Empty

Port  

 

Virtual room global username shared by all agents Integer 0

Configuration-mode

Vidyo client web proxy configuration mode that tells the client where to find proxy server configuration. Default value is empty string and proxy configuration is ignored. MANUAL, AUTO_DETECT None

In MANUAL mode it is mandatory to set the address and port options.

If the AUTO_DETECT, WDE is detecting IE settings and obtaining proxy configuration; expect the IE settings as shown in the figure below.

The automatic detect settings and Use automatic script options are not supported in this release. In AUTO_DETECT mode, the address and port values set in the application object are ignored.

Example configuration: 

 

Using Vidyo Communicator for WDE

With the release of VidyoEngage for Genesys version 18.2.0.2, you can utilize the Vidyo Communicator for the invite expert as a replacement for the standard Genesys Team Communicator. When you set the following: custom.vidyo-communicator-enabled=true; the Vidyo communicator will open and display a list of available agents, capable of handling Vidyo and instant messaging interactions.

For detailed operations, refer to the Genesys User Guide Document 06.

 

Enabling Vidyo Session Reporting

This feature is available with the VidyoEngage for Genesys 18.2.0.2 version and allows the Vidyo session reporting to create outbound interactions with media type Vidyo. When the Vidyo session is established, an interaction is created and when the session is stopped; the outbound interaction is additionally stopped. For more information and event flows: refer to the User’s Guide document 06.

The “vidyo.outbound-enable-use=true” enables WDE to create outbound Vidyo interaction. When you set the option to “vidyo.outbound-enable-use” = true, there must be another mandatory option set as, “vidyo.outbound-queue”. The value of this option must contain the name of the Interaction Queue for Vidyo outbound interactions. Use Genesys Administrator to create this queue.

Creating an Outbound Queue

By default, the name of the outbound Vidyo queue in WDE is set to VidyoOut. If the vidyo.outbound-queue is not set, it is possible to create VidyoOut queue and a new outbound interaction will be created by WDE. Use the following steps:

      • From the Admin access, open the Genesys Administrator.
      • Navigate to PROVISIONING -> Routing/eServices -> Interaction Queues.
      • Click the New button and then set the queue name to VidyoOutQueue.

      • Set the option to vidyo.outbound-queue=VidyoOutQueue
      • Start the WDE and then login to Vidyo channel

 

Installing the Vidyo Server

The vidyo server is a Java application without installation scripts. The installation and startup begin by unzipping the installation package into the desired folder and running the startup script.

The server itself is running on top of embedded Tomcat worker.

Vidyo Server Binaries

On Windows, copy the VidyoServer-<release version>.zip Vidyo Server jar file to the C:\GCTI\VidyoServer target directory. Extract all files.

On Linux, copy the VidyoServer-<release version>.zip Vidyo Server jar file to the /opt/gcti/vidyo/vidyoserver target directory. Extract all files.


Creating the Keystore File for Tomcat

The Keystore of Tomcat is required for https communication. For testing purposes, it is possible to create a self-signed certificate keystore. This keystore will then be set into the startup command of the VidyoServer.

The self-signed certificate can be produced by the Java keytool command. More information about the tool can be found here: https://docs.oracle.com/javase/8/docs/technotes/tools/unix/keytool.html.

 

For the production environment, it is required to use a certificate validated by a Certificate Authority such as Verisign or GoDaddy.

 

To create the Keystore file for Tomcat:

      1. Navigate to the JDK bin directory.

      2. Execute keytool-genkey-alias tomcat-keyalg RSA-keystore keystore.jks.

        • At the prompts, enter the default values.
        • When prompted for the password, use "changeit".

      3. Copy the new keystore.jks file to the VidyoServer installation folder or reachable by VidyoServer.

        • Windows directory C:\GCTI\vidyo\vidyoserver
        • Linux directory /opt/gcti/vidyo/vidyoserver

The keystore location is controlled by startup option “--server.ssl.key-store”. More details about startup see in chapter Start Vidyo Server from Command Line.

Windows and Linux Java keystore generate procedure doesn't differ.

For test purposes, it is possible to use the http port of the Vidyo server. The Web Widgets needs to be configured to open communication to the http port instead of https.

 

Encrypting the Configuration Server Password

The Vidyo Server installation comes with the configuration file config-server-user.properties. It allows use of customized credentials to log in to the configuration server. The default is the “default” user with the default password set. By using the configuration file, the username can be changed and the password will be encrypted.

The following files from the VidyoServer zip file are required:

      • gaa-pass-util.jar
      • config-server-user.properties

To create a configuration server encrypted password:

      1. Open the command window.

      2. Execute the password utility with syntax-java-jar gaa-pass-util.jar <password plain text>
        The output is the encrypted password.

        For Example:
        java-jar gaa-pass-util.jar password

        Outputs:
        "password" > "+3Ir7ICPbZWcwUodfTKbtMw=="

      3. Copy the output within quotes (e.g. +3Ir7ICPbZWcwUodfTKbtMw==) to the password value field within the properties file.

      4. Copy the properties file to the Vidyo Server executing directory.

      5. Restart the Vidyo Server.

<path-to-JDK> - the path to the Java development kit.

<password plain text> - the password configured for the user in the Genesys configuration server. 

Starting the Vidyo Server from the Command Line

If you plan to deploy the Vidyo Server as a Windows service; you can refer to the section, "Setting Options in the config-server-user.properties" to set the configuration into file. Then, refer to the steps in the section, "Add Windows Service instructions".

Navigate to Vidyo Server installation folder and use the following command line to start the Vidyo Server:

start <JDK bin directory>\java -Dfile.encoding=UTF-8 -jar VidyoServer-<version>.jar
--host="<cfg_p_ip_address>" --port="<cfg_p_port>" --host_standby="<cfg_b_ip_address>" --port_standby="<cfg_p_port>"
--server.port="9032" --server.ssl.key-store="<absolute-path-to-keystore>"
--custom.tomcat.connector.http.port="9030"

 

Different ports are used for HTTP and HTTPS. Set the ports the same as configured in the application object from the "Adding an Application Template" section.


<JDK bin directory> - is the Java JDK directory

<cfg_p_ip_address> - is the IP address of Genesys configuration server primary

< cfg_p_port> - is the port of the Genesys configuration server primary

<cfg_b_ip_address> - is the IP address of the Genesys configuration server backup

< cfg_b_port> - is the port of the Genesys configuration server backup

<absolute-path-to-keystore> - is the path to the generated keystore

 

Creating a Windows Startup File

Create the file VidyoServer.bat and paste options below to it:

<JDK bin directory>\java -jar VidyoServer-<version>.jar --host="<cfg_p_ip_address>" --port=
"<cfg_p_port>" --host_standby="<cfg_b_ip_address>" --port_standby="<cfg_b_port>"
--custom.tomcat.connector.http.port="9030" --server.port="9032" --server.ssl.key-store="<absolute-path-to-keystore>"

Creating a Linux Startup File

Create the file vidyoserver.sh and paste the options below to it:

<JDK bin directory>\java -jar VidyoServer-<version>.jar --host="<cfg_p_ip_address>"
--port="<cfg_p_port>" --host_standby="<cfg_b_ip_address>" --port_standby="<cfg_b_port>"
--custom.tomcat.connector.http.port="9030" --server.port="9032" --server.ssl.key-store="<absolute-path-to-keystore>"

Setting Options in the config-server-user.properties

The Vidyo Server from VidyoEngage for Genesys version 18.1 allows you to specify startup options in the config-server-user.properties. This will enable Vidyo Server monitoring in the Genesys management layer as a Third Party Server application.

The Vidyo Server startup configuration may look like the example below after moving the  configuration items from the command line to the file.

Startup command line:

c:\Java\jdk1.8.0_121\bin\java -jar VidyoServer-18.1.0.0.jar --app_name=vidyo-server-win

Configuration file:

# Place this file in the VidyoServer working directory.

# Use gaa-pass-util.jar to generate an encrypted passwords.

#configuration server

host=192.168.2.129

port=2020

username=default

password=+3Ir7ICPbZWcwUodfTKbtMw==

#tls properties

tls.certificate=c:\\GCTI\\VidyoServer\\conf\\02_appsrv6_cert.pem

tls.certificate-key=c:\\GCTI\\VidyoServer\\conf\\02_appsrv6_priv_key.pem

tls.trusted-ca=c:\\GCTI\\VidyoServer\\conf\\02.pem

tls.mode=NONE

#tomcat properties

custom.tomcat.connector.http.port=8070

server.port=8773

#keystore properties

server.ssl.key-store=C:\\GCTI\\VidyoServer\\keystore.jks

server.ssl.key-store-password=+Kly8MJjL0N6Zw0ggm6WoJA==

server.ssl.key-password=+Kly8MJjL0N6Zw0ggm6WoJA==

By setting --app_name into command line parameters, it will be easier to monitor Vidyo Server as Third Party application in Genesys Administrator.

Starting the Vidyo Server as a Service

Create a Windows Service to control the Vidyo Server application.

Add a Service with Windows

The VidyoEngage for Genesys release 18.3 and above contains the Vidyo server install package: VidyoServerService.exe.  You can easily start and stop the Vidyo Server with this executable along with the Vidyo Server jar file. Optionally it is still possible to use nssm Tool for installation of Vidyo server, see below for "Adding a Service Using the nssm Tool.

To add a service with Windows:

  1. Open the command window as a user Administrator.

  2. Run the command: 

    sc create VidyoServer binPath= "<path-to-VidyoServerService.exe>"


    Create_Windows_Service.png

Configuring the Service Startup Parameters

In order for the Windows service to start the Java process, it is required to locate the Java.exe and Vidyo Server install directory. It will be set in “appSettings” of Windows service configuration file VidyoServerService.exe.config.

<appSettings>

    <add key="javaPath" value="<absolute-Path-To-Java.Exe>" />

    <add key="workingDir" value="<absolute-path-to-VidyoServer-directory>" />

    <add key="jarFile" value="<Vidyo-Server-Jar-name>" />

    <add key="attributes" value="<startup-attributes>" />

    <add key="adminport" value="<vidyo-Server-admin-port>" />

    <add key="servicename" value="<vidyo-Server-service-name>" />

  </appSettings>

 

Absolute-Path-To-Java.Exe – This is the path to java.exe used to run VidyoServer jar file. It is  recommended to use JDK 1.8.

Absolute-path-to-VidyoServer-directory – This path is the directory to where the VidyoServer jar file is located.

Vidyo-Server-Jar-name – This is the Vidyo Server jar file name.

Attributes – The Vidyo Server startup attributes (same as previously used with the bat file). This option can be empty, if the attributes are specified in config-server-user.properties).

Vidyo-Server-admin-port – This is a management port and has the same number as configured at the Vidyo Server.  The Service shutdown is the client of the Vidyo Server management port and then sends the request to perform the shutdown on stop.

Vidyo-Server-service-name – This is the service name set in “sc create” command previously

Example:

<appSettings>

    <add key="javaPath" value="c:\Java\jdk1.8.0_121\bin\java.exe" />

    <add key="workingDir" value="c:\GCTI\VidyoServer\" />

    <add key="jarFile" value="VidyoServer-18.3.0.2.jar" />

    <add key="attributes" value="" />

    <add key="adminport" value="6543" />

    <add key="servicename" value="VidyoServer" />

  </appSettings>

It is recommended to move the attributes into the config-server-user.properties. Refer to Setting Options in config-server-user.properties. This results in better application monitoring purposes.

 

Setting up the Startup Service Logger

This step is optional and is only for debugging purposes. You can set the logger of service and then capture the early phase of the Vidyo Server startup before the jar file is executed. Refer to the below example:

<log4net>

    <appender name="DebugFileAppender" type="log4net.Appender.RollingFileAppender">

      <file value="VidyoServerService.log" />

      <appendToFile value="true" />

      <rollingStyle value="Size" />

      <encoding value="utf-8" />

      <maximumFileSize value="10MB" />

      <maxSizeRollBackups value="10" />

      <staticLogFileName value="true" />

      <layout type="log4net.Layout.PatternLayout">

        <conversionPattern value="%date{yy-MM-dd HH:mm:ss.fff} [%14.14thread] %-5level %20.20logger - %message%newline" />

      </layout>

    </appender>

    <root>

      <level value="INFO" />

    </root>

    <logger name="VidyoServerService">

      <level value="ALL" />

      <appender-ref ref="DebugFileAppender" />

    </logger>

  </log4net>

Set  <file value="VidyoServerService.log" />  to file name or absolute path to file.

In Logger tag

<logger name="VidyoServerService">

      <level value="ALL" />

      <appender-ref ref="DebugFileAppender" />

    </logger>

Change “level” value to one of supported values from list. More details can be found in article log4net introduction chapter Logger Hierarchy.

Uninstalling the Windows Service

To Uninstall the Windows Service, follow these steps:

  1. Open a Windows command line as an Administrator.
  2. Run the service commander command "sc delete "
  3. Delete the files from the Vidyo Server service install folder.

    Uninstall_Windows_Service.png

Adding a Service Using the nssm Tool

This step is not required if the service has been added using the service commander for Vidyo Server version 18.3 and higher.

Windows 

  1. If this file does not exist yet, create the VidyoServer.bat file according to procedure above, "Starting the Vidyo Server from Command Line".
  2. Open a command window as an Administrator.
  3. Run the command: nssm install "VidyoServer".
  4. If the nssm is not installed, 1.) Download it from http://nssm.cc/download 2.) Extract it in a folder, and then 3.) In the command window, go to the {extracted folder}\win32\ or {extracted folder}\win64\.
  5. Run the command: nssm install "VidyoServer"
  6. For the 'Path', browse and then select VidyoServer.bat with full path.
  7. Press the Install Service button and then the new service will appear in Windows services.

Linux

It is not necessary to install Linux service. The startup command just needs to be changed to run after console is closed. Do one of the following:

  • Add & sign at the end of visyoserver.sh command
  • Or run ./vidyoserver.sh & from Linux terminal

The process will remain started after the console is closed. It is possible to check if the process is running by executing ps –ef | grep vidyo command.

Vidyo Server Startup Command Line Attributes Reference 

 

Option Description Valid Default
host Genesys primary configuration server hostname or FQDN String N/A
port Genesys primary configuration server port number Positive Integer N/A
host_standby Configuration server backup hostname or FQDN String N/A
port_standby Configuration server backup port Positive Integer N/A
app_name Vidyo server application object name from Genesys configuration String VidyoServer
startup.log File path to startup log file. If this value is not set, Vidyo server writes log to console; Log file value is appended with time stamp suffix and log extension Absolute path to log file N/A
startup.loglevel Level of details to be written into log ALL, DEBUG, FATAL, INFO, OFF, TRACE, WARN INFO
startup.logfilter Filter for string expression to be removed from log records Comma separated list of strings N/A
custom.tomcat.
connector.http.port
Vidyo server http port. Server will open this port for listening after startup Positive Integer 8080
server.port Vidyo server https port. Server will open this port for listening after startup and correct keystore validation Positive Integer 8443
server.ssl.key-store Path to keystore file Absolute path to file keystore.jks
server.ssl.key-store-password Password to keystore String changeit
server.ssl.key-password Password to keystore key String changeit
tls.certificate File path to PEM certificate valid for Vidyo Server and Genesys backend components Absolute File Path N/A
tls.certificate-key File path to PEM certificate key valid for Vidyo Server and Genesys backend components Absolute File Path N/A
tls.trusted-ca File path to PEM certificate authority valid for Vidyo Server and Genesys backend components Absolute File Path N/A
tls.mode Genesys configuration server TLS mode upgrade, tls, tls-mutual, none none
tls.crl File path to certificate revocation list valid for Vidyo Server and Genesys backend components. This setting is optional Absolute File Path N/A
tls.sec-protocol TLS security protocol used for secured communication. This setting is optional. SSLv23, SSLv3, TLSv1, TLSv11, TLSv12 N/A

adminport

Note: New Form release 18.3.0.2
Vidyo Server administrative port used for graceful shutdown of server from windows service stop procedure. It is used only in case if windows service is installed from VidyoServerService.exe. See procedure above for "Adding a Windows Service" Positive integer N/A

servicename

Note: New Form release 18.3.0.2
Windows service name in case of service wrapper based installation, it will be set automatically on startup. For nssm it must be set manually. String N/A

 

For setting secured communication between Genensys and Vidyo Server, follow the instructions in the Genesys Security Guide. The Genesys backend components must be enabled with TLS, and valid PEM certificates are a mandatory prerequisite for this feature.

 

Monitoring of the Vidyo Server - Application Object Updates

For better application monitoring of the Vidyo Server, update the application object of the Vidyo Server with the startup command line. The command line attributes contain information about java processes. This step is optional and improves the application monitoring for cases such as:

  • When startup sequence of the Vidyo Server is broken and the Vidyo Server doesn't report LCA proactively
  • When the Genesys backend restarts or loses connection to a management layer

This setting allows the Genesys management layer to monitor Java process directly similarly as it does for third party applications monitoring. If this setting is not performed, Vidyo Server monitoring will work; hence the Vidyo Server does proactively inform the Genesys Management layer about the start of the event.

The Genesys management layer stores this information into memory for further monitoring. To enable LCA refresh information about process during its runtime or unpredicted shutdown, it is recommended to set the information about the startup command line to the Genesys application object.

To set the application monitoring, follow the steps below:

  1. Open the Vidyo Server application object.
  2. Navigate to the Server Info tab.
  3. Set the Working Directory to the Java executable directory which is used to run the Vidyo Server.
  4. Set the command line to java.exe.
  5. Set the command line attributes as it is set in the startup file (bath or service configuration file).

    monitoring_the_vidyo_server.png

The same parameters are configured in the Windows service VidyoServerService.exe.config “<appSettings>” “javaPath”, “jarFile”, and “servicename”. The startup command is shown in the service startup log.

DEBUG   VidyoServerService - Vidyo Server startup=c:\Java\jdk1.8.0_121\bin\java.exe  -jar VidyoServer-18.3.0.2.jar --servicename=VidyoServer

Caution: The parameter --servicename is added to the startup attributes automatically by the Windows service wrapper when the VidyoServerService.exe wrapper is used. For nssm, it must be added manually to the bath startup file.

 

Using the Vidyo Server Health Information Tab

The Vidyo Server application in Genesys is monitored as a third party server. The management layer monitors whether the process is either up or down only. The Vidyo Server Health Information tab allows the administrator to see whether the Vidyo Server interfaces are working and what is the status of the connected application servers.

Navigate to <protocol>://<FQDN>:<port>/VidyoServer/service/HealthInformation/

For <protocol>://<FQDN>:<port>/ use the attributes from the configured Vidyo Server.

In the Health Information page, an administrator can see information about the Vidyo Server status, version from the management layer, and the version of the binary, and additionally the status of connected services. Please refer to the screen shot below. 

Health_Information_tab.png

Vidyo Server Status 

  • Application Status, reflect status populated by Genesys backend
  • Service Status, is internally evaluated by Vidyo Server in following logic:
    • Running, IXN and ORS is running and all connections are in status Opened
    • ServiceUnavailable, one of connections Is closed, ORS or IXN server are not operating.

Server Connections Status

  • Monitors status of TCP/IP connections established between Vidyo Server and Genesys Backend.
  • This reflects the status provided by Genesys Backend Management layer.

Application Server Status

  • Monitors all application servers directly involved in click to Vidyo Session creation (not only TCP/IP)
  • Provides information about current status and run mode
  • This reflects the information provided by the solution control server.

To get health information vidyo server must be connected to Solution Control Server genesys backend component. If SCS is disconnected UNKNOWN and SERVICE UNAVAILABLE status will be reported in health Information or no components will be listed in view. 

 

Installing the Workspace

The Workspace may be deployed as either a ClickOnce package or as a local installation.The workspace desktop plugin installation package contains the Vidyo plugin along with the tested WDE versions 8.5.122.xx and 8.5.117.xx. Consult with the Vidyo Support team prior to installing the Vidyo plugin with any other WDE versions that may differ from the supported WDE versions noted above.

Installing the Workspace Using ClickOnce

ClickOnce is a Microsoft technology that enables the user to install and run a Windows-based smart client application by clicking a link in a web page. ClickOnce is a component of Microsoft .NET Framework 2.0 and later, and supports deploying applications made with Windows Forms or Windows Presentation Foundation. For more information about deployment with ClickOnce, see https://msdn.microsoft.com/en-us/library/142dbbz4(v=vs.90).aspx.

The information below supplements the Workspace Deployment Guide instructions.

To install the Workspace using ClickOnce:

      1. Copy the following files into the execution directory for the Workspace:

        • Desktop.Modules.CustomVidyo.dll
        • Desktop.Modules.CustomVidyo.module-config
        • VidyoClientDll.dll.config (starting with version 18.1.0; for older versions, follow the merge procedure explained in the "InteractionWorkspace.exe.config Merge Procedure" section later in this article)
        • VidyoClientDll.dll
        • ca-certificates.crt
        • ca-certificates-base.crt
        • "Languages" folder with file Genesyslab.Desktop.Modules.CustomVidyo.en-US.xml 
        • "Snapshots" folder with file Default.bmp and sub-folder "tmp"

      2. Follow the ClickOnce deployment procedure in the Workspace Deployment Guide.

      3. Package the Information pane by selecting the Add custom files checkbox on the Customization page.

      4. Add the Custom Files pane.

      5. Select the newly added custom files from the Workspace execution directory.

      6. Continue with the ClickOnce deployment procedure.

 

Installing the Workspace Locally

      1. Find your local WDE installation folder and make a backup.

      2. Copy the following files into the execution directory for the Workspace:

        • Genesyslab.Desktop.Modules.CustomVidyo.dll
        • Genesyslab.Desktop.Modules.CustomVidyo.module-config
        • VidyoClientDll.dll.config (starting with version 18.1.0; for older versions, follow the merge procedure explained in the "InteractionWorkspace.exe.config Merge Procedure" section later in this article)
        • VidyoClientDll.dll
        • ca-certificates.crt
        • ca-certificates-base.crt
        • "Languages" folder with file Genesyslab.Desktop.Modules.CustomVidyo.en-US.xml 
        • "Snapshots" folder with file Default.bmp and sub-folder "tmp"

      3. Run the WDE and check whether the Vidyo Dll plugin was loaded successfully.

      4. Locate the WDE startup log file and search for the “INFO dows.LoginController - Module CustomModuleVidyo initialized” string.

 

InteractionWorkspace.exe.config Merge Procedure

To insert new options relevant for Vidyo into InteractionWorkspace.exe.config: 

      1. Back up InteractionWorkspace.exe.config delivered with WDE.

      2. Open the InteractionWorkspace.exe.config file in a text editor.

      3. Open InteractionWorkspace.exe.config delivered with the Vidyo Adapter plugin package:

        • Copy content after tag “<!-- Vidyo -->”, content of <startup> and < system.serviceModel > tags.

      4. Paste it into InteractionWorkspace.exe.config from WDE release after tag </runtime>.

      5. Save InteractionWorkspace.exe.config and start WDE.

 

The InteractionWorkspace.exe.config merge procedure is not required starting with Vidyo Adapter release 18.1.0. The vVidyo client plugin configuration is stored in a separate file VidyoClientDll.dll.config. The VidyoClientDll.dll.config file must be copied with installation package filed into WDE directory, as is explained in the "Installing the Workspace Locally" section in this article.

 

 

Installing the Web Widgets

The sample widgets are located in the “WebIntegrationSamples” folder. The file contains standalone widgets developed by Vidyo for installation at a clean application server.

 

Web Widgets

The files are released in a package starting from release 17.2.1 “WebIntegration_Vidyo_17.2.1.0_09112017.zip” and later support Standalone samples.

Unpack the content of file “WebIntegration_Vidyo_18.1.0.3_01312018.zip” into a temporary folder. It will contain:

      • webclient_rest_simple.war (simple RESTFull click to Vidyo web widget sample)
      • webclient_websocket.war (websocket click to Vidyo web widget sample)
      • webclient_rest.war (RESTFull click to Vidyo web widget sample)
      • chattovidyo.war (WEB-API based chat to Vidyo widget sample)
      • >ve4gchat.war (sample Vidyo thin client based on chattovidyo sample)

Select the desired application sample and deploy it to Apache Tomcat.

Windows

Click to Vidyo REST and REST Simple

      1. Navigate to the web apps folder C:\GCTI\vidyo\websrv\webapps.

      2. Copy the webclient_rest.war into C:\GCTI\vidyo\websrv\webapps.

      3. Navigate to C:\GCTI\vidyo\websrv\bin.

      4. Run the startup.bat file in the command line.
        The startup sequence must show both war packages deployed successfully to the webapps Tomcat folder.

        Widgetswebappstomcat.png

      5. After Tomcat is started and the web application is deployed, navigate to C:\GCTI\vidyo\websrv\webapps\webclient_rest\ js\ve4gclick.js.

      6. Find var _server_service_uri="https://<server>:<port>/VidyoServer/service/".

      7. Open a web browser and navigate to http://<websrvhost>:9020/webclient_rest.
        The expected result is a test web client application as shown below.

VidyoRESTresult.png 

<server> - vidyo server hostname

<port> - vidyo server port http (9030) or https (9032)

<websrvhost> - web server hostname

 

Click to Vidyo WEBSOCKET

      1. Navigate to the web apps folder C:\GCTI\vidyo\websrv\webapps.

      2. Copy the webclient_websocket.war into C:\GCTI\vidyo\websrv\webapps.

      3. Navigate to C:\GCTI\vidyo\websrv\bin.

      4. Run the startup.bat file in the command line.

      5. After Tomcat is started and the web application is deployed, navigate to C:\GCTI\vidyo\websrv\webapps\webclient_websocket\ js\ve4gclick.js.

      6. Find var _server_uri="https://<server>:<port>/VidyoServer".

      7. Open a web browser and navigate to http://<websrvhost>:9020/webclient_websocket.
        The expected result is a test web client application as shown below.

 VidyoWEBSOCKETresult.png

Chat to Vidyo

      1. Navigate to the web apps folder C:\GCTI\vidyo\websrv\webapps.

      2. Copy the chattovidyo.war into C:\GCTI\vidyo\websrv\webapps.

      3. Navigate to C:\GCTI\vidyo\websrv\bin.

      4. Run the startup.bat file in the command line.

      5. After Tomcat is started and the web application is deployed, navigate to chattovidyo\WEB-INF\classes\WebAPIServer.properties and set the webapi interface properties:
        • webAPISrvHost=<appsrv6>
        • webAPISrvPort=<6080>
        • webAPICntxPath=<webapi>

      6. Save the file.

      7. Stop Tomcat by executing shutdown.bat in the C:\GCTI\vidyo\websrv\bin folder.

      8. Stop Tomcat by executing startup.bat in the C:\GCTI\vidyo\websrv\bin folder.

      9. Open a web browser and navigate to http://<websrvhost>:9020/chattovidyo.
        The expected result is a test web client application as shown below.

 VidyoCHATresult.png

Ve4g CHAT

      1. Navigate to the web apps folder C:\GCTI\vidyo\websrv\webapps.

      2. Copy ve4gchat.war into C:\GCTI\vidyo\websrv\webapps.

      3. Navigate to C:\GCTI\vidyo\websrv\bin.

      4. Run the startup.bat file in the command line.

      5. Open a web browser and navigate to http://<websrvhost>:9020/ve4gchat.
        The expected result is a test web client application as shown below.

Ve4gCHAT.png

 

Linux

Click to Vidyo REST and REST Simple

      1. Navigate to the web apps folder /opt/gcti/vidyo/websrv/webapps.

      2. Copy webclient_rest.war into /opt/gcti/vidyo/websrv/webapps.

      3. Navigate to /opt/gcti/vidyo/websrv/bin.

      4. Run the startup.sh file in the command line.

      5. After Tomcat is started and the web application is deployed, navigate to /opt/gcti/vidyo/websrv/webapps/webclient_rest/js/ve4gclick.js.

      6. Find var _server_service_uri="https://<server>:<port>/VidyoServer/service/";.

      7. Open a web browser and navigate to http://<websrvhost>:9020/webclient_rest.
        The expected result is a test web client application as shown below.

 Linux.png

<server> - vidyo server hostname

<port> - vidyo server port http (9030) or https (9032)

<websrvhost> - web server hostname

 

Click to Vidyo WEBSOCKET

      1. Navigate to the web apps folder /opt/gcti/vidyo/websrv/webapps.

      2. Copy the webclient_websocket.war into /opt/gcti/vidyo/websrv/webapps.

      3. Navigate to /opt/gcti/vidyo/websrv/bin.

      4. Run the startup.sh file in the command line.

      5. After Tomcat is started and the web application is deployed, navigate to /opt/gcti/vidyo/websrv/webapps/webclient_websocket/js/ve4gclick.js.

      6. Find var _server_uri="https://<server>:<port>/VidyoServer".

      7. Open a web browser and navigate to http://<websrvhost>:9020/webclient_websocket.
        The expected result is a test web client application as shown below.

 VidyoWEBSOCKETresultLinux.png

Chat to Vidyo

      1. Navigate to the web apps folder /opt/gcti/vidyo/websrv/webapps.

      2. Copy chattovidyo.war into /opt/gcti/vidyo/websrv/webapps.

      3. Navigate to /opt/gcti/vidyo/websrv/bin.

      4. Run the startup.sh file in the command line.

      5. After Tomcat is started and the web application deployed, navigate to chattovidyo\WEB-INF\classes\WebAPIServer.properties and set webapi interface properties:
        • webAPISrvHost=<appsrv6>
        • webAPISrvPort=<6080>
        • webAPICntxPath=<webapi>

      6. Save the file.

      7. Stop Tomcat by executing shutdown.sh in the /opt/gcti/vidyo/websrv/bin folder.

      8. Stop Tomcat by executing startup.sh in the /opt/gcti/vidyo/websrv/bin folder.

      9. Open a web browser and navigate to http://<websrvhost>:9020/chattovidyo.
        The expected result is a test web client application as shown below.

VidyoCHATresultLinux.png


Ve4g CHAT

      1. Navigate to the web apps folder /opt/gcti/vidyo/websrv/webapps.

      2. Copy ve4gchat.war into /opt/gcti/vidyo/websrv/webapps.

      3. >Navigate to /opt/gcti/vidyo/websrv/bin.

      4. Run the startup.sh file in the command line.

      5. Open a web browser and navigate to http://<websrvhost>:9020/ve4gchat.
        The expected result is a test web client application as shown below.


Ve4gCHAT2.png

Installation Start/Stop

The solution start and stop consists of starting dependencies at the Genesys side and the perform start of the Vidyo adapter components.

Prerequisites

The prerequisites must be prepared by Genesys experts at the customer side. This documentation doesn’t provide instructions on how to deploy all the Genesys dependencies.

      1. Started Genesys Components

        • IXN server
        • URS
        • ORS
        • Chat
        • Stat Server
        • WEB-API server
        • UCS
        • TServer SIP

      2. Open media ORS solution must be configured to route multimedia interactions with URS.

      3. Click to Vidyo solution is configured with Vidyo Server.

      4. Chat to Vidyo application is deployed and configured to connect to the web-api server.

      5. Agents are configured to handle vidyo, voice, and chat interactions.

Vidyo Server

Windows

Vidyo Server Windows Service

If the Vidyo Server configured as a Windows service, go to services and find the service named VidyoServer. Start the Vidyo Server service and check the log file created after the Vidyo Server service is started successfully.

Stop the Vidyo Server by stopping the corresponding service.

Vidyo Server Command Line

Starting the Vidyo Server from the command line is done by executing a prepared bat file. The Vidyo Server does write console startup logs before it is connected to the Genesys configuration server platform. If something is going wrong in the early startup phase, it will be visible only in the console logs.

Stop the Vidyo Server by cancelling the job in the command line or by closing the command line window.

 

Before starting the Vidyo Server from the command line, make sure it is not already started as a service.

 

Linux

The Vidyo Server service is not available for Linux installations. The server is always started from the command line.

VidyoServer Command Line

Starting the Vidyo Server from the command line is done by executing the prepared .sh file. The command line startup log is written to the console. After the Vidyo Server is started and connected to the Genesys platform, the Vidyo Server starts the write log file.

Stop the Vidyo Server by terminating the Vidyo Server process. Apply the following commands:

      • Ps –ef | grep vidyo
        Output from this command will provide process ID <pid>.

      • kill -9 <pid>
        Use the process id <pid> in the Linux kill command.

 

ORS Web Server

Windows

Start Tomcat:

      1. Navigate to c:\CGTI\vidyo\orsweb\bin.

      2. Execute startup.bat.

      3. Check the console for errors.

      4. Navigate to http://<server>:9010 and check if ORS tomcat is running.

 Stop Tomcat:

      1. Navigate to c:\CGTI\vidyo\orsweb\bin.

      2. Execute shutdown.bat.

Linux

Start Tomcat:

      1. Navigate to /opt/gcti/vidyo/orsweb/bin.

      2. Execute startup.sh.

      3. Check the console for errors.

      4. Navigate to http://<server>:9010 and check if ORS tomcat is running.

 Stop Tomcat:

      1. Navigate to /opt/gcti/vidyo/orsweb/bin.

      2. Execute shutdown.sh.

Web Widgets Server

Windows

Start Tomcat:

      1. Navigate to c:\CGTI\vidyo\websrv\bin.

      2. Execute startup.bat.

      3. Check the console for errors.

      4. Navigate to http://<server>:9020 and http://<server>:9023 to check if web tomcat is running.

 Stop Tomcat:

      1. Navigate to c:\CGTI\vidyo\websrv\bin.

      2. Execute shutdown.bat.

Linux

Start Tomcat:

        1. Navigate to /opt/gcti/vidyo/websrv/bin.

        2. Execute startup.sh.

        3. Check the console for errors.

        4. Navigate to http://<server>:9020 and http://<server>:9023 to check if websrv tomcat is running.

 Stop Tomcat:

        1. Navigate to /opt/gcti/vidyo/orsweb/bin.

        2. Execute shutdown.sh.

 

After the startup procedure of all servers is finished, Click to Vidyo and Chat to Vidyo escalation use cases are ready.

 

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.