• Release History
  • Documentation
  • Back to www.mscrm-addons.com
  • Release History
  • Documentation
  • Back to www.mscrm-addons.com
home/Knowledge Base/TelephoneIntegration (TI)/How to extend the Click2Dial-functionality for TelephoneIntegration?

How to extend the Click2Dial-functionality for TelephoneIntegration?

610 views 1 Updated on July 27, 2022

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.

clip_image003

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 v. 9 new UCI only – take this: PTMTIReplaceCallHandlerDyn365v9_UCI.zip

For Dynamics 365 – take this: PTMTIReplaceCallHandlerDyn365.zip

For older CRM versions – take this:: PTMTIReplaceCallHandler.zip​

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

clip_image005

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.

clip_image007

Figure 4: Open form-editor in the entity Contact 

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

clip_image009

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.

clip_image011

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).

If you use the script for “Dynamics 365 v. 9 new UCI only” it is important to check “Pass execution context as first parameter“. 

Click on the [OK]-button.

clip_image013

Figure 7: Handler Properties 

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

clip_image015

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.

clip_image016

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:

 TI call number
Figure 10: TI call number

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:

 Add the debug:true text to the function call

Figure 11: Add the “debug:true” text to the function call

Next, save and publish.

After reloading the entity record you will see alerts on page load and on click of a number, like:

 Alerts on page load and on click of a number
Figure 12: Alerts on page load and on click of a number

 

 Please note that every CRM user using this form will get these alerts.

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

reworkneeded … it needs to be updated with pictures for Dynamics 365 – the call number button and the balloon.

Was this helpful?

1 Yes  1 No
Related Articles
  • How to activate per User Licensing in CRM 2011
  • How to access mscrm-addons product settings in Dynamics 365
  • Azure Active Directory licensing counts explained
  • “Server2Server” authentication for the DocumentsCorePack Template Designer and Telephone Integration
  • How licenses are counted
  • Telephone Integration Client Unattended Setup
Latest Articles
  • New DocumentsCorePack Connector features for Power Automate
  • Office Theme Support of DocumentsCorePack
  • AssureSign for DocumentsCorePack
  • Dynamic Document Properties
  • How to conditionally remove a watermark in DocumentsCorePack templates
Popular Articles
  • Where do I find the Unique Organization name in Microsoft Dynamics 365?
  • mscrm-addons.com Application Access for Dynamics 365 (App Access) – DocumentsCorePack
  • DocumentsCorePack Online Service Configuration
  • DocumentsCorePack Template Designer – Getting Started
  • Step-by-Step: How to configure a One-Click-Action
Top Rated Articles
  • IMPORTANT information for Dynamics 365 online customers using DocumentsCorePack and/or AttachmentExtractor
  • How to activate the DocumentsCorePack connector for PowerApps & Microsoft Flow
  • Step-by-Step: How to configure a One-Click-Action
  • Online Services: Required Application Permissions
  • Information on Security roles: Which roles are needed for which solution?
Categories
  • *News and General Infos* 51
  • Webinars 35
  • Template Designer(DCP 173
  • DocumentsCorePack(DCP 191
  • TelephoneIntegration (TI 65
  • AttachmentExtractor (AE 62
  • PowerSearch (PS 48
  • ActivityTools (AT 59
  • SmartBar (SB 53
  • GroupCalendar (GC 46
Our Vision

“We see it as our purpose to provide products that simplify and speed up our customers’ Microsoft Dynamics 365 experience.”

Knowledgebase
LogIn
mscrm-addons.com
  • Products
  • Online Shop
  • Downloads
  • My Account
About Us
  • About Us
  • Case Studies
  • Newsletter
  • Partner Program
  • Contact
Support
  • Support
  • Terms & Conditions
  • Documentation
  • Webinars
  • Legal Documents
  • Impressum
  • © 2022 www.mscrm-addons.com. All Rights Reserved.