LiveVox

The LiveVox agent state connector connects to CXone WFM via SDK for data integration. This includes both Real Time Adherence(RTA) and historical data.

How each type of data is used in CXone WFM:

• Historical skill-based data: This is used in the Forecasting.

• Historical adherence data: This is used in the Adherence Report and in the CSV report you export from the Real Time Adherence.

• Intraday data: This is used to monitor skill performance and compare with forecasted data in the Intraday Manager.

• Real-time agent states data: This is used to calculate Real Time Adherence and show it on the RTA.

Functional Description

Here is a breakdown of what LiveVox ASC supports:

• Real-time data:

  Data	Support
  RTA	Yes
  Method of Integration	RESTFUL APIs
  Reason Codes	Yes

• Historical data:

  Data	support
  Skills	Yes
  Method of Integration	RESTFUL APIs
  Interval Setting	15 minutes

• Data types:

  data	support
  Inbound Voice	Yes
  Outbound Dialer	Yes
  Email	No
  Chat	No
  Fax	No
  Text (SMS)	No
  Web	No

• Historical adherence:

  data	support
  Agent Activity Log	Historical adherence data is pulled every 15 minutes

• Reports:

  Reports	support
  Agent Adherence Report	Yes
  Real Time Adherence	Yes

• Event sets:

  ACD event identifier (Agent State)	ACD event reason code
  LOGON
  REGISTERING
  READY
  Not Ready NOT READY
  RESERVED
  MANUAL DIAL
  PREVIEW DIAL OFFERED
  PREVIEW DIAL ACCEPTED
  PREVIEW DIAL SKIPPED
  DIALING
  LOGOFF
  TRANSFERRING
  IN CALL
  AGENT HOLD
  AGENT HOLD
  WRAP UP
  AGENT TRANSFER INITIATED SUPERVISOR
  AGENT TRANSFER INITIATED AGENT2
  AGENT TRANSFER FAILED
  AGENT TRANSFER CONNECTED SUPERVISOR
  AGENT TRANSFER CONNECTED AGENT2
  AGENT TRANSFER CONFERENCED SUPERVISOR
  AGENT TRANSFER CONFERENCED AGENT2
  AGENT TRANSFER RECONNECTED SUPERVISOR
  AGENT TRANSFER RECONNECTED AGENT2
  AGENT TRANSFER COMPLETE SUPERVISOR
  AGENT TRANSFER COMPLETE AGENT2
  AGENT TRANSFER HOLD SUPERVISOR
  AGENT TRANSFER HOLD AGENT2
  AGENT TRANSFER RESUMED SUPERVISOR
  AGENT TRANSFER RESUMED AGENT2
  NOT READY	LUNCH
  NOT READY	TRAINING
  NOT READY	BREAK
  NOT READY	MEETING
  NOT READY	TECH DIFFICULTIES
  NOT READY	VOICE MAIL
  NOT READY	OTHER

• Other information

LOGON ID SUPPORTED	Agent Logon ID
SUPPORTS NOT READY REASON CODE	Yes

• Pseudo skills to be used when contact has no associated skill.

Queue ID	Pseudo Skill Name
-4	HCI_NO_SKILL
-3	OUTBOUND_NO_SKILL
-2	INBOUND_N0_SKILL
-1	MANUAL_NO_SKILL
0	NO_SKILL

Steps to install the LiveVox ACD Connector:

1. Generate the Access Key.

2. Download and Configure SDK

Generate the Access Key

The access key grants the LiveVoX ACD access to CXone. You generate the key in CXone and later enter it when integrating the ACD.

Create a specific user for ACD Integration. This user’s Access Key information will be used for the integration. Do not assign any permissions to this user.

The following steps need to be performed by the Admin to obtain the Access Key details for this user:

To generate the access key:

1. Create a role for the LiveVox connector In CXone:

   1. Click the app selector and select Admin.

   2. Go to Security > Roles and Permissions.

   3. Click New Role, and enter a relevant name for the role. For example, Role for LiveVox ACD.

   4. Remove all permissions for the role.

   5. Save & Activate the role.

2. Create an employee for the LiveVox connector:

   1. Click the app selector and select Admin.

   2. Click Employees.

   3. Click New Employee and enter a relevant name for the employee. For example, name the employee LiveVox ACD.

   4. From the Primary Role drop-down list, select the role you just created for the connector.

   5. In the General tab, deselect all the attributes.

   6. Create the connector employee. Activate the employee account by clicking the Activate Account button in the activation email (the Access Keys tab will only appear after you create the account).

3. Open the connector employee again, then go to the Access Keys tab and generate an access key.

4. Copy both the Access Key ID and Secret Access Key. Save them in a text file and share it with the user, integrating the APIs.

   If you don't copy the Secret Access Key or lose it, you'll need to create a new one.

   Use this access key ID and secret access key when integrating the connector.

Download and Configure SDK

To download and import SDK:

1. In the CXone application, proceed to your profile and click on it.

2. Click Support and Downloads.

   View Support and Download on the Admin page

   

3. Find the CXone WFM client SDK listed under External ACD and click Download.

4. Import the downloaded SDK into your ACD project.

To configure SDK:

1. Follow these steps for application initialization.

   See steps

   var(--codeSnippetCopyLabel)

   WFMConnectionConfig wfmConnectionConfig = new WFMConnectionConfigBuilder()
   .setServiceUrl("<Provide Service URL>")
   .setAccessKey("<provide Access Key>")
   .setSecretKey("<Provide Secret Key>")
   .build();
   WFMConnection wfmConnection = WFMConnection.getConnection(wfmConnectionConfig);
   wfmConnection.connect();
   

   This will initialize the required class to connect to the WFM to send the data. The data include:

   • Agent states

   • Agent activities

   • Queue report

2. Once initialized, use these classes to transmit agent states, agent activities, and queue reports.

   See steps

   var(--codeSnippetCopyLabel)

   // send Agent States
   AgentStateListDTO agentStateListDTO = generateAgentStateDTO(); // Add implementation for method generateAgentStateDTO()
   AgentStatesService agentStatesService = AgentStatesServiceImpl.getInstance();
   try {
   agentStatesService.processAgentStates(agentStateListDTO);
   } catch (CXoneWfmException e) {
   WFMReportResponseDTO wfmReportResponseDTO = e.getResponse();
   // implementation to read error response
   }
   // send Agent Activity report
   try {
   ReportService reportService = ReportServiceImpl.getInstance();
   AgentActivityReportDTO agentActivityReportDTO = generateAgentActivityReportDTOForAgentActivity();   // add implementation for this method generateAgentActivityReportDTOForAgentActivity()
   reportService.processAgentActivityReport(agentActivityReportDTO);
   } catch (CXoneWfmException e) {
   WFMReportResponseDTO wfmReportResponseDTO = e.getResponse();
   // implementation to read error response
   }
   // send Queue report
   try {
   ReportService reportService = ReportServiceImpl.getInstance();
   ReportDTO reportDTO = generateQueueReportDTO();                    // Add implementation for method generateQueueReportDTO()
   reportService.processQueueReport(reportDTO);
   } catch (CXoneWfmException e) {
   WFMReportResponseDTO wfmReportResponseDTO = e.getResponse();
   // implementation to read error response
   }