Walkthrough: Use the generic listener adapter for CTI event routing

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

This walkthrough demonstrates how you can use the CTI Desktop Manager and generic listener in Unified Service Desk to expose the CTI events as screen pops in Unified Service Desk. For this walkthrough, we will use a sample CTI Simulator application that sends CTI requests to Unified Service Desk.

In this walkthrough, you’ll:

• Search for a contact record in the sample Microsoft Dynamics 365 data based on an email address specified in the sample CTI Call Tester application.

• Create a window navigation rule to display the matching record in a session in Unified Service Desk.

In This Topic

Prerequisites

Step 1: Configure a CTI Desktop Manager hosted control in Unified Service Desk

Step 2: Test if the CTI events are raised in Unified Service Desk

Step 3: Define a window navigation rule to route the CtiLookUpRequest

Test your CTI adapter

Prerequisites

• Microsoft .NET Framework 4.5.2

• Unified Service Desk client application; required for testing the hosted control.

• Microsoft Visual Studio 2012 or Visual Studio 2013

• Download the sample CTI Simulator Application Visual Studio project to your computer. Build the project, and run the application (.exe file) from the bin\debug folder of the sample application project. You must run the USD CTI Simulator application on the same computer where Unified Service Desk client is running to test the application.

Step 1: Configure a CTI Desktop Manager hosted control in Unified Service Desk

1. Sign in to Microsoft Dynamics 365.

2. On the nav bar, choose Microsoft Dynamics 365 > Settings > Unified Service Desk.

3. On the Unified Service Desk page, choose Hosted Controls.

4. On the Hosted Controls page, choose New.

5. On the New Hosted Control page, specify the following values.

   Field	Value
   Name	CTITest
   USD Component Type	CTI Desktop Manager
   Display Group	HiddenPanel
   Assembly URI	Microsoft.Crm.UnifiedServiceDesk.GenericListener
   Assembly Type	Microsoft.Crm.UnifiedServiceDesk.GenericListener.DesktopManager

   Note

   The values specified in the Assembly URI and Assembly Type fields are the generic listener values for the CTI Desktop Manager hosted control type.

   

6. Click Save to create the hosted control.

Step 2: Test if the CTI events are raised in Unified Service Desk

1. Start Unified Service Desk client, and connect to your Dynamics 365 instance. After the client is up, choose Settings in the top-right corner to display the debugger control, and then choose Clear Debug Output to clear the desktop.

   

2. Start the USD CTI Simulator application, type Email in the Key column and specify a random value in the Value column. Click Send to USD.

   

3. A screen pop-up occurs in the client application to expose the CTI event. In this case, a CTILookUpRequest is initiated with the value that was specified in the USD CTI Simulator application. Because you haven’t wired it yet with a window navigation rule, nothing further happens.

   

Step 3: Define a window navigation rule to route the CtiLookUpRequest

Create a window navigation rule to create a session if a match is found, and then display the matching contact record in a session in Unified Service Desk

1. Sign in to Microsoft Dynamics 365.

2. Navigate to the advanced find for contacts, and create a query where you search for active contacts where the email, email address 2, or email address 3 field equals a certain value, for example, someone_c@example.com.

   

3. Click Download Fetch XML to save the query as FetchXML.

4. On the nav bar, choose Microsoft Dynamics 365 > Settings > Unified Service Desk > Window Navigation Rules.

5. Click New, and on the New Window Navigation Rule window, specify the following values.

   Field	Value
   Name	CTITestRoute
   Order	50
   From	CTITest Note This is the name of your CTI Desktop Manager hosted control.
   Direction	Both

   

6. Save the rule. This enables the rest of the controls on the page.

7. Now, add the FetchXML query that was saved earlier to this rule. Under the CTI Searches area, choose Add .

8. In the New CTI Search window, specify the following values.

   Field	Value
   Name	CTIContactSearch
   Order	1
   FetchXML	<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"> <entity name="contact"> <attribute name="fullname" /> <attribute name="parentcustomerid" /> <attribute name="telephone1" /> <attribute name="emailaddress1" /> <attribute name="contactid" /> <order attribute="fullname" descending="false" /> <filter type="and"> <condition attribute="statecode" operator="eq" value="0" /> <filter type="or"> <condition attribute="emailaddress1" operator="eq" value="[[cti.Email]]" /> <condition attribute="emailaddress2" operator="eq" value="[[cti.Email]]" /> <condition attribute="emailaddress3" operator="eq" value="[[cti.Email]]" /> </filter> </filter> </entity> </fetch> Note The address someone_c@example.com was replaced with [[cti.Email]] so that the search is run based on the value specified for the Email key in the Unified Service Desk CTI Simulator application.

   

   9. Save the CTI search rule, and return to the window navigation rule.

   10. Under Single Match, in the Decision field, select Create Session, Load Match then Do Action.

   11. Under Single Match, in the Action field, click the search icon to select a value, and then click New.

   12. On the New Action Call page, create an action call to open the contact record by specifying the following values.

       Field	Value
       Name	CTIOpenContact
       Hosted Control	Dynamics 365 Global Manager
       Action	Open_CRM_Page
       Data	Id=[[$Context.Id]] LogicalName=[[$Context.LogicalName]]

       

   13. Save the action call, and then close the action call page to return to the window navigation rule definition page.

   14. Under the Result area:

       1. In the Destination field, choose Tab to display the matching contact record in a tab.

       2. In the Target Tab field, choose the Contact hosted control. The Contact hosted control was created when you deployed a sample Unified Service Desk application on your Dynamics 365 server using the Package Deployer tool. For more information, see TechNet: Deploy sample Unified Service Desk applications to CRM server using Package Deployer.

       3. In the Show Tab field, choose the Contact hosted control

       

   15. Save the window navigation rule.

   Test your CTI adapter

   1. Start Unified Service Desk client, and connect to your Dynamics 365 instance. After the client is up, choose Settings in the top-right corner to display the debugger control, and then choose Clear Debug Output to clear the desktop.

      

   2. Start the USD CTI Simulator application, type Email in the Key column and specify a valid email ID for the contact that you want to search. In this case, type someone_d@example.com in the Value column. Click Send To USD.

      

   3. The matching contact record is displayed in a session in Unified Service Desk.

      

   4. Check the Debugger hosted control to view the events that got raised as a result of the CTI search. Also check out the Data Parameters tab to view the context information in the $Context variable and CTI information under the CTI variable.

   See Also

   Integrate with CTI systems using CTI adapters
   UII computer telephony integration (CTI) framework

   Unified Service Desk 2.0

   © 2017 Microsoft. All rights reserved. Copyright