Edit readme
This commit is contained in:
parent
8e3b3ca8bf
commit
8ac79a06a8
51
README.md
51
README.md
|
@ -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
|
## Configuration
|
||||||
1. Create telegram bot with **@BotFather**.
|
|
||||||
2. Clone this repository.
|
Rename .env.sample in .env and configure it:
|
||||||
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`
|
|
||||||
|
|
||||||
|
|
||||||
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.
|
||||||
|
|
Loading…
Reference in New Issue