@sheerun/botbuilder-azure

Bot Builder SDK Azure Extensions

Usage no npm install needed!

<script type="module">
  import sheerunBotbuilderAzure from 'https://cdn.skypack.dev/@sheerun/botbuilder-azure';
</script>

README

Bot Builder Azure Extensions for Node.js

Bot Builder Azure Extensions for Node.js enable bot developers to integrate bots with specific Azure components.

High level features:

  • Azure Table Storage: Allows bot developers to store bot state in their own Azure Storage accounts. For more information on Azure Table Storage, visit the Azure Table Storage Documentation
  • Azure CosmosDb: Allows bot developers to store bot state in CosmosDb. For more information on Azure CosmosDb, visit the Azure CosmosDB Documentation
  • Azure SQL Database: Allows bot developers to store bot state using Azure SQL. For more information on Azure SQL, visit the Azure SQL Database Documentation

Prepare to Build a Bot

Create a folder for your bot, cd into it, and run npm init.

npm init

Get the BotBuilder, BotBuilder-Azure and Restify modules using npm.

npm install --save botbuilder
npm install --save botbuilder-azure
npm install --save restify

Sample

You can base your first bot on one of our samples, which showcase using Azure Table Storage, CosmosDb and Azure SQL Database. Read the detailed steps in the sample to set up storage emulators or connect to Azure.

Test your bot

Use the Bot Framework Emulator to test your bot on localhost.

Install the emulator from here and then start your bot in a console window.

node app.js

Start the emulator and say "hello" to your bot.

Publish your bot

Deploy your bot to the cloud and then register it with the Microsoft Bot Framework. If you're deploying your bot to Microsoft Azure you can use this great guide for Publishing a Node.js app to Azure using Continuous Integration.

NOTE: When you register your bot with the Bot Framework you'll want to update the appId & appSecret for both your bot and the emulator with the values assigned to you by the portal.

Bot Framework

The Microsoft Bot Framework provides just what you need to build and connect intelligent bots that interact naturally wherever your users are talking, from text/sms to Skype, Slack, Office 365 mail and other popular services.

Bots (or conversation agents) are rapidly becoming an integral part of one’s digital experience – they are as vital a way for users to interact with a service or application as is a web site or a mobile experience. Developers writing bots all face the same problems: bots require basic I/O; they must have language and dialog skills; and they must connect to users – preferably in any conversation experience and language the user chooses. The Bot Framework provides tools to easily solve these problems and more for developers e.g., automatic translation to more than 30 languages, user and conversation state management, debugging tools, an embeddable web chat control and a way for users to discover, try, and add bots to the conversation experiences they love.

Dive deeper

Learn how to build great bots.