EX Engage Connector Recording Provider (EXRP)

EX Engage Connector (EXEC) enables Genesys Cloud (GC) recording management, Quality Monitoring (QM) services, and Speech and Text Analytics (STA) functionality for interactions happening in the Engage Contact Centers. Recording injection and STA-enablement in EXEC is implemented by two components:

1. The EX Conversation Provider (EXCP) component gathers the recording and STA metadata for passing it to the EX Recording Provider (EXRP) when a voice interaction ends.
2. The EX Recording Provider (EXRP) component is responsible for the injection of recorded voice calls along with its metadata (from the Engage contact center into the GC EX Organization) using the public EX API as outlined in EX Recording Injection. The EXRP supports an N+1 redundancy model for enhanced reliability.

Important

All GC services relying on the injected voice recordings to work such as QM and STA should be properly configured in the GC EX Org. Please refer the GC documentation for details.

Recording Injection Use Cases for the Engage Contact Centers

Customers with an existing recording solution

EXEC recording injection can be activated in the Engage Contact centers where active recording is used. An active recording solution includes the following components:

• Recording management: Engage GIR solution or a third-party recorder
• Speech Analytics: Engage Genesys Interaction Analytics (GIA)
• Media management: Media Control Platform (MCP)
  • If GIR is used, MCP records voice conversation and passes it to GIR for storing and processing.
  • When used with a third-party recorder, MCP forks the voice stream to the third-party recorder.
• Call recording control: SIP Server controls recording through start/stop/pause/resume commands to the MCP.

Customers without a recording solution

For customers without a recording solution, EXEC can enable GC recording management, QM, and STA services if your Engage Contact Center uses SIP Server and GVP (Genesys Voice Platform).

• To inject recordings into GC using EXEC, you will need to:
  • Expand your MCP farm with additional recording MCPs.
  • Configure SIP Server-based active recording for your agents.

Important

Recording injection should also be configured and enabled to use STA functionality.

GIA Replacement

GC provides state-of-the-art AI-based STA services which delivers capabilities better than GIA. Customers can continue using GIR for compliance recording and replace their existing GIA-based analytics solution with GC STA.

EXEC Deployment Options for Recording Injection

This section explains how EXEC can be integrated with two different types of the Engage recording solution:

1. Third-party recorder or GIR without GIA
2. GIR with GIA

Those two categories are defined based on the configuration required to integrate the EXEC. In the first case, customers do not use the Engage speech analytics solution. This architecture allows to connect GC STA as a new analytics solution without changing the existing recording processing flow in the contact center. Solutions in the second category use GIA. As a result, GC STA should be brought as a replacement of the existing analytics solution. In most cases, customers can use only one analytics solution at a time (either GIA or GC STA). At the same time, some Engage contact center configurations may allow to use GC STA only for a subset of call recordings when the rest of the calls are still processed in GIA.

Important

Diagrams provided in this section are color-coded: blue indicating a new component or connection and orange for components that require configuration changes. Diagrams show only components that are essential for a particular use case.

Third-party Recorder or GIR without GIA

The following diagram depicts an integration with a third-party recorder. Even though the EXEC integration with the GIR-based solution is slightly different, the required Engage configuration changes are the same in both cases.

In this configuration the existing IVR profile ‘record’ is modified. Based on those changes MCP starts producing recording files in opus format to push those files to EXEC. In case of the third-party recorder, IVR profile is also configured to instruct MCP to push the recording metadata to the EXCP. If GIR-based solution is used, EXCP pulls metadata from the GIR RWS component.

GIR with GIA

If Engage customers use GIA for speech analytics, then GIA should be replaced with the EXEC in the existing IVR Profile 'record' as shown on the diagram below. In this case, MCP stops delivering recordings to the GIA as soon as IVR Profile configuration is changed. Speech analytics can be done only in the GC STA while new configuration is active. Configuration can be rolled back instantly without restart of any components to restore regular GIA-based operations.

Defining Recording Synchronization Scope (Sync-Scope)

Sync-scope refers to a designated portion of your Engage contact center environment configured for injection into the Genesys Cloud EX organization. You define the sync-scope by adding configurations to the Engage CME. If no sync-scope is specified, EXEC syncs your entire Engage environment. Defining a sync-scope is highly recommended, with a smaller scope being ideal for pilot deployments or gradual migrations.

