sp-dev-fx-webparts/samples/react-bot-framework-secure/bot/README.md

3.2 KiB
Raw Blame History

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 Direct Line Secret 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