Skip to main content
Skip table of contents

📹 Videochat - Kiosk Flow

Introduction

This article will guide you through the steps to implement the Video Call - Inbound feature integrated with NICE InContact ACD/IVR.

The Flow

The Kiosk flow primarily involves creating a landing page for your company, which will be connected with NICE InContact ACD/IVR. Here’s how it works:

  1. Customer Interaction: When your customer clicks on your custom start button on the landing page, it triggers the integration to create a work item in your company queue. This work item routes the session to one of your agents.

  2. Video Session Initiation: On the customer’s side, a Surfly session with video enabled will start.

  3. Agent Interaction: Once the agent starts the video session on their side, both the agent and the customer will be connected and interacting via video in a matter of seconds.

This streamlined process ensures a seamless and efficient video call experience for both your agents and customers.

91954d7e-a1e3-4ea2-9ccb-73f3c9a08db9.png

Implementation Steps

To implement this flow, follow these four milestones:

  1. Configuring the Studio Scripts

  2. Creating the Landing Page

  3. Integrating the Landing Page with the Studio Script

  4. Testing the Kiosk Flow

Quick Start

Before starting the implementation, please download the scripts linked below:

  • Studio Scripts for Download:

    • Surfly Signaler: Used to manage the work item correctly in a queue

    • IB_Video_WI: Entry point for video functionalities before creating the work item

Configuring the Studio Scripts

Creating the Studio Scripts

  1. Open the NICE inContact Studio:

    • Log in with an admin rights account.

  2. Import the Studio Script:

    • Click on File > Import from File (Ctrl + I).

    • Select Surfly_Signaler.

    • Save the file in the root folder.

    • Click on File > Import from File (Ctrl + I) again.

    • Select IB_Video_WI.

    • Save the file.

Create a Work Item Skill

  1. Log in to your ACD account.

  2. Navigate to ACD Skills:

    f7e7f94d-4c84-4bfb-8d5f-3683887bd05a.png
    • Click on Create New and select Single Skill.

      da5d62ef-0738-41d0-8d29-3ee984e9eb82.png

    • Select Media Type: “Work Item”.

      69b6f9f7-a857-4e99-8752-042b14d706e7.png

    • Add a name and select the campaign.

    • Click on Create.

Create a Point of Contact

  1. Within the ACD panel:

    • Click on Points of Contact.

      a6be5607-9f96-4ffc-8cbf-c377faad1894.png

    • Click on Create New and select Single Point of Contact.

      21a6bbf2-c1a4-4f51-b7ad-a82acbb019d8.png

    • Select Media Type: “Work Item”.

    • Add a name.

    • Select the skill created previously.

    • Select the script IB_Video_WI.

    • Click on Create Point of Contact.

      2b22efba-6eec-466a-b572-22553db1f051.png

Configuring the Scripts

Configuring the IB_Video_WI Script

  1. Open the IB_Video_WI Script:

    • Navigate to the SkillReq actions.

    • Select the skill you created previously.

    • Save the file.

Configuring the Surfly_Signaler Script

  1. Open the Surfly_Signaler Script:

    • Navigate to the Queuewi action.

    • Select the point of contact you created previously.

    • Save the file.

By configuring these scripts as specified, you will ensure that the integration works correctly with the skills and points of contact set up in the NICE InContact ACD/IVR system.

Creating the Landing Page

To create the landing page, we have provided an example that you can use. Simply copy and paste the code from the Landing Page Code into your environment to get it working.

Integrating the Landing Page with the Studio Script

After copying and pasting the landing page code into your environment you going to need to replace the variables below:

CODE
        var nicBusNumber = '4599130';
        var nicChatPOC = '1605d414-489c-4df4-83b1-334dbeb0ab2c';
        var clusterNiC = 'b32';
        var surflyWidgetKey = '134f5fd2ac8842c0a1cd6062818eee74';
        var videoSignalerURL = "https://home-b32.nice-incontact.com/inContact/Manage/Scripts/Spawn.aspx?scriptName=Surfly_Signaler&bus_no=4599130&scriptId=197588198&skill_no=4137191&p1=&p2=&p3=&p4=&p5=&Guid=602c459a-c935-4539-9fa0-0827ab102c74";

Retrieving Necessary Information for Integration

To fully integrate your landing page with the NICE inContact system, you will need the following details: nicBusNumber, nicChatPOC, videoSignalerURL, clusterNIC and surflyWidgetKey.

Retrieve nicBusNumber

This number is your Business Unit number with NICE inContact. You can find this number in your NICE inContact account settings or by contacting your account manager.

Retrieve the nicChatPOC

  1. Navigate to the Point of Contact:

    • Go to ACD → Contact Settings → Points of Contact.

  2. Select Your Chat Point of Contact:

    • Choose the specific chat point of contact you set up for this integration.

  3. Copy the Point of Contact URL:

    • Copy the poc number provided in the interface.

Get the videoSignalerURL:

  1. Navigate to ACD:

    • Go to ACD → Contact Settings → Scripts.

  2. Select the Script:

    • Choose the Surfly_Signaler script.

  3. Configure Spawn Links:

    • Go to the Spawn section.

    • Select the chat skill that you will be using for this integration.

    • Click “Show Shortcut” and copy the URL from the “Shortcut to Surfly Signaler” link. This URL is the Signaler Spawn URL that you will use in the JavaScript integration file.

28354f43-0acc-4eaa-a89c-26851b23cb67.png

Retrieve clusterNIC

This number identifies your cluster with NICE. If you do not know your cluster, you can find it by following these steps:

  1. Retrieve the Video Signaler URL:

    • Navigate to your video signaler URL setup in NICE inContact.

  2. Identify the Cluster:

    • Look at the beginning of the URL. The cluster identifier is the letter followed by the two numbers at the beginning of the URL.

    Example URL:

    https://home-b32.nice-incontact.com/inContact/Manage/Scripts/Spawn.aspx?scriptName=Surfly_Signaler&bus_no=4599130&scriptId=197588198&skill_no=4137191&p1=&p2=&p3=&p4=&p5=&Guid=602c459a-c935-4539-9fa0-0827ab102c74

  • In this case, the cluster identifier is b32.

Retrieve surflyWidgetKey

To retrieve your surflyWidgetKey, follow these steps:

  1. Navigate to the Surfly Dashboard:

  2. Locate the Widget Key:

    • Once on the integration page, find and copy the widgetKey.

Testing the Kiosk Flow

To ensure your Kiosk flow is functioning correctly, follow these steps:

  1. Network Accessibility:

    • Surfly needs to access your server over the network. If you are developing locally, use tools like ngrok or Burrow to expose your local machine to the internet. This allows Surfly to reach your development environment.

  2. Deployment:

    • Alternatively, you can deploy your landing page and integration to a publicly accessible server. This ensures Surfly can interact with your setup without network restrictions.

  3. Testing:

    • Once deployed or accessible, test the Kiosk flow to ensure that everything is working as expected. Verify that the integration between your landing page, Surfly, and NICE inContact is functioning properly.

  4. Follow Basic Requirements:

    • Make sure you adhere to the basic requirements specified by Surfly. You can access these requirements here to ensure your setup meets all necessary conditions.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.