Edit readme
This commit is contained in:
parent
8e3b3ca8bf
commit
8ac79a06a8
47
README.md
47
README.md
|
@ -1,22 +1,45 @@
|
|||
# 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
|
||||
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`
|
||||
## 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
|
||||
```
|
||||
|
||||
|
||||
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.
|
||||
|
|
Loading…
Reference in New Issue