GNYIO · xpgeng · Sep 9, 2020 · Sep 16, 2020 · Sep 16, 2020
diff --git a/docs/guide/how-to-configure-telegram-bot.md b/docs/guide/how-to-configure-telegram-bot.md
@@ -0,0 +1,83 @@
+# How to configure a GNY monitoring bot with Telegram
+
+## Register a new telegram bot
+
+Please read this doc about [how to create a new bot by BotFather](https://core.telegram.org/bots#creating-a-new-bot). BotFather is also a telegram bot which helps you create new bots and change settings for your bots. You should remember your bot token.
+
+![bot father](../shapes/bot_father.png)
+
+## Deloy the bot backend
+
+- Clone `gny-telegram-bot`
+
+```bash
+git clone https://github.com/GNYIO/gny-telegram-bot.git
+
+```
+
+- Deploy the backend to heroku
+
+```
+# Create the app
+heroku create gny-telegram-bot
+
+# Push to heroku
+git push heroku master
+
+# Change to worker instance
+heroku ps:scale worker=1
+```
+
+> You can deploy the bot backend to any platform or VPS. Here we use Heorku just for its convenience and free plan.
+
+- Create database
+
+```
+
+heroku addons:create heroku-postgresql:hobby-dev
+
+```
+
+After running this command, a DATABASE_URL config var is added to your app’s configuration. You can also add it to heroku settings on the web page manually.
+
+- Add envronment variables
+  - `TELEGRAM_BOT_TOKEN`: your bot token given by BotFather
+
+* Some usefule heorku commands
+
+```
+heroku restart
+
+heroku logs --tail
+
+heroku pg:psql
+```
+
+## Commands
+
+![start](../shapes/bot_start.png)
+
+- `/status`: show the node status
+
+![status](../shapes/bot_status.png)
+
+- `/add [ip] [port] [network] [https]`: add a node
+  - `/add testnet.gny.io 443 testnet true`
+
+![add a node](../shapes/bot_status.png)
+
+- `/remove [ip]`: remove a node
+
+![remove a node](../shapes/bot_remove.png)
+
+- `/price`: get GNY current price
+
+![get GNY price](../shapes/bot_price.png)
+
+- `/help`: help summary
+
+> You can add any command by yourself. Here is [TeleBot usage](https://github.com/mullwar/telebot) for your reference.
+
+## GNY Bot
+
+We also deploy a GNY Bot, you can interacte with @gny_telegram_bot to monitor your node.
diff --git a/docs/shapes/bot_add.png b/docs/shapes/bot_add.png
diff --git a/docs/shapes/bot_father.png b/docs/shapes/bot_father.png
diff --git a/docs/shapes/bot_price.png b/docs/shapes/bot_price.png
diff --git a/docs/shapes/bot_remove.png b/docs/shapes/bot_remove.png
diff --git a/docs/shapes/bot_start.png b/docs/shapes/bot_start.png
diff --git a/docs/shapes/bot_status.png b/docs/shapes/bot_status.png