Page Comparison

...

The purpose of the VFC to WFE Metadata Integrator tool is to import call metadata, supported by switch platform and user data, from the VFC platform to the Verint v15V15.2 Workforce Engagement (WFE) suite. Once imported, the data is available for use by certain applications within the WFE suite. The Integrator continuously verifies the data in both VFC and WFE and carries out a one-way synchronization periodically.

...

• Avaya DMCC/MR
• Cisco Network Based
• IPC Unigy
• IP Trade
• Zoom Meeting
• Zoom Phone

Minimum software version

• VFC Capture 9.7.7 or higher
• Workforce Engagement v15V15.2

Concepts and functionality

...

The Integrator connects to the VFC Media Repository through API calls to gather system information and sets up an SQL connection to the VFC database to read in the data to synchronize. The Integrator communicates with WFE services and sends data to the WFE database using API calls.

Image RemovedImage Added

The Integrator supports the following deployments:

...

* Multi-tenant cloud VFC deployments are supported if each tenant has its own Integrator configured.

Image RemovedImage Added

The Integrator must be installed on a VFC server. Only one Integrator can be installed on a single server.

When the Integrator first runs, it creates its editable configuration file, appsettings.<environmentName>.json. All connection details are specified in this file, along with parameters to monitor and optimize the synchronization process. The default value of environmentName is Production, otherwise, if configured, the value matches the DOTNET_ENVIRONMENT environment variable configured on the server. Any references to appsettings.Production apply to this file.

...

You must also manually create a parent WFE group that holds all groups of VFC synchronized employees, and the name must be added to the Integrator configuration.

Under the parent group, a default group holds all individual VFC synchronized employees, regardless of what VFC groups those employees belong to. On the same hierarchical level, under the parent group, the WFE groups matching the VFC groups get automatically created by the integrator. They retain their VFC names, with the configured name prefix.

Image RemovedImage Added

Changes to users or groups that happen in VFC are applied to their WFE equivalent the next time the synchronization process runs. Changes to users or groups that happen in WFE do not apply to their VFC equivalents. If conflicting information exists in VFC and WFE, the changes in WFE are overridden the next time the synchronization process runs. However, if a non-VFC user is manually added to any of the WFE groups representing a synchronized VFC group, the user is not removed the next time the synchronization process runs.

...

To synchronize the required recording datametadata, the switch platforms for which the Integrator is configured must be specified in the appsettings.Production file of the Integrator.

The supported list of switch platforms is listed in the configuration file. The integration process does not run until one or more of the Integrator supports the synchronization of metadata from:

• recorded switch platforms, and
• import sources, where VFC does not record the calls, but it ingests the recordings from the switch platform through the configured import source.

The list of supported switch platforms is listed in the configuration file, specifying the platform IDs or import source types, and the platform type that describes the WFE data source type of the platform. The integration process does not run until one or more of the supported platforms is added to the list of configured platforms in the file.

...

• the VFC Recording Server addresses,
• the platform name, describing the platform ID or import source type of the switch,
• the time zone of the switch,
• optionally, the extensions configured for that switch platform.

...

A data source object in the appsettings.Production file can only be of one platform type name, and it must be in a single time zone. However, it can represent multiple switches of the same platform typename, in the same time zone, being recorded by one or more VFC recorders. If the extensions are configured for the data source object, the specified extension numbers are associated to the WFE data source upon creation.

The extension parameter can be omitted or left empty for a data source object, which results in all extensions recorded by the specified recorders on the specified platform type name to be associated with that data source. The extensions can be configured as an array of individual alphanumeric values or number ranges, but do not support wildcard operators.

If multiple identical data source objects exist in the appsettings.Production file without extension values specified, extensions for that platform type name are associated with the each WFE data source described by the first object.

If multiple data source objects exist in the appsettings.Production file without extensions specified but different platform types names are set for them, extensions configured to record all platform types platforms are associated to each data source.

...

Image RemovedImage Added

If a platform type name has been added to the Configured Platforms parameter, but no data source objects exist in the Data Mapping section, no corresponding WFE data source is created, and no related recording data is synchronized to WFE.

...

...