EXEC components, EXAS and EXCP, inject agent and call-related activity only for those belonging to the sync-scope. EXCP then sends a recording injection request to EXRP for all injected calls. Consequently, EXRP also adheres to the defined sync-scope.

Voice recordings to be injected to GC are collected in the EXEC WebDAV transient storage first. Engage solution can be configured to push either all recordings or only the recordings related to the sync-scope calls into the WebDAV storage. In both cases EXRP injects only the sync-scope recordings into GC. So, those two approaches are identical from the end-user perspective. The difference is in the required size of the WebDAV storage. More details about the pros and cons of those configurations are provided in the following sections.

Storing All Engage Recordings in WebDAV

The following diagram depicts an EXEC integration with the Engage contact center where GIA is used for speech analytics (mentioned earlier). In the example, customers select one of their lines of business LOB1 to be synced to GC. As a result, all EXEC modules only inject the data related to the selected LOB1. GIA stops receiving any recordings. So, call center agent and supervisors should log in to GC to use the STA services there instead.

The main advantage of this approach is a simple configuration, which can be used in any Engage deployment. Customers need to replace GIA in their 'record' IVR Profile configuration with the EXEC to redirect the recording files accordingly.

This approach requires EXRP WebDAV transient recording storage to hold all Engage contact center recordings produced in the last 24 hours. In large contact centers, it may require a significant amount of storage and processing power.

Storing Only Engage Sync-Scope Recordings in WebDAV

In certain Engage configurations, you can create a dedicated processing flow for sync-scope calls at the SIP Server level. This allows GC STA and GIA to be used in parallel, with GC STA working with sync-scope calls while all other calls are processed by GIA. Specific Engage configurations allow creating a dedicated processing flow for sync-scope calls at the SIP Server level. This can be implemented in environments using SIP Server geo-locations with the MSML strict matching policy, or potentially other environments.

This approach allows:

• Process sync-scope calls separately from other types of calls. GC STA can analyze sync-scope calls, while GIA handles all other calls.
• WebDAV storage only needs to accommodate recordings from sync-scope calls.

These advantages stem from SIP Server being configured to identify and report sync-scope calls to the GVP (Genesys Voice Platform), a core component of the Engage recording solution. GVP applies a newly created IVR profile to the sync-scope calls and MCP generates Opus recording files only for the sync-scope calls and pushes them to GC EXEC. Processing of all other recordings remains unchanged.

How recording injection works in EX Engage Connector

This section explains the recording injection processing flow in EXEC. The following diagram depicts EXEC integration with the third-party recorder only. Processing flow is mostly the same for the third-party recorder and GIR/GIA integrations. The difference between the two is how EXCP obtains the recording metadata. In the first case, MCP pushes metadata to the EXCP as soon as the recording segment is complete. In the GIR/GIA integration, EXCP pulls metadata from the GIR RWS component when the interaction ends.

[Insert diagram illustrating the processing flow]

Recordings are processed as follows:

1. MCP records an audio file in the opus format covering one segment of a contact center voice call.
2. MCP stores the recorded file to the EXRP WebDAV Transient Recording Storage using a link configured in the recdest2 configuration option.
3. MCP posts the recording metadata to the EXCP via HTTP Load balancer which injects the interaction events into GC.
4. EXCP stores the received metadata to Redis.
5. EXCP detects the end of an interaction and calls the EXRP REST API via HTTP Load Balancer. This interaction-end API is called once for each recorded call segment providing GC-metadata (recording and STA metadata) and the name of the recorded audio file for this segment.
6. EXRP pulls the audio recording file from the WebDAV storage.
7. EXRP encrypts the recording using GC public key which it pulls periodically using GC EX Public API.
8. EXRP creates a ZIP archive, which contains one encrypted audio file and a JSON file with the corresponding GC-metadata.
9. EXRP obtains an S3-pre-signed URL to upload the created archive by calling GC public API.
10. EXRP uploads the ZIP archive to an S3 bucket using the pre-signed upload URL obtained on the previous step.