AgentAssist Chat Integration with NICE-CTI Salesforce

Overview

This document explains the AgentAssist Chat channel integration with NICE-CTI Salesforce.

Shared Responsibilities

Activity Responsibility
CXOne Customer Kore.ai
NICE CX One Platform
ACD Configuration
  • Skills creation and mapping
  • Hours Of Operation
  • Points of Contact
  • Campaign
  • Customization of Scripts and attaching to Number/Chat PoC
CXOne Studio Script
  • Customize Bot details in the script
  • Provisioning the studio script template.
Signal API Auth
  • Configure CXOne Authentication for accessing CXOne Signal API from Kore bot
Agent Assist Hub
  • Configure NICE Studio Agent Assist.
Kore Bot Configuration
  • Bot creation
  • Bot credentials generation
Salesforce Org
Chat Configuration
  • Enabling NICE Chats on Salesforce with proper screenpop settings
Installing Kore AgentAssist Package
  • Installing the package
  • Providing the URL
Configuring Kore AgentAssist Package
  • Validate pre-requisite licenses
  • Configure Bot details
  • Add NICE Signal Credentials

Prerequisites

Agent Assist Hub

  1. Sign in to your NICE account with the username and password provided by the NICE customer support.
  2. Click the applications launcher button.

    • A menu opens from the left side of the page.
  3. Click OTHERS > Automation & AI.

  4. Click Agent Assist Hub > Add Agent Assist App.

  5. Enter the name of the Agent Assist App in the AGENT ASSIST APP NAME field.
  6. Select Custom Agent Assist Endpoints.
  7. Click Next.

  8. Add the following settings with config parameters provided by the Kore.ai representative:
    • Agent UI Option: Available by default (could be account specific)
      1. App URL: Kore.ai AgentAssist URL. https://agentassist.kore.ai/integrations/nice/iframe/?params={scriptparams} by default unless specified by your Kore.ai representative.
      2. App Title: As per the requirement.
      3. Participants: Both
      4. Text Relay Endpoint: https://agentassist.kore.ai/integrations/nice/relay/toKore
      5. Audio Relay Endpoint: <Websocket URL>/audiosocket/nice?sipuri=<Bot SIP URI>&token=<Token>&botId=<Bot ID>&accountId=<>&agentassist=true
        1. Websocket URL: “wss://savg-webserver.kore.ai” unless specified.
        2. Bot SIP URI and Bot ID: From the bot details.
        3. Account ID: From the Koreai representative.
        4. Token: Create a JSON Web Token on jwt.io with the following details.
          1. Payload: {“appId”: <Bot Client ID>}
          2. Header: {“alg”: “HS256″,”typ”: “JWT”}
          3. Secret: Your Kore.ai Client Secret.
    • Scroll down and add the following Configuration Parameters:
  9. Click Create.

Salesforce Setup

Refer to the Salesforce Setup section of AgentAssist Voice Integration with NICE-CTI Salesforce.

Enabling Salesforce OAuth

  1. Go to Setup > OAuth and OpenID Connect Settings and enable Allow OAuth Username-Password Flows.

  2. Create a connected Salesforce app and get the Access Key and Access Token. Follow this guide for help.

Connecting Salesforce with NICE Studio Script

  1. Open the NICE CX Studio app.
  2. Click the Salesforce Auth tile and add the credentials you generated. The password is your Salesforce password appended with your Security Token. Refer to this guide for help.
  3. Click the User Auth tile and replace the Salesforce Base URL. Check the next step for instructions:
  4. Modify the Salesforce Base URL as per your Salesforce org. You can get it by running the following curl:

    curl –location –request POST ‘https://login.salesforce.com/services/oauth2/token?grant_type=password&client_id=<Salesforce Client ID>&client_secret=<Salesforce Client Secret>&username=<Salesforce Username>&password=<Salesforce Password + Salesforce Security Token>’

    • Remember to change the parameters as per your Salesforce account.
  5. Save the flow and you can now test with a new Chat.

NICE CX – Attaching Chat Endpoint to the Script

  1. Go to the NICE home page.
  2. Click the application launcher button.
  3. Click ACD.
  4. Click Points of Contact.
  5. Click the number you want to attach with AgentAssist.
  6. Click Edit.
  7. Change the script based on your needs.
  8. Click Done.

Adding NICE Chats Listener

  1. Click the dropdown list in the Service console.
  2. Click Edit > Add More Items.
  3. Search for Nice and click the + button next to NICE Chats Handler.
  4. Click Add 1 Nav Item.
  5. Open the Service console and make sure the NICE Chats Handler tab is active at all times.

