README.md

page_type	description	products	languages	extensions	urlFragment
sample	Demonstrating the feature where user can send adaptive card with different actions using bot.	office-teams office office-365	csharp	contentType createdDate samples 12/27/2022 12:30:00 PM	officedev-microsoft-teams-samples-bot-adaptivecard-actions-csharp

Send Adaptive Card Including Different Actions

This sample shows the feature where user can send Adaptive Card actions using bot.

Interaction with app

Prerequisites

• Microsoft Teams is installed and you have an account

• .NET SDK version 6.0

• ngrok or equivalent tunnelling solution

• Teams Microsoft Teams is installed and you have an account

Setup

1. Setup For Bot

   • Register a AAD aap registration in Azure portal Azure Active Directory – App Registrations.
   • Also, register a bot with Azure Bot Service, following the instructions here.
   • Ensure that you've enabled the Teams Channel
   • While registering the bot, use https://<your_ngrok_url>/api/messages as the messaging endpoint.

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

2. 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

• If you are using Visual Studio

• Launch Visual Studio

• File -> Open Folder

• Navigate to samples/bot-adaptive-card-actions/csharp/AdaptiveCardActions folder

• Select AdaptiveCardActions.sln solution file

• Modify the /appsettings.json and fill in the following details:

  • {{MicrosoftAppId}} - Generated from Step 1 is the application app id
  • {{MicrosoftAppPassword}} - Generated from Step 1, also referred to as Client secret

• Press F5 to run the project

4. Setup Manifest for Teams

• This step is specific to Teams.

  • Edit the manifest.json contained in the ./AppPackage 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 AppPackage 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 ./AppPackage 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

Deploy the bot to Azure

To learn more about deploying a bot to Azure, see Deploy your bot to Azure for a complete list of deployment instructions.

Further reading

• Actions
• Send suggested actions