csharp

page_type	description	products	languages	extensions	urlFragment
sample	Microsoft Teams tab sample app for demonstrating create conversation tab	office-teams office office-365	csharp	contentType createdDate samples 06/10/2021 01:48:56 AM	officedev-microsoft-teams-samples-tab-conversations-csharp

Conversational Tabs

This Teams tab app provides a way to allow users to have conversations about sub-entities in the tab Create conversational tabs

Interaction with app

Prerequisites

• .NET Core SDK version 6.0

  # determine dotnet version
  dotnet --version

Setup

1. Register a new application in the Azure Active Directory – App Registrations portal.

NOTE: When you create your app registration, you will create an App ID and App password - make sure you keep these for later.

2. Setup NGROK

• Run ngrok - point to port 3978

# ngrok http -host-header=rewrite 3978

3. Setup for code

• Clone the repository

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

• Run the bot from a terminal or from Visual Studio:

  A) From a terminal, navigate to samples/tab-conversations/csharp

  # run the bot
  dotnet run

  B) Or from Visual Studio

  • Launch Visual Studio
  • File -> Open -> Project/Solution
  • Navigate to tab-conversations folder
  • Select TabConversation.csproj file
  • Press F5 to run the project

4. Setup Manifest for Teams

• This step is specific to Teams.

  • Edit the manifest.json contained in the ./AppManifest folder to replace your Microsoft App Id (that was created when you registered your app registration earlier) everywhere you see the place holder string {{Microsoft-App-Id}} (depending on the scenario the Microsoft App Id may occur multiple times in the manifest.json)
  • Edit the manifest.json for validDomains and replace {{domain-name}} with base Url of your domain. E.g. if you are using ngrok it would be https://1234.ngrok.io then your domain-name will be 1234.ngrok.io.
  • Zip up the contents of the AppManifest folder to create a manifest.zip (Make sure that zip file does not contains any subfolder otherwise you will get error while uploading your .zip package)

• Upload the manifest.zip to Teams (in the Apps view click "Upload a custom app")

  • Go to Microsoft Teams. From the lower left corner, select Apps
  • From the lower left corner, choose Upload a custom App
  • Go to your project directory, the ./AppManifest folder, select the zip folder, and choose Open.
  • Select Add in the pop-up dialog box. Your app is uploaded to Teams.

Running the sample

• Tab showing actions that can be performed

• Open Conversation - opens a new conversation

• Close Conversation - closes the conversation view

NOTE: We should save the subEntityId and conversationId to continue an existing conversartion.

• Deeplink to Conversation - opens the conversation in channel

Related Samples

• Proactive Tab Conversations, using a bot to create conversational tabs programmatically.

Further reading

• Bot Framework Documentation
• Bot Basics
• User Specific Views
• Sequential Workflows
• Up to date cards
• Universal Bot Action Model
• Azure Portal
• Activity processing
• Azure Bot Service Introduction
• Azure Bot Service Documentation
• Azure CLI
• Azure Portal
• Language Understanding using LUIS
• Channels and Bot Connector Service
• dotenv
• Microsoft Teams Developer Platform