Skip to content

Latest commit

 

History

History
114 lines (82 loc) · 4.56 KB

README.md

File metadata and controls

114 lines (82 loc) · 4.56 KB
Raw
page_type description products languages extensions contentType createdDate
sample
Get real time meeting events
office-teams
office
office-365
csharp
samples
11-10-2021 17:35:46

Realtime meeting events

Using this C# sample, a bot can receive real-time meeting events. For reference please check Real-time Teams meeting events

The feature shown in this sample is currently available in public developer preview only.

Meeting start event Meeting end event

Prerequisites

NOTE: The free ngrok plan will generate a new URL every time you run it, which requires you to update your Azure AD registration, the Teams app manifest, and the project configuration. A paid account with a permanent ngrok URL is recommended.

To try this sample

  1. Create a Bot Registration In Azure portal, create a Bot Framework registration resource.

    • 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 bot you will create an App ID and App password - make sure you keep these for later.

  1. Clone the repository

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

  2. In a terminal, navigate to samples/meetings-events/csharp

    # change into project folder
cd # MeetingEvents

  3. Run ngrok - point to port 3978

# ngrok http -host-header=rewrite 3978

  1. Modify the manifest.json in the /AppPackage folder and replace the following details

    • <<App-ID>> with your app id
    • <<VALID DOMAIN>> with your app domain e.g. *.ngrok.io

  2. Zip the contents of AppPackage folder into a manifest.zip, and use the manifest.zip to deploy in app store or add to Teams as in step 9.

  3. Modify the /appsettings.json and fill in the {{ MicrosoftAppId }},{{ MicrosoftAppPassword }} with the id from step 2.

    1. Run the app from a terminal or from Visual Studio, choose option A or B.

A) From a terminal

# run the app
dotnet run

B) Or from Visual Studio

  • Launch Visual Studio
  • File -> Open -> Project/Solution
  • Navigate to MeetingEvents folder
  • Select MeetingEvents.csproj file
  • Press F5 to run the project
  1. Add in a meeting to test - Select Apps from the left panel. - Then select Upload a custom app from the lower right corner. - Then select the manifest.zip file from appPackage. - After installation, add the bot to a meeting.

Interacting with the bot in Teams

Once the meeting where the bot is added starts or ends, real-time updates are posted in the chat.

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