Skip to main content

Telegram Notifications

Get a Telegram message every time one of your bot orders fills.

Setup overview​

  1. Create a Telegram bot via @BotFather
  2. Add the bot token to your server .env
  3. Connect your Telegram account in the dashboard

Step 1 — Create a bot with BotFather​

  1. Open Telegram and search for @BotFather
  2. Send /newbot
  3. Choose a name (e.g. GridFlow Alerts)
  4. Choose a username (must end in bot, e.g. gridflow_mybot)
  5. BotFather gives you a token like: 7123456789:AAFxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Copy that token.

Step 2 — Add the token to your server​

SSH into your server and edit the .env file:

cd /root/gridflow
nano .env

Find the line:

TELEGRAM_BOT_TOKEN=

Paste your token after the =:

TELEGRAM_BOT_TOKEN=7123456789:AAFxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Save and exit (Ctrl+X, then Y, then Enter), then restart the backend:

docker compose restart backend

Step 3 — Connect your account in the dashboard​

  1. Open your GridFlow dashboard
  2. Go to Settings → Notifications
  3. Under Telegram, click Find my Chat ID
  4. First, send any message to your bot on Telegram (search for it by username)
  5. Click Find my Chat ID again — GridFlow reads the latest message to find your ID
  6. Click Save

Test it​

Click Send test notification on the Notifications page. You should receive a message on Telegram within a few seconds.

What you'll receive​

Every time a limit order fills, you get a message like:

⚡ GridFlow — Order Filled
BUY  0.00105 BTC/USDT at $92,500

For sell orders, the profit is included:

⚡ GridFlow — Order Filled
SELL 0.00105 BTC/USDT at $95,000
Profit: +$2.40 USDT