Skip to content

Latest commit

 

History

History
133 lines (90 loc) · 5.51 KB

README.md

File metadata and controls

133 lines (90 loc) · 5.51 KB
Raw
page_type description products languages extensions urlFragment
sample
Demonstrating on how a bot can receive all channel messages with RSC without @mention.
office-teams
office
office-365
csharp
contentType createdDate
samples
06/10/2021 01:48:56 AM
officedev-microsoft-teams-samples-bot-receive-channel-messages-withRSC-csharp

Receive Channel messages with RSC permissions

Using this C# sample, a bot can receive all channel messages with RSC without @mention.

This feature shown in this sample is currently available in Public Developer Preview only.

Interaction with app

RSC Module

Prerequisites

  • .NET Core SDK version 6.0

    determine dotnet version

    dotnet --version

  • Ngrok (For local environment testing) Latest (any other tunneling software can also be used)

  • Teams Microsoft Teams is installed and you have an account

Setup

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

  2. Setup for Bot

  • Register a AAD aap registration in Azure portal.
  • 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.
  1. Setup Ngrok
  • Run ngrok - point to port 3978
 ngrok http -host-header=rewrite 3978
  1. Setup for code

  • Clone the repository

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

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

    • {{BOT-ID}} - Generated from Step 1 while doing AAd app registration in Azure portal.
    • {{BOT-PASSWORD}} -Generated from Step 1, also referred to as Client secret

  • Run in Visual Studio

    • Launch Visual Studio
    • File -> Open -> Project/Solution
    • Navigate to ReceiveMessagesWithRSC folder
    • Select ReceiveMessagesWithRSC.csproj file
    • Press F5 to run the project
  1. 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 bot earlier) everywhere you see the place holder string <<YOUR-MICROSOFT-APP-ID>> (depending on the scenario the Microsoft App Id may occur multiple times in the manifest.json) also update the <<DOMAIN-NAME>> with the ngrok URL`

    • Edit the manifest.json for <<MANIFEST-ID>> replace it with any GUID using guid generator.

    • Edit the manifest.json for webApplicationInfo resource "api://botid-{{MicrosoftAppId}}" with MicrosoftAppId. E.g. "api://botid-{{MicrosoftAppId}}".

    • Zip up the contents of the AppManifest folder to create a manifest.zip

    • Sideload in a team to test

      • Select or create a team
      • Select the ellipses ... from the left pane. The drop-down menu appears.
      • Select Manage Team, then select Apps
      • Then select Upload a custom app from the lower right corner.
      • Then select the manifest.zip file from AppManifest, and then select Add to add the bot to your selected team.

Interacting with the bot in Teams

Select a channel and enter a message in the channel for your bot.

The bot receives the message without being @mentioned.

Running the sample

App Installation

  • Showing Welcome message

Channel messages

  • Showing messages based on option selected

Channel messages

  • Adding to group chat

Add To Group Chat

  • Receives messages in group chat without being @mentioned.

Channel messages

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