Document toolboxDocument toolbox

CIF Based MS CRM Web-CTI Connector Deployment Guide

Preface

This document provides deployment details of the product inside MS Dynamics CRM.

Prerequisites

Following are the prerequisites for the deployment of the Javascript CTI Toolbar.

  1. Dynamics 365 should be installed. 
  2. The user must have administrative rights 
  3. Download and install the Generic Connector.
  4. (required) Install Generic Connector patch  Extract the RAR file and run the EXE file on the Generic Connector server.

Install Javascript CTI Toolbar for MS Dynamics CRM 

This javascript_cti_toolbar can be deployed on the Generic Connector server on any application server of the user's choice (IIS, Tomcat, etc). The following section lists the steps to deploy the application in an IIS server.

  1. Download the javascript-cti-toolbar and place it in the (c:\inetpubt) or any desired directory. 
  2. Press window+R, write inetmgr, and click OK. It will run IIS Manager.
    • Site name (javascript_cti_toolbar).
    • Physical path (c:\inetpubt\javascript-cti-toolbar).
    • Port, default value is 80 but any other value can be assigned.

    1. Navigate to `c:\inetpub` folder and create a directory with the name javascript-cti-toolbar
    2. Right-click on Sites and select Add Web Site
    3. Set the values in the following fields as shown in the picture below and click OK.
    4. Go to the physical path (c:\inetpubt\javascript-cti-toolbar)of the site which was defined above and copy files from a cloned javascript-cti-toolbar folder (which was cloned by executing the above script).
    5. Please follow this guide to install and configure the SSL certificates on IIS in order to run the cti_toolbar on HTTPS.

Configuration

  1. Open the new_config.js file located on `c:\inetpubt\javascript-cti-toolbar\new_config.js` path.  Set the properties as per the below table. 


  2. S.NoProperty NameValue Description
    1amqUrl1ws://192.168.2.227:61614/stompThis is the Primary URL of AMQ on which you have installed the Generic Connector. The protocol can be ws or wss , like if you running on a secure socket that will be wss else it will be ws.
    2amqUrl2ws://192.168.2.227:61614/stompThis is the secondary URL of AMQ if the system is working in HA mode. for NON-HA mode you can simply put the IP of the Primary AMQ URL 
    3isUCCXTrue/FalseContact Center Type, like UCCE/PCCE or UCCX. For UCCX it will be True for UCCE/ PCCE it will be False
    4ssoTrue/False 

    If you wanted to enable SSO so that as soon as agents login into CRM, should also log in on CTI. You can put this value True, else False.

    If Value is Set to True, property 5,6,7,8 also needed to be set.

    5sso_prefixnewCRM prefix for customized fields in the CRM
    6agent_field_namenew_agentidID of the custom field for Cisco Agent ID, created in User Entity in the CRM
    7password_field_namenew_passwordID of the custom field of Cisco Agent Password, Created in the User Entity in the CRM
    8extension_field_namenew_extensionID of the custom field of Cisco Agent Extension, Created in the user Entity in the CRM> 
    9entities"Lead,Account,Contact"The searching priority user can define in the config file. For example, as per this configuration, the CTI connector first searches the record in the Lead, then in the Account, and last Contact. If you wanted to search the record first in Contact, you can simply change the order as per your requirement and the searching order will be changed. 
    10disanplePopupTrue/FalseIf you want to disable the screen pop, you can put the value True, else False
    11popUpVariableANI/any custom Variable

    The variable on which you wanted to do the screen pop, most of the time it's an ANI, but the user can change it as per his requirement. 


  3. The actual file looks like this. Please note that the order of the properties doesn't matter
  4. Update the configurations and save the file.
  5. Browse the configured FQDN and the application should be accessible as shown below.

Configure the CIF on Dynamics CRM UCI for javascript-cti-toolbar

  1. Login to the CRM and go to the published apps then select the ‘ channel integrated framework’.

Note

If CIF is not installed on your CRM then you can follow this guide to install on your CRM. 


  1. Click on the new button to create a new active channel provider and fill in the details as given in the screenshot below.
  1.   Select Unified Interface Apps for the Channel
  2.   Select the Unified app on where you want to embed the CTI. 
  3.   Assign roles according to your requirements. 
  4.   Click on Save Button. 

  1. Go to the Customer Service workspace. Will look like the following screenshot.

Configure Click-to-Call

Follow the steps to configure click to call on the Account page. You can configure it on multiple entities as per your requirement like Contact, Leads

  • Click on the setting button

  • Go to setting -> Customizations -> Customize the System 


  • double click phone field -> controls ->add controls -> add ‘ channel communication control ’.

  • Save and publish

After following all these steps, your CTI is configured properly and now you can use EF MS CRM WEB-CTI Connector