https://github.com/patrickjaja/workoflow-bot
simple teams bot redirecting messages to n8n (https://github.com/patrickjaja/workoflow-hosting)
https://github.com/patrickjaja/workoflow-bot
Last synced: 8 months ago
JSON representation
simple teams bot redirecting messages to n8n (https://github.com/patrickjaja/workoflow-hosting)
- Host: GitHub
- URL: https://github.com/patrickjaja/workoflow-bot
- Owner: patrickjaja
- Created: 2025-05-22T15:17:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-08T10:02:40.000Z (10 months ago)
- Last Synced: 2025-08-08T11:41:27.748Z (10 months ago)
- Language: JavaScript
- Size: 1.62 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Workoflow Bot
This is a simple Bot connecting n8n to Teams built using the Microsoft Bot Framework SDK v4 for Node.js. It's designed to orchestrate company internal tools and data combined with modern agent and AI functionalities.
Due to a data privacy first approach this bot uses self hosted services to store its data. https://github.com/patrickjaja/workoflow-hosting
## Prerequisites
Before you begin, ensure you have the following installed:
* Node.js (LTS version recommended)
* npm (comes with Node.js)
* Bot Framework Emulator
* Git (for cloning the repository)
## Getting Started
Follow these steps to get your bot up and running locally.
### 1. Clone the Repository
### 2. Install Dependencies
Install the necessary npm packages:
### 3. Configure Environment Variables
Create a `.env` file in the root of the project directory (e.g., `workoflow-bot/.env`).
* `MicrosoftAppId` and `MicrosoftAppPassword`: Your bot's App ID and Password from the Azure Bot registration. Leave blank if you are not securing your bot or for initial local testing without authentication.
* `MicrosoftAppType`: Type of Microsoft App. Common values are `UserAssignedMSI`, `MultiTenant`.
* `MicrosoftAppTenantId`: The tenant ID for your Microsoft App.
* `WORKOFLOW_PORT`: The port on which the bot server will listen. Defaults to `3978` if not specified.
* `WORKOFLOW_N8N_WEBHOOK_URL`: The url of your n8n webhook.
### 4. Run the Bot
- npm run watch (or npm run start)
### Testing with Bot Framework Emulator
1.Launch the Bot Framework Emulator.
2.Connect to the bot:•Click on "Open Bot".
For "Bot URL", enter http://localhost:3978/api/messages (or replace 3978 with the port you configured in WORKOFLOW_PORT in your .env file).
If you configured MicrosoftAppId and MicrosoftAppPassword in your .env file, enter them into the Emulator's connection dialog. Otherwise, you can leave them blank for local testing if your bot doesn't strictly require them for local emulation.
Click "Connect".
3.Send a message: Once connected, type a message in the chat window and send it. The bot should echo your message back to you.