mscrm-addons.com - Blog

IMPORTANT INFORMATION

This blog is deprecated since July 2020.The articles below are no longer maintained and might contain outdated information. 
You can find the most acutal and relevenat information in our Knowledge Base at support.mscrm-addons.com

News.mscrm-addons.com Blog

rss

Hello and welcome to our blog! What can we do for you? Are you looking for further technical information or step-by-step instructions to our products? Or would you like to read the latest news on mscrm-addons? Please feel free to browse our blog for detailed information and to share our posts!


How to extend the Click2Dial-functionality for TelephoneIntegration?

This article explains how to enable the Click2Dial-functionality of TelephoneIntegration (TI) for CRM 2013/2015/2016 and Dynamics 365 without using the CallNumber button in the ribbon. 

This feature allows you to start an outgoing call through hitting directly on a telephone number in the CRM form via the TI Client. CRM already has a builtin Click2Dial feature, but its use is limited only to Skype or Skype for Business (Lync) client. 

Instead of calling via the default Skype or Lync client, we can alter it so that the call is triggered over our TI Client/default communication plugin.


Figure 1: Extended Click2Dial functionality (example)

 

How to extend the Click2Dial functionality for TI?

1)
To enable the functionality, open CRM > Settings > Customizations > Customize the System.

In the next window select Web Resources in the tree-view and click on the [New]-button. 

 
Figure 2: Web Resources Window in CRM

2) Use the next window to create a new web resource. The name does not really matter. Here, we use new_ PTMTIReplaceCallHandler. The important settings are the Type and the Script.

3) Next, download the below file, unzip it and upload the script. 

For Dynamics 365 take thisPTMTIReplaceCallHandlerDyn365.zip 

For older CRM versions take this:PTMTIReplaceCallHandler.zip

4) Once done so, click on the [Save]-button and afterward on the [Publish]-button.


Figure 3: Create new web resource

5) Next, open a CRM record for which you want to enable this feature. (here: Contact) Here, open the Form-Editor.


Figure 4: Open form-editor in the entity Contact 

6) Now click on the [Form Properties]-button. 


Figure 5: Open the Form Properties - dialog 

7) In the Form Properties-dialog, the before created web resource must be selected. Click on the upper [+Add]-button (in the Form Libraries - section) and a Look-up record-window will pop up.
After the web resource has been selected, click on the [Add]-button in the Look-up record-window.


Figure 6: Form Properties-dialog (background) and Look-up record-window

8) Back in the Form Properties-dialog, we must define the Start-function of the script. To do so, click on the lower [+Add]-button (in the Event Handlers-section). Now select the web resource and type in the function name (here PTM_TIStartReplaceCallHandler). Click on the [OK]-button. 


Figure 7: Handler Properties 

9) Finally, the Form Properties-dialog will look like this:


Figure 8: Customized Form Properties-dialog 

10) To complete the configuration, click on the [OK]-button. Then click on the [Save]-button and afterward on the [Publish]-button in the form editor. 


Figure 9: Save and Publish

After reloading Contact in CRM (press F5), the Click2ToDial-functionality will be enabled.

Please note: If you want to enable this feature on additional forms, you simply have to select the corresponding web resource and define the corresponding start-function.

Trouble Shooting 
This section is only relevant for you if dialing out does not work as expected when clicking a number directly in the form.

First please make sure that dialing out by hitting the default TI button works as expected:

 

Only if this is the case it has to be a problem with the Click2Dial script.

Then follow these steps to get more information.

Add the "debug:true" text to the function call, as you can see in the figure below:

That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.




Comments are closed.