https://github.com/msimecek/desktop-chatbot
Desktop application wrapper for the Bot Framework WebChat control built using Electron.
https://github.com/msimecek/desktop-chatbot
bot-framework electron
Last synced: about 1 year ago
JSON representation
Desktop application wrapper for the Bot Framework WebChat control built using Electron.
- Host: GitHub
- URL: https://github.com/msimecek/desktop-chatbot
- Owner: msimecek
- License: mit
- Created: 2017-10-09T13:08:59.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-16T14:38:41.000Z (over 8 years ago)
- Last Synced: 2025-04-18T05:08:29.809Z (about 1 year ago)
- Topics: bot-framework, electron
- Language: TypeScript
- Homepage: http://codez.deedx.cz/projects/desktop-chatbot/
- Size: 84 KB
- Stars: 4
- Watchers: 0
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Desktop Chatbot
Hosting Bot Framework's web chat control inside an Electron app to enable chatbot distribution independent from operating system & web browser.
> This project was built in cooperation with a real customer. Read the whole story [on my blog](http://codez.deedx.cz/projects/desktop-chatbot/).
## How to build it
This app is built using Electron and TypeScript. To be able to edit and build it, you need to install:
* [Node.js](https://nodejs.org/en/)
* [TypeScript](https://www.typescriptlang.org/#download-links)
* can be installed via npm: `npm install -g typescript`
* to browse and edit the code I recommend [Visual Studio Code](https://code.visualstudio.com/)
You also need to have a [Bot Framework](http://dev.botframework.com) chatbot registered at the portal with [DirectLine channel enabled](https://docs.microsoft.com/en-us/bot-framework/channel-connect-directline).
## Configuration
Copy your **DirectLine secret** from the portal and paste it to `/app/botConfig.ts` - value `directLineSecret`. Also change the rest of the configuration to suit your needs.
```typescript
export const BotConfig =
{
header: {
backgroundColor: "lightblue",
textColor: "white",
visible: false
},
bot: {
directLineSecret: "Mfy7FwAXCAAACSCSAAAd.cwA.8zI.AAAANNSKKSSDJa-rQxsBxZJSsaAO0r5mqYape4",
userId: "user",
userName: "User",
botId: "bot",
botName: "Bot"
},
uploadButton: false,
devMode: false
}
```
Then you can build and start the app:
1. Download this repo or clone it with Git: `git clone https://github.com/msimecek/Desktop-Chatbot.git`
2. `cd Desktop-Chatbot/src`
3. `npm install`
4. `tsc -p ../`
5. `npm start`
## Installer
To build an installer, simply run `/src/js/installer.js` with Node.js:
```
cd Desktop-Chatbot/src/js
node installer.js
```
It takes a few seconds, so be patient.
You will find output in the `/out` folder.
## Remarks
Icon used by this project was made by [Gregor Cresnar](https://www.flaticon.com/authors/gregor-cresnar) from [https://www.flaticon.com/](www.flaticon.com)