This article applies to TeamViewer customers with a Premium or Corporate subscription plan.
The TeamViewer integration for Dynamics CRM embeds TeamViewer remote control functionality into your CRM Service Cloud and On-premise environment. This allows you to:
With TeamViewer, you can easily create TeamViewer Service Cases and provide remote support right from your Dynamics CRM cases. The remote troubleshooting experience is improved by optimizing communication between users and Call Center staff. Remote control helps to increase efficiency of service desks and to improve customer satisfaction significantly.
Note: The TeamViewer integration for Dynamics CRM will be supported only on the Microsoft Dynamics CRM supported browsers. Microsoft recommends latest version of Internet Explorer browser.
To be able to use this feature, you must meet the following requirements:
Note: All the screenshots are used as per Microsoft Dynamics CRM2016 On-Premise.
This article describes the installation and configuration of the TeamViewer App for Dynamics CRM Cloud and On-premise environments. It also provides a short overview of the various features provided by the application.
Installing the TeamViewer application is optional. In case you do not install TeamViewer, a run-once version of TeamViewer is downloaded when you try to join/initiate a TeamViewer session. Else, the TeamViewer window will be opened automatically. We recommend installing the TeamViewer application as this will reduce the time required to join a session. However, please note that you will need administrator access on your system in order to install TeamViewer.
To install the TeamViewer App, follow the below steps:
You may create a service case against any of the following entities:
You are allowed to create one service case per instance of the entity. Creating a service case initiates a new TeamViewer session. The below snapshot shows the various UI elements that will be available for the purpose of integrating with TeamViewer. While the snapshot shows an Account entity, the integration related UI elements will be common across all of the above entities.
The above image shows the state of a newly created account record. Since no service case has yet been created, the “New Service Case” button is in an enabled state. The remaining buttons are disabled. Here’s a quick note of the functions of the various buttons. These will be explained in more detail in the subsequent sections.
As the name suggests, this button allows you to create a new service case i.e. to establish a TeamViewer session. This button remains enabled as long as no valid service case exists for this entity instance or if the service case has expired.
In case the TeamViewer app is not installed on the system, clicking on this button either downloads the use-once TeamViewer app and then opens the corresponding TeamViewer session; else, it directly opens the relevant TeamViewer session. This button remains enabled as long as a valid and unexpired service case exists for this entity instance.
Clicking this link opens up the default email client with the addresses of all relevant contacts (i.e. all contacts associated to the entity instance) added to the “To” list and with the relevant email links (that enable the end users to join the TeamViewer session) in the body. This button remains enabled as long as a valid and unexpired service case exists for this entity instance.
Clicking this button closes the service case associated with the current entity instance. This button remains enabled as long as a valid and unexpired service case exists for this entity instance.
You will see a notification in case the customer has joined TeamViewer session corresponding to the current entity instance.
As mentioned earlier, In order to create a new service case, click on the “New Service Case” button. This will open up a new popup pointing to the TeamViewer site as shown below. Please note that the popup may get blocked by the browser’s popup blocker as shown below. In such cases, please instruct the browser to allow popups from the TeamViewer site.
Once the popup opens up, enter your TeamViewer credentials. In case the “I’m not a robot” checkbox does not show up, click on the “Sign In” button. Else, please check the checkbox, complete the reCAPTCHA challenge and then click on the “Sign In” button.
For the first time the supporter/customer need to verify and add devices in in the TeamViewer
Now you will notice that the “New Service Case” button now gets disabled and the “Join As Admin”, “Send Customer Link” and “Close Service Case” buttons now get enabled as shown in the snapshot below. In addition, the details of the service case are also shown.
This includes the following fields
As the name suggests, this is the ID of the TeamViewer session that was just created.
Clicking this link allows you to join the TeamViewer session as an admin. Please note that clicking on the “Join As Admin” achieves the same result.
This is the link which will be sent to the customer when you send an email to the customer by clicking on the “Send Customer Link” button.
This fields shows the date and time until when the service case is valid. This shows the UTC time. Once the “Service Case Valid until” date and time expires then the notification popup can’t be seen. In order to get the new notification of that customer joins the TeamViewer only if the Email is sent to customer through "Send Customer Link".
Click on the “Send Customer Link” button in order to send the Customer Link to the customer. Once you click on the button, a new popup opens up. The popup displays a list of Email Templates applicable for the entity along with the list of contacts associated with the entity instance.
Choose the appropriate email template and contact and click on the “Send” button. Once the “Send” button is clicked, an email message is opened on your default email client. The email id of the selected contact will be available in the "To" list. The remaining fields like the subject and contents will be populated as per the selected email template.
As an aside, please see the appendix to understand as to how you can add contacts to entities
As mentioned earlier, once the customer receives the email and once he/she joins the TeamViewer session by clicking on the customer link, you will notified via the notification message that appears on the Dynamics CRM page. Once notified, you can join the TeamViewer session by doing either of the following:
Once you perform the above, in case you do not install TeamViewer, a run-once version of TeamViewer is downloaded when you try to join/initiate a TeamViewer session. Else, the TeamViewer window will be opened automatically. Once you join the TeamViewer session, the customer will be notified of the same and he/she will be asked to provide permission for you to be able to view/control his/her screen. Once the customer provides the permissions, the session will be established and you will be able to view and control the user’s screen.
Once you have been able to conclude the session and once you do not need the session any longer, please click on the “Close Service Case” button. This will close the Service case. Once this is done, the “New Service Case” button gets enabled and the “Send Customer Link”, “Join As Admin” and “Close Service Case” buttons get disabled. In case you need to re-establish a session with the customer, please click on the “New Service Case” button.
You may view the closed sessions in the TeamViewer Connection History area. In order to view any recently closed sessions (that were closed after you opened the TeamViewer Connection History Page), click the refresh button.
TeamViewer CRM App are enabled to use on Account, Contact, Case, Lead, and opportunity entities in Microsoft Dynamics CRM supported versions. Therefore the security role for TeamViewer CRM App users should have the minimum privileges for below entities.
Microsoft Dynamics CRM Administrator & Customizers will have the full access of TeamViewer custom entities created on the solution “TeamViewer App”. Microsoft Dynamics CRM Administrator has a security role of “System Administrator” which gives full privileges to access and customize anything in the Microsoft Dynamics CRM.
CRM Administrators & Customizers manages the operation of application, and they are the
owners of the customizations as well. Any change to the customizations, users, workflows,
plugins, actions, web resources can be done by them. They manages the visibility of certain
entity records to different agent users or teams. They are also responsible for importing and
exporting the solutions (customizations) in CRM Systems.
CRM Customizers manage the customization of the applications and other systems integrations. They are the owners for the customization deployed in CRM, such as workflows, plugins, actions, web resources.
Below are the custom entities (display name) in TeamViewer App Solution.
Once TeamViewer App is installed from AppSource on the supported version of Microsoft Dynamics CRM then Microsoft Dynamics CRM system administrator should give proper security role to the user would be using TeamViewer CRM App.
Microsoft Dynamics CRM System Administrator has two choice to enable users to use TeamViewer CRM App and are listed below.
Minimum Security Role required for users to use TeamViewer CRM App are listed in below table. Apart from these security privileges users should have minimum privileges to login to Microsoft Dynamics CRM.
Note: The user with security role “TeamViewer User” will have user level access to TeamViewer Connection History, TeamViewer Current Session and TeamViewer User. Please refer below image.
Note: Additional security roles can be added by Microsoft Dynamics CRM administrator without affecting the existing functionality of the Microsoft Dynamics CRM, but needs to be careful while assigning the security roles to MS CRM users. Suggested method, is to test the affect in development or test environment and then deploy it in production.
TeamViewer CRM App are enabled with TeamViewer email template to use on Account, Contact, Case, Lead, and opportunity entities to send the TeamViewer customer link to its customer through Microsoft Dynamics CRM. However the Microsoft Dynamics CRM Administrator or Customizers can create their own customized TeamViewer email template to send it to their customer.
To create a TeamViewer email Template Microsoft Dynamics CRM Administrator or Customizers has to navigate to Settings> Templates> Email Templates do below customization.
Note: The user name HTML code will set the correct user name as it is the Name of the CRM user which is not variable and sent correctly to recipient. Not used in default TeamViewer email template.
To view the dashboard only Microsoft Dynamics CRM Administrator or Customizers can navigate to Sales/Service/Marketing > Dashboards > TeamViewer Activity Dashboard
Note: Security roles other than System Administrator and System Customizer can’t view “TeamViewer Activity Dashboard”. However Microsoft Dynamics CRM Administrator or Customizers can give privileges to any security role to access “TeamViewer Activity Dashboard”.
Microsoft Dynamics CRM Administrator or Customizers can give privileges to any security role to access “TeamViewer Activity Dashboard” by navigating to Settings > Customizations > Customize the System > Dashboards > Then select the “TeamViewer Activity Dashboard” and then “Enable Security Roles”
Microsoft Dynamics CRM Administrator or Customizers can create a new TeamViewer related dashboard or they can edit the existing “TeamViewer Activity Dashboard”.
Microsoft Dynamics CRM system administrator can insert Charts, List (Views), Iframes, Web
Microsoft Dynamics CRM Administrator or Customizers should navigate to Settings >
Customizations > Customize the System
They should open TeamViewer related entities and then they can proceed to create Views and Charts as per the requirement to add into the dashboard.
To know more about how to create Views and Charts kindly Google the procedure to create Microsoft Dynamics CRM Views and charts and also can refer different blogs on Views and Chart creation for Microsoft Dynamics CRM.
After the Views and Charts are created, go the Dashboard and then click new to create new dashboard.
Select the Dashboard layout as required, refer the image below. And then click Create button.
Give a meaningful name of the Dashboard. Example “Sample Dashboard” and then click the
Chart icon inside the layout. Then select the Record Type, Views and Charts created earlier.
Then click Add button and the Charts will be created for the dashboard. Now select the
dashboard and “Publish” it.
Note: This newly created dashboard will be enabled for all the security role by default. To
restrict this dashboard for other security roles the Microsoft Dynamics CRM Administrator or Customizers can give privileges to any required/selected security role to access the TeamViewer Dashboard.
By following above described process the Microsoft Dynamics CRM Administrator or Customizers can insert Charts, List (Views), Iframes, Web resources on the Dashboard.
Microsoft Dynamics CRM Administrator or Customizers can edit the existing dashboard
provided though TeamViewer Application (TeamViewer Activity Dashboard). System
Administrator or System Customizer should navigate to Settings > Customizations > Customize the System > Dashboard. Double Click the “TeamViewer Activity Dashboard”.
Microsoft Dynamics CRM Administrator or Customizers can change existing Charts by Clicking the old chart layout and then Click “EDIT COMPONENT” button. Then system Administrator or Customizers select another chart. And then click button set, SAVE and Publish the dashboard.
Microsoft Dynamics CRM Administrator or Customizers can also delete the Chart by clicking the “REMOVE” button. And then click button set, SAVE and Publish the dashboard.
In the same manner Microsoft Dynamics CRM Administrator or Customizers can increase/decrease the Width or increase/decrease height of the layout. Also they can do the operations on Charts, List (Views), Iframes, Web resources.
Microsoft Dynamics CRM Administrator or Customizers can only see the TeamViewer Company report at organization level.
There are two ways to view the TeamViewer Company report. Navigation through settings and Advanced Find.
TeamViewer App solution has the ability to run the TeamViewer Company Report automatically through Workflow scheduler. This Workflow scheduler runs every 10 hours and it fetch the details of company report from TeamViewer API.
Microsoft Dynamics CRM Administrator or Customizers can modify the scheduler timings by
Navigating to the Settings> Processes, then Click on the “TeamViewer Workflow Scheduler”.TeamViewer Workflow Scheduler can be configured by Clicking the blue marked time interval key word “Timeout until 23 Hours , 59 Minutes then”.On Click of “Timeout until 23 Hours, 59 Minutes then”, a new window will open where the Microsoft Dynamics CRM System Administrator or System Customizer can select the “Dynamic Values” and “After”
timing Hour and Minute to set the new timeframe to run the “TeamViewer Workflow Scheduler”.
Note: The TeamViewer Workflow scheduler will run automatically from the installation of
TeamViewer App solution in Microsoft Dynamics CRM supported versions. The Microsoft
Dynamics CRM Administrator or Customizers can view the status of the TeamViewer workflow scheduler by navigating to “Process Session” and get the details of status reason.
If Status Reason is Succeeded then the workflow will fetch records of all the TeamViewer
successfully completed session id reports from TeamViewer API and will show on the CRM
TeamViewer Report entity.
If Status Reason is Canceled/Failed then the workflow need to start manually.
Note: Microsoft Dynamics CRM Administrator or Customizers can create and configure an email notification on the TeamViewer Workflow scheduler for status reason Canceled or Failed to get notified on the stopped of TeamViewer Workflow scheduler. Thereafter they can run the TeamViewer Workflow scheduler manually through on-demand process.
Microsoft Dynamics CRM Administrator or Customizers should navigate to Settings> TeamViewer Area > Company Report (Click to open the entity form).
If no record is available then create a new dummy record by clicking the “New” button to run on demand TeamViewer Workflow Scheduler. Initially the TeamViewer Workflow scheduler will show status reason as Waiting and will succeeded after 10 hours (Currently, TeamViewer Workflow Scheduler is configured for 10 hours).
Then create a TeamViewer Company dummy record and run the on demand TeamViewer Workflow scheduler. And with this the TeamViewer Workflow scheduler will start running.
Microsoft Dynamics CRM System Administrator or System Customizer can enable Plug-in Trace Log to get the error from any of the TeamViewer plugins. Which then can be reported to TeamViewer GmbH support team to get the fixes.
Navigation to enable Plug-in Trace Log: Settings > Administration > System Settings > Customization > Plug-in and custom workflow activity tracing
To get the plug-In Tracing Log the Microsoft Dynamics CRM System Administrator or System Customizer should set Plug-in and custom workflow activity tracing to “All”. And then Click “Ok”.
Once the Plug-in and custom workflow activity tracing to “All” then the Microsoft Dynamics CRM System Administrator or System Customizer should be able to see all the error report inside the “Plug-In Trace Log”.
Navigation to Plug-In Trace Log: Settings > Plug-In Trace Log, and then Click it to Open the form and view the issue log.
You may add contacts to entities by clicking on the ‘+’ button in the Contacts section. Please see the snapshot below for reference.
On click of the ‘+’ button, a quick create form opens up where you can add the Name and email address of the contact. Click the Save button to link the contact to the account.
Once the contact is created and added, it appears in the grid as shown below. Please note that emails are sent to Account’s contact. For lead, Opportunity and Case if Account is selected then the email will be sent to the Account’s Primary contact.
To create Account’s Primary contact Click the lookup of the Primary customer and then Magnifying search button and then click on “+ New” and create the Contact and that will be added to Account as Primary contact.
Create the contact from Quick create form and ensure that the Account name is same as the Account created.
Once the Primary contact is created it will show up in the account form as shown in the below image with email id.