csharp

page_type	description	products	languages	extensions	urlFragment
sample	Microsoft Teams sample app for demonstrating deeplink from Bot chat to Tab consuming Subentity ID	office-teams office office-365	csharp	contentType createdDate samples 07/07/2021 01:38:27 PM	officedev-microsoft-teams-samples-tab-deeplink-csharp

DeepLink

This sample displays how to consume SubEntity Id to DeepLink from Bot to Tab and Tab to Tab.

Prerequisites

Tools

• .NET Core SDK version 3.1

  # determine dotnet version
  dotnet --version

• Ngrok (Only for devbox testing) Latest (any other tunneling software can also be used)

  # run ngrok locally
  ngrok http -host-header=localhost 3978

• Teams Microsoft Teams is installed and you have an account

1. Clone the repository

   git clone https://github.com/OfficeDev/Microsoft-Teams-Samples.git

2. If you are using Visual Studio

• Launch Visual Studio
• File -> Open -> Project/Solution
• Navigate to samples\DeepLinkBot-SubEntityID\csharp folder
• Select DeepLinkBot.sln file

3. Run ngrok - point to port 3978 ngrok http -host-header=rewrite 3978
4. Create a new Bot by following steps mentioned in Build a bot documentation.

• Ensure that you've enabled the Teams Channel

5. Go to appsettings.json and add MicrosoftAppId and MicrosoftAppPassword information.
6. Update DeepLink Urls with MicrosoftAppID and EntityID with respective values in DeepLinkHelper class and HomeController.
7. Run your app, either from Visual Studio with F5 or using dotnet run in the appropriate folder.
8. Update the manifest.json file with Microsoft-App-ID,ContentUrl, WebsiteUrl and EntityID value.
9. Install the app in Teams.

Interacting with the app in Teams

1. Interact with DeepLink bot by pinging it in either personal scope or channel by @mentioning bot.

1. Select the option from the options displayed in the adaptive card. This will redirect to the respective Task in the static tab/ channel tab. Static Tab:

Channel Tab:

1. Click on Back to List to view all the options. User can select an option which will redirect to the respective Task in static tab/ channel tab.

Add this application in live meeting and stage the content.

While it's in stage view, using same deeplink to open tab will open the meeting side panel tab.

Additional Deep link features using Microsoft Teams SDK v2.0.0