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
Telegram bot to reiceve notifications.
Notificambot reads notifications from a queue (pub/sub on redis).
Telegram bot to receive notifications reads from a queue (pub/sub on Redis).
## Configuration
1. Create telegram bot with **@BotFather**.
2. Clone this repository.
3. Start a redis instance on localhost.
4. Install dependencies with `npm install`.
5. Configure env file (and rename from `env.sampe` to `.env`).
6. Launch with `node src/server.js`
Rename .env.sample in .env and configure it:
You can configure templates into `src/templates.js`.
| 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 |
## Test
You can perform a test with command: `node pub-redis-example.js`
## Usage
1. Clone the project with
```sh
git clone https://github.com/franjsco/NotificamBot.git
```
2. Build docker image and run it with docker-compose:
```sh
docker-compose up --build
```
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.
```sh
docker-compose up
```
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.