Creating workflows for TeamViewer assets

Let Oomnitza be your single source of truth!

You'll get complete visibility of your assets as data from TeamViewer is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and TeamViewer in minutes

You'll get visibility of your TeamViewer assets by creating configurable workflows to automate tasks such as:

• Onboarding and offboarding devices
• Updating and retrieving device information, such as the online state, supported features, and the last usage date

Let Oomnitza be your single source of truth!

You'll get visibility of your devices as data from TeamViewer is automatically transformed into consumable information and actionable insights.

Before you start

Creating workflows

Create asset workflows

TeamViewer Get Device Details

TeamViewer Update Device

TeamViewer Create Device

TeamViewer Delete Device

Before you start

Before you can create the integration with Oomnitza, you need to have added your TeamViewer credentials to Oomnitza. For further information, see Adding your TeamViewer credentials to Oomnitza.

We recommend that you also create the extended integration for TeamViewer assets. You can use the information retrieved in these integrations to trigger workflows that can get assets, update assets and create assets.

Creating workflows

Create asset workflows

To create an asset workflow, you must complete these steps:  

1. Click Configuration > Workflows 
2. Click Add (+) and select Assets from the list.
3. Drag and drop the API block onto the Sandbox.
4. Click Edit on the API block and enter TeamViewer in the search field. 
5. Select a preset:
   • TeamViewer Get Device Details
   • TeamViewer Update Device
   • TeamViewer Create Device
   • TeamViewer Delete Device
6. To choose a preset, click the forward arrow (>).
7. Select the credentials that you created in Adding your TeamViewer credentials to Oomnitza.
   
8. Configure the API Block following the preset instructions below, and save your changes.
9. Edit the Begin Block and add rules to trigger the workflow. For example, if you set the Actions to New you can trigger a workflow every time a new asset is created. Refer to Using the Begin block.
10. Connect the Blocks. 
11. Save, validate, and activate your workflow.

Using the TeamViewer Get Device Details preset

This TeamViewer Get Device Details preset returns the details of a TeamViewer asset, by ID. You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Information tab. You will notice that the TeamViewer Asset ID is referenced in the property {{teamviewer_asset_id}}.Follow the mapping steps in Creating custom mappings so that this property exists in Oomnitza and is populated with information before you run this workflow.
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. Once you have the entire response, you can then parse the JSON response values to custom Oomnitza fields as per the example below.

For further information, refer to the TeamViewer API Documentation: GET Device.

Using the TeamViewer Update Device preset

This TeamViewer Update Device preset updates a TeamViewer asset, by ID. When you select this preset you need to supply the following information:

1. Description: The Device Description.
2. Policy ID: The Policy ID. If you have fetched this information already using the extended integration for TeamViewer assets or Get Device Details preset you can call a value in the workflow by entering: {{policy_id}}

The Asset ID required to update the device is referenced in the {{teamviewer_asset_id}} property in Advanced Mode>Information. 

Warning
If successful, this workflow returns a204 No Contentresponse code.

For further information, refer to the TeamViewer API Documentation: PUT Device.

Using the TeamViewer Create Device preset

This TeamViewer Create Device preset creates a TeamViewer device. When you select this preset you need to supply the Remote Control ID, Group ID, and Password of the new user.

Tip
Use the extended integration for TeamViewer assets or Get Device Details preset to fetch the Remote Control ID and Group ID. You can call a value in the workflow by entering: {{remote_control_id}} and {{group_id}}

Select Advanced Mode > Response to map the entire response similar to the Get Device Details preset.

For further information, refer to the TeamViewer API Documentation: POST Device.

Using the TeamViewer Delete Device preset

This TeamViewer Delete Device preset deletes a TeamViewer device, by ID. The Asset ID required to update the device is referenced in the {{teamviewer_asset_id}} property in Advanced Mode>Information. 

Warning
If successful, this workflow returns a204 No Contentresponse code.

For further information, refer to the TeamViewer API Documentation: DELETE Device.

Reference articles for workflows

• Mapping positive and negative responses
• Troubleshooting workflows 
• Using the API block