The target of this the TeamViewer App for Microsoft Teams is to enable supporters and end users to use remote control and remote assistance, share devices and monitory their active sessions and connection history.
This document intends to address all users using both TeamViewer and Microsoft Teams.
It is assumed that the reader is familiar with using Microsoft Teams. The support user needs to have a valid TeamViewer login/password and an associated valid license.
The TeamViewer App for Microsoft Teams is supported on the desktop, web, and mobile versions of Microsoft Teams.
Teams on the web support recent versions of main browsers.
The desktop version is available on Windows, Mac, and Linux.
Mobile clients are available on iOS and Android.
Details available at: https://docs.microsoft.com/en-us/microsoftteams/get-clients
The TeamViewer-Microsoft Teams app embeds TeamViewer remote control functionality into Microsoft Teams. This allows you to:
This manual describes the installation and configuration of the TeamViewer App for Microsoft Teams. It also provides a short overview of the various features provided by the application.
Installing the TeamViewer application is required for supporters in order to be able to initiate remote control and Pilot (Augmented Reality) connections and optional for all other users on Windows, Mac and Linux. If the full TeamViewer client is not installed on the aforementioned Operating systems, a run-once version of TeamViewer is downloaded when you try to join a TeamViewer session as the supported party. On mobile (Android, iOS) the respective TeamViewer client (Quick Support or Pilot) is required. 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 to install TeamViewer.
To install the TeamViewer App, follow the below steps
The app can be found and installed directly from the Microsoft Teams Apps store (“Apps” icon in the left sidebar menu)
It can be installed personally to get personal tabs, and/or for a specific team or a group chat to provide configurable tab and extensions to their users:
You can also add directly to a group chat or a team via the “Apps” menu / “More Apps” (specific permissions in Microsoft Teams may be required).
The TeamViewer app for Microsoft Teams is composed of 4 main components:
After installation, the bot sends you a welcome message with an overview of the app features.
A “Get Started” button leads you to the “Settings” tab to login and check your available licenses.
You need to login with your licensed TeamViewer account to be able to use all different features of the TeamViewer integration e.g. to initiate Remote Control and Pilot connection invites, share devices etc. However you don’t require a TeamViewer account or to login to the integration app in order to receive connections on your device.
Also logging in with a valid TeamViewer account is required on all tabs with the exception for the “Help” tab.
Clicking on “Login” opens a popin, where you will need to enter your TeamViewer credentials and grant permissions required by the application.
You can logout from all authenticated tabs using the top right menu displaying your account name.
📌Important: when you logout, all your selected groups shared in tabs, and all automatically invited users will be removed.
This tab is displaying a knowledge base about the application.
You can find information about your TeamViewer licenses depending on your TeamViewer account’s role.
, example of Pilot license blocked:
If you are not a TeamViewer administrator, then you can see which licenses are available (i.e. active if you have the license AND the administrator has allowed it), but will not be able to change them.
In this tab, you can find the active sessions created in Microsoft Teams through the messaging extensions (described later).
If you are not an administrator, you can only see your own sessions.
In the Active Session tab, you can find the following information:
The list of active sessions and session status (online or offline) is automatically refreshed every 30 seconds.
You can sort data based on any column (sorted on “created on” descending by default) and use pagination if needed.
In this tab, you can find listing of all connections created in Microsoft Teams through the messaging extensions (described later).
If you are not an administrator, you can only see your own connections and filter them on a specific period (From / To Date).
Connections list is automatically refreshed on first load and every 30 seconds, while you’re viewing the tab.
The following information are available in the table:
You can sort data (sorted on “Start Date” descending by default), use pagination and filters if needed. You can click on a connection to show more details.
Here are the properties displayed in the details panel:
A loader with a warning message “Background synchronizing…” is displayed when the automatic background synchronization is started to update the connections every time you go to the tab with a minimum of five minutes between them.
You can add a configuration “TeamViewer” tab to a channel or a group chat if you have the permission to do so in Microsoft Teams:
You can give a name for the tab and select which groups (at least one) you want to share to other channel or group users:
After this, all devices from these groups will be displayed for channel or group users with the following information:
You can filter the list by device and group names.
Devices list and statuses are updated automatically every 30 seconds.
When another user (who has logged in to a TeamViewer account before) goes to the TeamViewer tab, then the shared groups of the tab will be shared automatically with his TeamViewer account.
If this is an external user (his TeamViewer account is part or a different company), then he will receive an invitation email to accept the group sharing and see a relevant message at the top of the tab, as shown below.
Once a tab is configured, you and other users can edit the tab (depending on Microsoft Teams permissions) via the “Settings” option.
They can add or remove groups to the tab. All devices from all these shared groups will be available and follow the same automatic sharing process.
If a device is online, the “Connect” button will become blue, and you can start a remote control connection by clicking on it.
You can also rename the tab or remove it.
You can create Remote Control or Pilot connection invitations through the two following of extensions.
You can create invitation cards directly from the compose area:
Both actions will trigger a popin. Depending on your TeamViewer license(s), you may get one of these cases:
If you have a TeamViewer license, but the functionality is restricted by the administrator, or you have no available license, then you will see an error message.
The invitation card is added to your compose area, and you must send the message in order to share your invitation to other chat users.
When the user who wants to receive the support clicks on “Launch session” then his/her device is ready to receive the connection
A second (supporter) card is also sent in parallel by the TeamViewer bot in the “Activity” tab of the application. This supporter card lets you:
💡 Note: status should be automatically updated during the first few minutes after the invitation has been created.
On top of Microsoft Teams there is the “Command box” where you can mention the app to generate session invitations similar than in the compose area:
You can choose between “Remote Control” and “Pilot” to directly create session with the right type.
You can then copy/paste the card with the top right icon in the compose area to share it in a discussion.
If you do not have any TeamViewer licenses, a trial version is automatically activated for a duration of 30 days.
During this period, all features of the integration application will be available. Please note this trial only refers to the TeamViewer integration to Microsoft Teams app and doesn’t affect other TeamViewer usage trials. For this reason, Remote Control and Pilot connections
You can check the end date of your trial in the “Settings” tab, and the “trial” mention is displayed in the logout link.