• It has the same name as the data source platform name configured in the DataMapping section of the appsettings.Production file.
• Its Type is Phone.
• Its Switch/sub-type is External Recorder.
• The Organization associated with the data source The Type matches the platform type associated with the platform name specified in the ConfiguredPlatforms parameter of the appsettings.Production file. 
• The Switch/sub-type is External Recorder.
• The Organization associated with the data source matches the organization ID of the parent organization created as part of the Integrator deployment process.

...

Recorders and call metadata

The Integrator synchronizes recording metadata to WFE by periodically checking the VFC database for new recording data and marking them for synchronization. Call marking is the process of reading in a call record from the database, evaluating it against the Integrator configuration, and sending it to the WFE database.

The Integrator only synchronizes recording metadata, not media files.

Each VFC installation is represented as a single recorder in WFE, and all synchronized call records get associated with this recorder, regardless of the number of distinct VFC recorders that captured the calls. Recorder servers in WFE are identified by a serial number that is automatically generated when the recorder is created. You must manually create an external recorder server in WFE for each VFC installation, and assign it a Serial Number that is unique to a VFC Media Repository. This serial number must be added to the appsettings.Production file of each Integrator that connects to the Media Repository described by the external recorder server. Refer to Create an External Server in Workforce Engagement for more information on adding an external server.

Image Removed

The way calls are recorded and stored is different in VFC and WFE. Refer to Data models for more details on the VFC call data models, and see Contacts and Interactions for information about the WFE call data models.

Due to the difference in the call record handling, the call search and replay functionality also differs in VFC and WFE. To keep the call search experience consistent across both systems for VFC users, the Integrator retains the VFC call model in WFE.

In WFE, every record in the search results under Interactions represents a single session from the WFE call model. In VFC, every record in the search results under Conversations represents a single conversation entry (CDR) from the VFC call model.

Image Removed

If more than one record was created during a conversation, related records can be shown together by selecting the ellipsis (…) button on the record and selecting Show Related.

Image Removed

Image Removed

During the synchronization process, each VFC conversation is mapped to a WFE session, allowing for the WFE call search experience being the same as in VFC.

Image Removed

To maintain the Show Related functionality, sessions are related to contacts and associated records can be viewed when selecting a call record from the search results.

The call records originating from WFE remain unchanged and a single record in the Interaction search results still represents a single session.

Image Removed

If the time interval between the start time of the first segment of a call and the start time of the last segment is longer than 12 hours, the created sessions in WFE are not associated with the same contact.

Prerequisites

• To access the WFE APIs, port 80 or 443 must be open on the WFE Application Server(s) running the WFO_ProductionDomain_ProductionServer service for incoming communication from the Integrator.

Deployment process

The VFC to WFE Metadata Integrator deployment process requires configuration in the VFC and WFE environments before the installation of the Integrator. The configuration of the synchronization details is carried out in the appsettings.Production.json file of the Integrator tool after installation.

1. Install server certificates
2. Create a parent organization in Workforce Engagement
3. Create a parent group in Workforce Engagement
4. Create API key in Workforce Engagement for each WFE Tenant
5. Create a VFC API user account
6. Enable External Recorder data sources in Workforce Engagement
7. Create an External Server in Workforce Engagement
8. (optional) Enable AQS in Workforce Engagement
9. Install the Integrator
10. Configure the Integrator

Install server certificates

1. Open your browser in Administrator mode and go to your VFC Web Interface.
2. Follow the Server Certificates topic to download the server certificate for the VFC Media Repository server from the VFC Certificate Authority.
3. Install the downloaded certificate on the server that runs the Integrator service.

Create a parent organization in Workforce Engagement

1. In an on-premise or single-tenant WFE environment, sign in as Administrator. In a multi-tenant environment, sign in as Tenant Administrator.
2. Follow the Create an organization topic in the WFE User Management Guide to set up an empty organization for the synchronized VFC data.
3. Note the name of the organization created. You must enter the exact name in the appsettings.Production configuration file of each Integrator during the configuration process.

Create a parent group in Workforce Engagement

1. In an on-premise or single-tenant WFE environment, sign in as Administrator. In a multi-tenant environment, sign in as Tenant Administrator.

