|
1 | | -.. _installing-packages: |
| 1 | +# echo-bot |
| 2 | + |
| 3 | +Bot Builder v4 echo bot sample |
| 4 | + |
| 5 | +This bot has been created using [Bot Framework](https://dev.botframework.com), it shows how to create a simple bot that accepts input from the user and echoes it back. |
| 6 | + |
| 7 | +## Prerequisites |
| 8 | + |
| 9 | +- [Node.js](https://nodejs.org) version 18 or higher |
| 10 | + |
| 11 | + ```bash |
| 12 | + # determine node version |
| 13 | + node --version |
| 14 | + ``` |
| 15 | + |
| 16 | +## To try this sample |
| 17 | + |
| 18 | +- Clone the repository |
| 19 | + |
| 20 | + ```bash |
| 21 | + git clone https://github.com/microsoft/botbuilder-samples.git |
| 22 | + ``` |
| 23 | + |
| 24 | +- In a console, navigate to `samples/typescript_nodejs/02.echo-bot` |
| 25 | + |
| 26 | + ```bash |
| 27 | + cd samples/typescript_nodejs/02.echo-bot |
| 28 | + ``` |
| 29 | + |
| 30 | +- Install modules |
| 31 | + |
| 32 | + ```bash |
| 33 | + npm install |
| 34 | + ``` |
| 35 | + |
| 36 | +- Start the bot |
| 37 | + |
| 38 | + ```bash |
| 39 | + npm start |
| 40 | + ``` |
| 41 | + |
| 42 | +## Testing the bot using Bot Framework Emulator |
| 43 | + |
| 44 | +[Bot Framework Emulator](https://github.com/microsoft/botframework-emulator) is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel. |
| 45 | + |
| 46 | +- Install the Bot Framework Emulator version 4.3.0 or greater from [here](https://github.com/Microsoft/BotFramework-Emulator/releases) |
| 47 | + |
| 48 | +### Connect to the bot using Bot Framework Emulator |
| 49 | + |
| 50 | +- Launch Bot Framework Emulator |
| 51 | +- File -> Open Bot |
| 52 | +- Enter a Bot URL of `http://localhost:3978/api/messages` |
| 53 | + |
| 54 | +## Deploy the bot to Azure |
| 55 | + |
| 56 | +To learn more about deploying a bot to Azure, see [Deploy your bot to Azure](https://aka.ms/azuredeployment) for a complete list of deployment instructions. |
| 57 | + |
| 58 | +## Further reading |
| 59 | + |
| 60 | +- [Bot Framework Documentation](https://docs.botframework.com) |
| 61 | +- [Bot Basics](https://docs.microsoft.com/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0) |
| 62 | +- [Activity processing](https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-concept-activity-processing?view=azure-bot-service-4.0) |
| 63 | +- [Azure Bot Service Introduction](https://docs.microsoft.com/azure/bot-service/bot-service-overview-introduction?view=azure-bot-service-4.0) |
| 64 | +- [Azure Bot Service Documentation](https://docs.microsoft.com/azure/bot-service/?view=azure-bot-service-4.0) |
| 65 | +- [Azure CLI](https://docs.microsoft.com/cli/azure/?view=azure-cli-latest) |
| 66 | +- [Azure Portal](https://portal.azure.com) |
| 67 | +- [Language Understanding using LUIS](https://docs.microsoft.com/en-us/azure/cognitive-services/luis/) |
| 68 | +- [Channels and Bot Connector Service](https://docs.microsoft.com/en-us/azure/bot-service/bot-concepts?view=azure-bot-service-4.0) |
| 69 | +- [TypeScript](https://www.typescriptlang.org) |
| 70 | +- [Restify](https://www.npmjs.com/package/restify) |
| 71 | +- [dotenv](https://www.npmjs.com/package/dotenv). _installing-packages: |
2 | 72 |
|
3 | 73 | =================== |
4 | 74 | Installing Packages |
|
0 commit comments