page_type | description | products | languages | extensions | contentType | createdDate | ||||
---|---|---|---|---|---|---|---|---|---|---|
sample |
Get real time meeting events |
|
|
samples |
11-10-2021 17:35:46 |
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.
-
.NET Core SDK version 3.1
# determine dotnet version dotnet --version
-
Publicly addressable https url or tunnel such as ngrok or Tunnel Relay
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.
-
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.
-
Clone the repository
git clone https://github.com/OfficeDev/Microsoft-Teams-Samples.git
-
In a terminal, navigate to
samples/meetings-events/csharp
# change into project folder cd # MeetingEvents
-
Run ngrok - point to port 3978
# ngrok http -host-header=rewrite 3978
-
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
-
Zip the contents of
AppPackage
folder into amanifest.zip
, and use themanifest.zip
to deploy in app store or add to Teams as in step 9. -
Modify the
/appsettings.json
and fill in the{{ MicrosoftAppId }}
,{{ MicrosoftAppPassword }}
with the id from step 2. -
- 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
- 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 fromappPackage
. - After installation, add the bot to a meeting.
Once the meeting where the bot is added starts or ends, real-time updates are posted in the chat.
To learn more about deploying a bot to Azure, see Deploy your bot to Azure for a complete list of deployment instructions.