sp-dev-fx-webparts/samples/react-bot-framework-secure/bot

Echo bot

Summary

This bot has been created using Bot Framework. It shows how to create a simple bot that accepts input from the user and echoes it back.

Prerequisites

• Node.js version 10.14.1 or higher

  # determine node version
  node --version
  

To try this sample locally

• Clone the repository

  git clone [Placeholder]
  

• In a console, navigate to [Placeholder]

  cd [Placeholder]
  

• Install modules

  npm install
  

• Start the bot

  npm start
  

Testing the bot using Bot Framework Emulator

Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel.

• Install the Bot Framework Emulator version 4.3.0 or greater from here

Connect to the bot using Bot Framework Emulator

• Launch Bot Framework Emulator
• File -> Open Bot
• Enter a Bot URL of http://localhost:3978/api/messages

(Opt.) Deploy the bot to Azure

To learn more about deploying a bot to Azure, see Deploy your bot to Azure for a complete list of deployment instructions.

(Opt.) Testing Direct Line token generation

• Connect to Direct Line

• Add DirectLineSecret to .env

  DirectLineSecret=YOUR_DIRECT_LINE_SECRET
  

• Start the bot

  npm start
  

• Open PostMan and setup a post request to http://localhost:3978/directline/token with the following json request body:

  {
      "user": "USER_ID"
  }
  

  Then you can see the Direct Line token generated with YOUR_DIRECT_LINE_SECRET and USER_ID:

  {
      "conversationId": "XXXXX",
      "token": "XXXXX",
      "expires_in": 3600
  }
  

Further reading

• Bot Framework Documentation
• Bot Basics
• Activity processing
• Azure Bot Service Introduction
• Azure Bot Service Documentation
• Azure CLI
• Azure Portal
• Language Understanding using LUIS
• Channels and Bot Connector Service
• TypeScript
• Restify
• dotenv