2. Follow the Create a group topic in the WFE User Management Guide to set up an empty group for the synchronized VFC data.

   Info
   No users must be assigned to the created parent group, or the synchronization process fails.

3. Note the name of the group created. You must enter the exact name in the appsettings.Production configuration file of each Integrator during the configuration process.

...

The Seating Arrangement property of the created data source is set to:

• Hybrid for phone types,
• Free for trader and application types.

The Contact Policy Type of all created data sources is set to Back office - Contact per call.

The Recorded Platform property of the created data source is set to the value of the data source platform specified in the Integrator configuration file.

Recorders and call metadata

The Integrator synchronizes recording metadata to WFE by periodically checking the VFC database for new recording data and marking them for synchronization. Call marking is the process of reading in a call record from the database, evaluating it against the Integrator configuration, and sending it to the WFE database.

The Integrator only synchronizes recording metadata, not media files.

Each VFC installation is represented as a single recorder in WFE, and all synchronized call records get associated with this recorder, regardless of the number of distinct VFC recorders that captured the calls. The Integrator creates an external recorder server in WFE for each VFC installation. The Server Name of the external server must be specified in the appsettings.Production. It is recommended the Server Name matches the host name of the Media Repository the Integrator connects to.

The way calls are recorded and stored is different in VFC and WFE. Refer to Data models for more details on the VFC call data models, and see Contacts and Interactions for information about the WFE call data models.

Due to the difference in the call record handling, the call search and replay functionality also differs in VFC and WFE. To keep the call search experience consistent across both systems for VFC users, the Integrator retains the VFC call model in WFE.

In WFE, every record in the search results under Interactions represents a single session from the WFE call model. In VFC, every record in the search results under Conversations represents a single conversation entry from the VFC call model.

Image Added

If more than one record was created during a conversation, related records can be shown together by selecting the ellipsis (…) button on the record and selecting Show Related.

Image Added

During the synchronization process, each VFC conversation is mapped to a WFE session, allowing for the WFE call search experience being the same as in VFC.Image Added

Image Added

To maintain the Show Related functionality, sessions are related to contacts and associated records can be viewed when selecting a call record from the search results.

The call records originating from WFE remain unchanged and a single record in the Interaction search results still represents a single session.

Image Added

Deployment process

The VFC to WFE Metadata Integrator deployment process requires configuration in the VFC and WFE environments before the installation of the Integrator. The configuration of the synchronization details is carried out in the appsettings.Production.json file of the Integrator tool after installation.

1. Install server certificates
2. Create a parent organization in Workforce Engagement
3. Create a parent group in Workforce Engagement
4. Create API key in Workforce Engagement for each WFE Tenant
5. Create a VFC API user account
6. Configure file upload from Recorder Servers
7. Enable External Recorder data sources in Workforce Engagement
8. (optional) Enable AQS in Workforce Engagement
9. Install the Integrator
10. Configure the Integrator

Install server certificates

1. Open your browser in Administrator mode and go to your VFC Web Interface.
2. Follow the Server Certificates topic to download the server certificate for the VFC Media Repository server from the VFC Certificate Authority.
3. Install the downloaded certificate on the server that runs the Integrator service.

Create a parent organization in Workforce Engagement

1. In an on-premise or single-tenant WFE environment, sign in as Administrator. In a multi-tenant environment, sign in as Tenant Administrator.
2. Follow the Generate Create an API Keyorganization topic in the WFE Enterprise Configuration and Administration User Management Guide to create an API key for each Integrator.
3. Set Key type to External.
4. When each API key is generated, note their Key ID and Key Valueset up an empty organization for the synchronized VFC data.
5. Note the name of the organization created. You must enter the exact values name in the appsettings.Production configuration file of each Integrator that synchronize data to this tenant during the configuration process.

Create a VFC API user account

1. Sign in to VFC as an Administrator user.
2. Follow the User Configuration topic to create a new user that is only used for submitting API requests to VFC.
   1. Set API Access Only to enabled.
3. Note the user name and password of the created userIntegrator during the configuration process.

Create a parent group in Workforce Engagement