AgentAssist Chat Integration with NICE-CTI Salesforce

Overview

This document explains the AgentAssist Chat channel integration with NICE-CTI Salesforce.

Shared Responsibilities

Activity Responsibility
CXOne Customer Kore.ai
NICE CX One Platform
ACD Configuration
  • Skills creation and mapping
  • Hours Of Operation
  • Points of Contact
  • Campaign
  • Customization of Scripts and attaching to Number/Chat PoC
CXOne Studio Script
  • Customize Bot details in the script
  • Provisioning the studio script template.
Signal API Auth
  • Configure CXOne Authentication for accessing CXOne Signal API from Kore bot
Agent Assist Hub
  • Configure NICE Studio Agent Assist.
Kore Bot Configuration
  • Bot creation
  • Bot credentials generation
Salesforce Org
Chat Configuration
  • Enabling NICE Chats on Salesforce with proper screenpop settings
Installing Kore AgentAssist Package
  • Installing the package
  • Providing the URL
Configuring Kore AgentAssist Package
  • Validate pre-requisite licenses
  • Configure Bot details
  • Add NICE Signal Credentials

Prerequisites

Agent Assist Hub

  1. Sign in to your NICE account with the username and password provided by the NICE customer support.
  2. Click the applications launcher button.

    • A menu opens from the left side of the page.
  3. Click OTHERS > Automation & AI.

  4. Click Agent Assist Hub > Add Agent Assist App.

  5. Enter the name of the Agent Assist App in the AGENT ASSIST APP NAME field.
  6. Select Custom Agent Assist Endpoints.
  7. Click Next.

  8. Add the following settings with config parameters provided by the Kore.ai representative:
    • Agent UI Option: Available by default (could be account specific)
      1. App URL: Kore.ai AgentAssist URL. https://agentassist.kore.ai/integrations/nice/iframe/?params={scriptparams} by default unless specified by your Kore.ai representative.
      2. App Title: As per the requirement.
      3. Participants: Both
      4. Text Relay Endpoint: https://agentassist.kore.ai/integrations/nice/relay/toKore
      5. Audio Relay Endpoint: <Websocket URL>/audiosocket/nice?sipuri=<Bot SIP URI>&token=<Token>&botId=<Bot ID>&accountId=<>&agentassist=true
        1. Websocket URL: “wss://savg-webserver.kore.ai” unless specified.
        2. Bot SIP URI and Bot ID: From the bot details.
        3. Account ID: From the Koreai representative.
        4. Token: Create a JSON Web Token on jwt.io with the following details.
          1. Payload: {“appId”: <Bot Client ID>}
          2. Header: {“alg”: “HS256″,”typ”: “JWT”}
          3. Secret: Your Kore.ai Client Secret.
    • Scroll down and add the following Configuration Parameters:
  9. Click Create.

Salesforce Setup

Refer to the Salesforce Setup section of AgentAssist Voice Integration with NICE-CTI Salesforce.

Enabling Salesforce OAuth

  1. Go to Setup > OAuth and OpenID Connect Settings and enable Allow OAuth Username-Password Flows.

  2. Create a connected Salesforce app and get the Access Key and Access Token. Follow this guide for help.

Connecting Salesforce with NICE Studio Script

  1. Open the NICE CX Studio app.
  2. Click the Salesforce Auth tile and add the credentials you generated. The password is your Salesforce password appended with your Security Token. Refer to this guide for help.
  3. Click the User Auth tile and replace the Salesforce Base URL. Check the next step for instructions:
  4. Modify the Salesforce Base URL as per your Salesforce org. You can get it by running the following curl:

    curl –location –request POST ‘https://login.salesforce.com/services/oauth2/token?grant_type=password&client_id=<Salesforce Client ID>&client_secret=<Salesforce Client Secret>&username=<Salesforce Username>&password=<Salesforce Password + Salesforce Security Token>’

    • Remember to change the parameters as per your Salesforce account.
  5. Save the flow and you can now test with a new Chat.

NICE CX – Attaching Chat Endpoint to the Script

  1. Go to the NICE home page.
  2. Click the application launcher button.
  3. Click ACD.
  4. Click Points of Contact.
  5. Click the number you want to attach with AgentAssist.
  6. Click Edit.
  7. Change the script based on your needs.
  8. Click Done.

Adding NICE Chats Listener

  1. Click the dropdown list in the Service console.
  2. Click Edit > Add More Items.
  3. Search for Nice and click the + button next to NICE Chats Handler.
  4. Click Add 1 Nav Item.
  5. Open the Service console and make sure the NICE Chats Handler tab is active at all times.