nodejs

page_type	description	urlFragment	products	languages	extensions	contentType	createdDate
sample	This sample app demonstrates sending change notifications to user presence in Teams based on user presence status.	teams-graph-change-notification-nodejs	office-teams office office-365	nodejs		samples	07-07-2021 13:38:26

Change Notification sample using nodejs

Bot Framework v4 ChangeNotification sample.

This sample app demonstrates sending notifications to users when presence status is changed.

Prerequisites

• Microsoft Teams is installed and you have an account

• Node.js version 10.14 or higher

  #determine node version
  node --version

• ngrok or equivalent tunnelling solution

1. Clone the repository

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

2. Open from Visual Studio code

   • Launch Visual Studio code
   • File -> Open Folder
   • Navigate to samples/graph-change-notification/nodejs folder
   • Run npm command in the terminal

     npm install

   • Press F5 to run the project

3. Run ngrok - point to port 3978

     ngrok http -host-header=rewrite 3978

Instruction on setting connection string for bot authentication on the behalf of user

1. In the Azure portal, select your resource group from the dashboard.

2. Select your bot channel registration link.

3. Open the resource page and select Configuration under Settings.

4. Select Add OAuth Connection Settings.

   

5. Complete the form as follows:

   

a. Enter a name for the connection. You'll use this name in your bot in the appsettings.json file. For example BotTeamsAuthADv1.

b. Service Provider. Select Azure Active Directory. Once you select this, the Azure AD-specific fields will be displayed.

c. Client id. Enter the Application (client) ID that you recorded for your Azure identity provider app in the steps above.

d. Client secret. Enter the secret that you recorded for your Azure identity provider app in the steps above.

e. Grant Type. Enter authorization_code.

f. Login URL. Enter https://login.microsoftonline.com.

g. Tenant ID, enter the Directory (tenant) ID that you recorded earlier for your Azure identity app or common depending on the supported account type selected when you created the identity provider app. h. For Resource URL, enter https://graph.microsoft.com/ i. Provide Scopes like "Presence.Read, Presence.Read.All"

• Ensure that you've enabled the Teams Channel

Update the appsetting

1. Update MicrosoftAppId and MicrosoftAppPassword in the .env that is created in Azure.
2. Add connectionName created in step 5.
3. Update notificationUrl as {NgrokBaseURL}/api/notifications

Concepts introduced in this sample

• After sucessfully installation of app you will get a sign in button. When sign in is complete then you get your current status in adapative card

• After that when the user status chagnes you will get notify about their status:

• Change user status from available to busy like

• Change user status from busy to busy offline

Further reading

• Bot Authentication
• Change Notification
• App in Catalog
• Bot Framework Documentation
• Bot Basics