Skip to content

Latest commit

 

History

History
53 lines (33 loc) · 5.98 KB

01-Setup.md

File metadata and controls

53 lines (33 loc) · 5.98 KB

Setup your Development Environment

01 - Fork Repository

To work with your own copy of this code simply click on Fork and create your own duplication of this repo. Fork

02 - Download the Source Code

First go to the start Page of the Repository and download the whole Repository as a .zip File. If you don't know how - just follow the Steps in the Images bellow.

Step 1 Picture Step 2 Picture

After you successfully downloaded the Repository as a zip File, extract it to any location on your Computer. You will be working inside this folder afterwards. Also be sure that there is at least 1 GB Space free on the harddrive you've selected. Step 3 Picture

Go into the "src" - Folder and open try opening the Solution File (.sln) if Visual Studio opens - you can Skip the next Step. Elsewise, if your Environment does not know .sln Files follow the next steps Step 4 Picture

02 - Install Visual Studio Community Edition

Go to https://www.visualstudio.com/de/vs/community/ and click "Download VS Community 2017"

Inside the Installer choose at least those Options Installer

03 - Install Bot Emulator Framework

Visit the Bot Emulator Page https://emulator.botframework.com/ and install the application.

The Bot Emulator Framework allows us to connect to our Bot via the Bot Connector. This will simulate the real behaviour from different Channels like Facebook or Direct Line. So the Bot Connector acts as a unified Endpoint for all those Channels or - lets say Consumers. It also implements all those special Chat Features, like Hero Cards and rounds up the development with some Tools too peek at whats happening in the background. After starting the Bot Emulator you should see something like this: BotEmulator

04 - Run the Code

Now lets go back to Visual Studio and start debugging by pressing F5. This will spin up an IIS Express Instance running your Bot as Web API Solution. After a short time your default Browser should open and display an URL like http://localhost:/default.htm. We need the Port Number to connect the Bot Emulator to your Bot Api. Back in the Bot Emulator enter http://localhost:/api/messages in the blue bar on the top and press "Connect". If everything worked out well - the Bot should send you its very first message Bot Welcome

If you have trouble connecting the Bot right-click the Project > Properties

Project Solution

go to the "Web Tab" and press the "Create virtual directory" CreateVirtualDirectory

You are able to click on every message and see the Json data transfered as your request/response. This will help you troubleshoot problems.

Bot Details