node-red-contrib-viseo-botbuilder 0.2.14

A MS BotBuilder implementation for Node-RED

npm install node-red-contrib-viseo-botbuilder

A Node-RED wrapper on top of Microsoft Bot Builder Framework.

This node is part of project node-red-contrib-viseo powered by VISEO Technologies.

Here is a French Article on Bot Ecosystem and more.

Quick Start

npm install node-red-contrib-viseo-botbuilder


Node Description
Bot Microsoft BotBuilder Server
Send Card Send a reply message to the user
Luis Query MS LUIS and return first intent
Event Handle bot's event like replies
Profile Update user's profile from current message
FB Profile Update user's profile from facebook data
FB Greeting Set Messenger Greeting message
FB Log Send custom events to Facebook analytics
Attachement Download message attachements

Configuration can be set in nodes or in a configuration file. A configuration is easier to manage with multiple server. The absolute path to this file must be defined in ENV var BOTBUILDER_CFG.

Get Started

Here is a sample configuration to start you server. Switch will route to the convenient SendCard according to business logic.

Kickstart Nodes

        "id": "c7121754.6ec158",
        "type": "send-card",
        "z": "bd95e24.b107d2",
        "name": "",
        "prompt": false,
        "delay": 0,
        "sendType": "text",
        "text": "Hey buddy",
        "random": false,
        "media": "",
        "title": "",
        "subtitle": "",
        "subtext": "",
        "attach": "",
        "carousel": false,
        "buttons": [],
        "quicktext": "",
        "quickreplies": [],
        "bt1action": "postBack",
        "bt2action": "postBack",
        "bt3action": "postBack",
        "quickbt1action": "postBack",
        "quickbt2action": "postBack",
        "quickbt3action": "postBack",
        "quickbt4action": "postBack",
        "quickbt5action": "postBack",
        "quickbt6action": "postBack",
        "quickbt7action": "postBack",
        "quickbt8action": "postBack",
        "quickbt9action": "postBack",
        "quickbt10action": "postBack",
        "quickbt11action": "postBack",
        "x": 470,
        "y": 240,
        "wires": [
        "id": "2e5843e7.e7af2c",
        "type": "bot",
        "z": "bd95e24.b107d2",
        "name": "",
        "port": "",
        "appId": "",
        "appPassword": "",
        "fmsg": "markdown",
        "x": 120,
        "y": 100,
        "wires": [
        "id": "3a3d6ec9.d221a2",
        "type": "profile",
        "z": "bd95e24.b107d2",
        "name": "",
        "x": 303,
        "y": 163,
        "wires": [
        "id": "a6d205d0.d17178",
        "type": "nedb",
        "z": "bd95e24.b107d2",
        "name": "Save User",
        "key": "",
        "value": "user",
        "operation": "set",
        "x": 283,
        "y": 243,
        "wires": [
        "id": "533957d5.fc5c68",
        "type": "fb-profile",
        "z": "bd95e24.b107d2",
        "x": 293,
        "y": 203,
        "wires": [
        "id": "bc3c4420.419ee8",
        "type": "nedb",
        "z": "bd95e24.b107d2",
        "name": "Fetch User",
        "key": "",
        "value": "user",
        "operation": "get",
        "x": 283,
        "y": 123,
        "wires": [

Tips & Tricks

  • The BotBuilder require an access to Microsoft Bot Framework
  • A new HTTP server is started if config.json has been configured on port 3978 otherwise the Node-RED server is reused.
  • An SSL certificate is required to work and must be declared in config.json OR node-red-config.js (depends if you start a new server)
  • Users' storage is performed by any storage node like NeDB.


  • The profile node handle the default locale
  • The user's locale is defined throught MSBotBuilder priorities
  • All fields of Card node are translated according to the user's locale
  • Locales files are defined in /data/locales/lang_country.json

The JSON file can be generated from XLSX:

node path/to/xlsx2json.js path/to/input.xlsx path/to/output.json

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-2017 VISEO under the Apache 2.0 license.

Node Info

Version: 0.2.14
Updated 1 day ago
License: Apache-2.0


461 in the last day
1208 in the last week
1696 in the last month


  • luis
  • wechat
  • profile
  • bot-event
  • bot-continue
  • attachement
  • fb-profile
  • fb-greeting
  • fb-log


  • node-red


  • jpencausse
  • tothi-viseo