1. In an on-premise or single-tenant WFE environment, sign in as Administrator. In a multi-tenant environment, sign in as Tenant Administrator.

2. Follow the Create a group topic in the WFE User Management Guide to set up an empty group for the synchronized VFC data.

   Warning
   No users must be assigned to the created parent group, or the synchronization process fails.

   
   

3. Note the name of the group created. You must enter the exact values name in the appsettings.Production configuration file of each Integrator during the configuration process.

...

1. .

Create API key in Workforce Engagement

...

To enable External Recorder data sources that represent the VFC switch platforms, turn on the Data Marking API for External Recorder license item in WFE.

...

for each WFE Tenant

1. In an on-premise or single-tenant WFE environment, sign in as Administrator. In a multi-tenant

...

1. environment,

...

1. In a browser, go to http://<wfo_app_server_address>/wfo/control/license_edit.
2. On the License Data page, under Features, enable 2021R1 - Data Marking API for External Recorder.
3. Click Save.

Create an External Server in Workforce Engagement

To allow for accurate call marking, an External Server must be created in WFE to represent a VFC installation.

1. Follow the Add an external server to the Installations tree topic in the WFE Enterprise Configuration and Administration Guide to create an external server.
   1. The Serial Number must be unique to both a VFC and a WFE installation. It must be a 6-digit number in the format XXXYYY, where the XXX is a 3-digit unique identifier for the VFC installation, and YYY is a 3-digit unique counter, incrementing for each Integrator.
2. Repeat for all VFC installations. Ensure that the Serial Numbers are unique.
3. Note the Serial Number of the created server or servers. You must enter the exact value in the appsettings.Production configuration file of each Integrator for a VFC installation during the configuration processsign in as Tenant Administrator.
4. Follow the Generate an API Key topic in the WFE Enterprise Configuration and Administration Guide to create an API key for each Integrator.
5. Set Key type to External.
6. When each API key is generated, note their Key ID and Key Value. You must enter the exact values in the appsettings.Production configuration file of each Integrator that synchronize data to this tenant during the configuration process.

Create a VFC API user account

1. Sign in to VFC as an Administrator user.
2. Follow the User Configuration topic to create a new user that is only used for submitting API requests to VFC.
   1. Set API Access Only to enabled.
3. Note the user name and password of the created user. You must enter the exact values in the appsettings.Production configuration file of each Integrator during the configuration process.

Configure file upload from Recorder Servers

The Integrator does not process recordings that are stored on the Recorder Servers, so the upload of media and metadata files to a central storage location must be configured.

1. Sign in to VFC as an Administrator user.
2. Follow Configuring media file upload to configure policy-based or non-policy based file upload.

Enable External Recorder data sources in Workforce Engagement

To enable External Recorder data sources that represent the VFC switch platforms, turn on the Data Marking API for External Recorder license item in WFE.

1. In a browser, go to http://<wfo_app_server_address>/wfo/control/license_edit.
2. On the License Data page, under Features, enable 2021R1 - Data Marking API for External Recorder.
3. Click Save.

(optional) Enable AQS in Workforce Engagement

...

• Verify that the parent organization with the name specified during configuration exists in WFE.
• Verify that the parent group with the name specified during configuration exists in WFE.
• Verify that the VFC Synced group exists as a child of the parent group in WFE.
• Verify that the VFC user groups exist in WFE.
• Verify that VFC users are available in WFE, are associated with the same groups as in VFC, and have the right extensions associated to them.
• Verify that the data sources configured in the Integrator appsettings.Production file exist in WFE, and have the right name, time zone, recorded platform, contact policy type, and extensions associated with them.
• Verify that calls recordings are accessible visible in the Automated Verification component of WFE.
• Verify that recordings are associated with the right users, extensions, and data sources.
• Verify that calls recordings are associated to the Serial Number of the external server that is specified in the Integrator.
• Verify that an external recorder server exists in WFE with the virtual Serial Number Server Name specified in the Integrator appsettings.Production file.

Resilience

The VFC Integrator achieves a resiliency model using an active-passive design. Multiple Integrators can be running and be configured to read from the same VFC database per VFC environment, but only one Integrator is reading at once.

...