Home

Steps to get started running in the bot emulator

Get VSCode:

• https://code.visualstudio.com/
• NOTE: When installing, setting "open with" for the file and directory contexts can be helpful

Install Node:

• https://nodejs.org/en/download/
• NOTE: This gives you npm

Install Gulp globally - run:

• npm install --global gulp

Install the bot Emulator - click on "Bot Framework Emulator (Mac and Windows)":

• https://docs.botframework.com/en-us/downloads/#navtitle
• NOTE: make sure to pin the emulator to your task bar because it can sometimes be difficult to find again

Install Git for windows:

• https://git-for-windows.github.io/

Clone this repo:

• git clone https://github.com/OfficeDev/microsoft-teams-template-bot.git

Get the npm modules - in the microsoft-teams-bot-template directory run:

• npm install

Open microsoft-teams-bot-template with VSCode

In VSCode go to the debug tab on the left side (looks like a bug) and click the play button

Once the code is running you can now connect and chat with the bot using the emulator

• connect to the default "http://localhost:3978/api/messages" leaving "Microsoft App ID" and "Microsoft App Password" blank

We apologize and realize this is very lacking in regards to documentation - more will be coming shortly

• Notice that an easy way to create a new dialog is to simply copy one that is in src/dialogs, change it accordingly, and then instantiate it with the others in the RootDialog.ts
• Also note that breakpoints made in VSCode in the typescript files function correctly

NOTE: install ngrok to get Teams to easily work with a locally running bot:

• https://ngrok.com/