node-red-contrib-viseo-ms-graph 0.2.9

VISEO Bot Maker - Microsoft Graph

npm install node-red-contrib-viseo-ms-graph

Performs an OAuth2 Authentication with Microsoft Graph, and then uses the API such as Excel.

This node is part of project node-red-contrib-viseo powered by VISEO Technologies. Please find the node documentation in the Node-RED info tab.

Here is a French Article on Bot Ecosystem and more.

Quick Start

To use the Microsoft Graph Connect Sample for Node.js, you need either a Microsoft account or a work or school account

npm install node-red-contrib-viseo-ms-graph

Register the Application

  1. Sign into the App Registration Portal using either your personal or work or school account.
  2. Choose Add an app.
  3. Enter a name for the app, and choose Create application. The registration page displays, listing the properties of your app.
  4. Copy the Application Id. This is the unique identifier for your app.
  5. Under Application Secrets, choose Generate New Password. Copy the password from the New password generated dialog. You'll use the application ID and password (secret) to configure the sample app in the next section.
  6. Under Platforms, choose Add Platform.
  7. Choose Web. (You already should have Native Platform, otherwise add it too)
  8. Enter https://server.url:1880/callback-auth as the Redirect URI.
  9. Choose Save.

Build the Node-RED Flow

This sample demonstrate an authentication throught a ChatBot.



The first row build an URL to with credentials then send a ChatBot Sign-In Card

Callback URL

The second row

  • handle HTTP GET Request to /callback-auth and answer a "Thank You" message.
  • the callback code is resolved into a refreshToken and accessToken.
  • the callback state is resolved to fetch the ChatBot user, save the credential and send back a message.

API Testing

The third row try to retrieve the microsoft profile with an HTTP request to

Getting Help

For further help, or general discussion, please use the github issue tracker and in order to be labeled with question tag please specify :

  • Your message is a question / discussion
  • The module or node name


Before raising a pull-request, please read our contributing guide.

This project adheres to the Contributor Covenant 1.4. By participating, you are expected to uphold this code. Please report unacceptable behavior to any of the project's core team.


This project is a creation of VISEO Technology.

Copyright 2016-2019 VISEO under the Apache 2.0 license. Copyright 2012-2019 SARAH under the Apache 2.0 license.

Node Info

Version: 0.2.9
Updated 2 weeks, 4 days ago
License: Apache-2.0


0 in the last day
36 in the last week
700 in the last month


  • ms-graph
  • ms-graph-config
  • ms-graph-excel


  • viseo
  • sarah
  • node-red
  • microsoft
  • graph
  • oauth
  • excel


  • jpencausse
  • klervix
  • tothi-viseo