This article covers integration to JIRA Software, JIRA Core, and JIRA Service Desk.
Please keep in mind that Integrations are not included in basic license packages. They have to be purchased separately as AddOns. For more information, please visit our website: http://www.teamviewer.com/integrations
To download the TeamViewer plugin for Jira Server or Jira Datacenter please download the latest version from the Atlassian Marketplace: TeamViewer Plugin for JIRA Server
There is a common integration client for JIRA Cloud and JSD platforms, which can be found at Atlassian Marketplace
Install the TeamViewer plugin using the steps below:
Install the TeamViewer plugin using the steps below:
Click Install to download and install the TeamViewer app.
First, you will need to configure the customer text that will be added to the ticket when a session is created. To set this, follow the steps below:
1. Log into your Jira instance as an admin.
2. Click the admin dropdown and choose Add-ons.
3. Select Manage Addon and then select TeamViewer plugin for Jira from the list.
4. There you can edit the desired text using 4 available variables as shown in the image below. Once finished click Save Settings.
You will then need to set up a custom field in Atlassian settings. Please follow the steps below:
1. Log into your Jira instance as an admin.
2. Click the admin dropdown and Issues.
3. Then select Custom field as shown in the screenshot below:
4. Select Add Custom field from the top right corner.
5. From the pop up select Advanced and then TeamViewer Issue Session Custom Field Plugin.
6. Click Next and then set a name for the custom field e.g. ‘TeamViewer Session’ as shown in the image below:
To configure the TeamViewer plugin, first, you will need to configure the customer text that will be added to the ticket when a session is created. To set this, follow the steps below (similar to JIRA Server):
For this integration, it is required that the admin creates an Oauth app in TeamViewer and set the necessary credentials in the plugin.
1. Copy the provided redirect URI provided in the plugin and store it somewhere.
2. Go to login.teamviewer.com and log in with the company administrator account.
3. Click on the user icon and select Edit profile.
4. Give the app a meaningful name.
5. Give the app a meaningful description.
6. Paste the redirect URI that was provided by the JIRA plugin in step 1.
7. Set the app permissions.
8. Click Create.
9. Copy the generated client ID and client Secret and paste in the Jira plugin.
10. Click Save.
Once the TeamViewer plugin has been installed, the user will first see the screen below:
and will need to click Connect and log in with their credentials so that their TeamViewer account is connected with the Jira account. They will only need to perform this once as their token is will be stored securely on the JIRA instance.
To remove the association between a TeamViewer account from the TeamViewer plugin, follow the steps below:
Once you have successfully installed and configured the TeamViewer for JIRA Cloud plugin, you will need to link an eligible TeamViewer account before you can use the functionality.
You can easily do this, by following the steps below:
1. Click on your avatar at the bottom left corner.
2. Select TeamViewer settings as shown in the image below:
3. On the next window click the Connect button as shown below and login with your TeamViewer account. You will only need to perform this task once as the account hash will be stored in the JIRA instance.
To disconnect/unlink a TeamViewer account from a JIRA account, go to the same TeamViewer settings and select Disconnect as shown in the image below.
For information on what TeamViewer licenses are eligible for use with the TeamViewer for JIRA plugin, please visit:
TeamViewer Integration For Jira
Use the TeamViewer Integration for Jira to discuss issues with your colleagues fast and easily. Share your screen from a JIRA issue and present it.
If the TeamViewer license activated on your TeamViewer account is not eligible to use the integration, you will see the following message in the plugin.
Once your eligible TeamViewer account has been connected you can start using the plugin. There are 2 main functions:
This functionality is only supported in JIRA Server, JIRA Datacenter, and JIRA Cloud versions. In JIRA Service Desk only the asynchronous interaction mode is supported.
Moreover, in order for this feature to be available, all users will need to enable public visibility of their email address, as this is used for contact mapping from the TeamViewer plugin.
This can be set in Avatar icon ➜ Account Settings ➜ Profile and Visibility. As shown below, the email address needs to be made visible to Anyone.
After you have successfully connected your TeamViewer account, the TeamViewer integration app will try to match the email address of the Submitter, Assignee and any Commentators to contacts in your TeamViewer account.
If the other parties have not shared their email addresses, you will see the screen below:
If they have shared their emails, but are not in the logged-in user’s contacts list, you will be able to add them easily by clicking the Add button (shown below):
Once the other party has accepted your invite and is online, then you will have the following interaction modes available:
, as shown in the screenshot below:
If the other parties are not available, then you have the option to create a TeamViewer session. This is essentially an invitation to start a remote control session and is valid for 24 hours by default. Once you create the session, the invitation will be added to the ticket.
In order to connect to the remote control session as the supporter, you will need to select the ‘Connect to session’ button in the TeamViewer plugin.
Below is a screenshot of a created session.