Chat integration with Microsoft Teams
If your DataMiner System is connected to dataminer.services, you can integrate your DataMiner System with Microsoft Teams using DataMiner Automation.
Tip
See also: dataminer.services
Prerequisites
Development prerequisites
If you want to create chat integration Automation scripts, you will need to make sure the following are installed:
Skyline.DataMiner.DcpChatIntegrationHelper NuGet package: You can find this package on nuget.org. It allows easy integration with business communication platforms from a DataMiner Automation script.
Tip
We recommend that you always use the latest version of the Skyline.DataMiner.DcpChatIntegrationHelper NuGet package.
DataMiner Integration Studio (DIS) Visual Studio extension: DIS is required for development of Automation scripts using the Skyline.DataMiner.DcpChatIntegrationHelper NuGet package. You can also use DIS to deploy Automation scripts directly from your development environment to your DataMiner Systems.
Server-side prerequisites
The DataMiner System must be connected to dataminer.services.
The Cloud Gateway module must be updated to version 2.9.0 or higher. See Upgrading nodes to the latest DxM versions.
Note
We highly recommend that you install the latest version of the DataMiner Cloud Pack. With older versions, not all features may be available.
Microsoft Teams prerequisites
You must allow the DataMiner bot in Microsoft Teams. For more information, refer to the Microsoft documentation.
Admin consent must be granted in the Admin app. You can revoke this consent at any time.
Note
You may need to regrant admin consent to enable new released features. This will be indicated in the dataminer.services change log.
Using chat integration
The following features are available:
- Creating teams
- Fetching all teams
- Creating channels
- Fetching all channels of a team
- Adding members or owners to your teams
- Sending notifications in channels in the name of the DataMiner Teams bot
- Sending notifications using Adaptive Cards in channels in the name of the DataMiner Teams bot
- Sending notifications using Adaptive Cards with buttons in channels in the name of the DataMiner Teams bot
- Creating a private chat between someone and the DataMiner Teams bot
- Fetching a private chat between someone and the DataMiner Teams bot
- Sending notifications in private chats in the name of the DataMiner Teams bot
- Sending notifications using Adaptive Cards in private chats in the name of the DataMiner Teams bot
- Sending notifications using Adaptive Cards with buttons in private chats in the name of the DataMiner Teams bot
To get started, you can find several example Automation scripts with more information on GitHub.
After you have made sure the above-mentioned prerequisites are in place, you can download and deploy the DcpChatIntegrationExamples DMAPP to your DataMiner System and immediately try out these examples.
Limitations
- Notifications cannot exceed 35 KB.
Security
By granting Admin consent from your Microsoft (Teams) tenant to "DataMiner" (i.e. Skyline Communications) in the Admin app, you allow Skyline Communications to execute these chat integration actions. This includes creating teams, channels, and chats, fetching users, chats, etc.
You can revoke this access at any time. See Granting admin consent for Teams Chat Integration.
Note
You may need to regrant admin consent to enable new released features. This will be indicated in the dataminer.services change log.