This article applies to customers with a Premium or Corporate subscription license.

Platform requirements

Platform Version Requirements: 9.3.2 or later.

Out-of-the-Box Content Version Requirements: 9.3.2 or later (exception 9.4.0a)

Overview

The TeamViewer mergeable application (mApp™) integrates TeamViewer remote control and chat capabilities with CSM. The integration allows CSM users to initiate remote control sessions from within an Incident.

This mApp includes multiple features, including Stored Values (Client ID, Client Secret, State Value for Browser, Browser Close TeamViewer Session), Web Services (TeamViewer Authorization, TeamViewer Sessions, TeamViewer retrieve code), and One-Steps (Create TeamViewer Session, Close TeamViewer Session, Send TeamViewer Session Email, Automated Delete of TeamViewer Session, Browser Client TeamViewer Token Section, Browser Close TeamViewer Session), Business Objects to store TeamViewer Data (TeamViewer Session, TeamViewer Token), Stored Expression (CurrentDatePlusOneDay) Images (TeamViewer.jpg), and an Automation Process (Automated TeamViewer Cleanup) .

How the mApp Works

CSM provides the TeamViewer integration as a mApp so that Users can easily incorporate remote session functionality into their existing CSM system.

The mApp includes the following items:

Category Item Typical merge action

Business object

Incident relationship

  • Incident user owns TeamViewer user token
  • Incident owns TeamViewer session incident form

Incident form

  • TeamViewer

Import

Business object

TeamViewer session

Import

Business object

TeamViewer token

Import

One-steps

  • Create TeamViewer session
  • Close TeamViewer session
  • Send TeamViewer session email
  • Browser client TeamViewer token section
  • Browser close TeamViewer session
  • JoinAsAdmin TeamViewer

Import

Stored values

  • Client ID
  • Client secret
  • Close CodeVerifier for browser
  • Close state value for browser
  • CodeVerifier for browser
  • State value for browser

Import

Stored expression

CurrentDatePlusOneDay

Import

Images

TeamViewer.jpg

Import

Web services

  • TeamViewer authorization
  • TeamViewer sessions
  • TeamViewer retrieve code
  • TeamViewer ping

Import

Applying the TeamViewer mApp

To apply the mApp, perform the following high-level steps (the screenshots provided may vary, depending on systems and versions):

1) Download the mApp from the CSM mApp Exchange and save it to a location where you have access to apply it to your system.

2) Apply the mApp using the Apply mApp wizard in CSM Administrator. The Apply mApp wizard generates a Blueprint. 

3) While in the newly created Blueprint, select the Business Object, select , scroll to the bottom of the forms on the left pane and drag the TeamViewer form to the Tabs section of the screen. Right click on the TeamViewer tab and you are able to select or deselect an icon for the tab. Select the Green Checkbox to add this action to the Blueprint.

4) This Blueprint can now be viewed and published to a test or live system to commit the changes.

TeamViewer mApp for CSM Desktop Client

When complete, there will be a new Tab on the Incident business object with the integration controls ready to use. 

Using the TeamViewer mApp

To use the TeamViewer mApp, you must have a licensed CSM user and valid TeamViewer credentials. You must be viewing a saved incident from either the Desktop or Browser Client.

To Create a TeamViewer session within CSM:

  1. While in the Incident ticket, run the One-Step™ from the button on the TeamViewer Tab on the Incident form (Desktop Client or CSM Browser Client 10.0). If a requestor is defined in the ticket, their email address will be used for the TeamViewer session invitation email.
  2. When using the Desktop client, a pop-up will appear within CSM, asking you to logon via a browser session to TeamViewer, prompting you for your TeamViewer credentials, after that process has completed and your information is validated, you will receive a message from TeamViewer to return to the Cherwell record you were working on. In that record, click the Close on the Pop up and the process will continue. An email will be generated to be sent to the customer of that record with the link. After sending the email, the Join As Admin button will appear and you can then launch the TeamViewer Session.

When using the Browser client, a pop-up will appear within CSM, asking you to login via a browser session to TeamViewer, prompting you for your TeamViewer credentials, click ok. After that process has completed and your information is validated, you will receive a message from TeamViewer to return to the Cherwell record you were working on. In that record, click the Refresh button then go back to the TeamViewer Tab and click the Part 2 Browser button and the process will continue. An email will be generated to be sent to the customer of that record with the link. After sending the email, the Join As Admin button will appear and you can then launch the TeamViewer Session.

When the customer accesses the URL in the email, the TeamViewer session will be active.

To Close a TeamViewer session within CSM:

  • While in the Incident ticket, run the One-Step™ from the button on the form (Desktop Client or CSM Browser Client). The related Session will send a Close to TeamViewer and will delete the related TeamViewer Session. (note: if a user does not have a current Active Token record, the close button will need to be pressed a second time due to a bug found in the process).

To Send an Email link to the current session within CSM:

  • While in the Incident ticket, run the Share Session One-Step™ from the button on the form (Desktop Client or CSM Browser Client). The related Session will send an email to the current customer with the Customer Link.