Edit readme

This commit is contained in:
Francesco Esposito 2022-01-31 16:42:21 +01:00
parent 8e3b3ca8bf
commit 8ac79a06a8
2 changed files with 35 additions and 12 deletions

View File

@ -1,22 +1,45 @@
# NotificamBot # NotificamBot
Telegram bot to reiceve notifications. Telegram bot to receive notifications reads from a queue (pub/sub on Redis).
Notificambot reads notifications from a queue (pub/sub on redis). ## Configuration
Rename .env.sample in .env and configure it:
| KEY |DESCRIPTION |
|-- | --|
| BOT_TOKEN | Telegram Bot Token created with @BotFather |
| CHAT_ID | Your chat id with the bot (you can configure this after the first launch of the bot from client) |
| REDIS_CHANELL | Channel where the bot reads|
| REDIS_HOST | Host redis (don't touch if you use docker-compose).
| REDIS_PASSWORD| Redis password |
## Configuration ## Usage
1. Create telegram bot with **@BotFather**.
2. Clone this repository. 1. Clone the project with
3. Start a redis instance on localhost. ```sh
4. Install dependencies with `npm install`. git clone https://github.com/franjsco/NotificamBot.git
5. Configure env file (and rename from `env.sampe` to `.env`). ```
6. Launch with `node src/server.js`
2. Build docker image and run it with docker-compose:
```sh
docker-compose up --build
```
You can configure templates into `src/templates.js`. 3. Search your bot on telegram and start it. The chat id will be displayed on the terminal
Copy it into .env and stop (CTRL+C) and start containers.
## Test ```sh
docker-compose up
```
You can perform a test with command: `node pub-redis-example.js` 4. Now you can perform a test.
```sh
node test-publish.js
```
5. You can send notifications to the bot by connecting to the container redis instance from any application and post messages to the configured queue.