Gunbot wiki
Wiki em português
English
English
  • Welcome to the Gunbot wiki
  • About
    • What's new?
      • New in v22
      • New in v20
      • New in v18
      • New in v16.7+
      • New in v16
      • New in v15
      • New in v13 / v14
      • New in v12
      • New in v11
      • New in v10
      • New in v9
      • New in v8
      • New in v7
      • New in v6
    • Supported exchanges
      • Creating API keys
      • Websockets support
    • License info & system specs
      • How to create a wallet
    • Purchasing Gunbot
  • Setup & general settings
    • Installation & startup
      • Quickstart guide
      • Download software
      • Windows installation
      • macOS installation
      • Linux installation
      • ARM installation
      • How to enable SSL/TLS
      • Running multiple instances
      • Headless mode
    • Global settings
      • Import settings
      • Bot settings
      • Cancel orders
      • Advanced
    • Profile settings
      • Exchanges
      • Gunthy wallet
      • Edit license
      • GUI authentication
      • Telegram
      • Tournament
  • How to work with Gunbot
    • Learning the basics
      • Trading logic
      • Important settings
      • Order types
      • Period
      • Trailing
      • ROE trailing
    • Strategies & pairs
      • Easy edit
      • Strategy editor
      • Trading pairs
        • Pair processing
    • Chart & results
    • Extra modules
      • AutoConfig
      • Backtesting
      • Code editor
      • TradingView Alerts
        • IMAP listener
      • Alerts (beta)
  • Trading strategy options
    • About Gunbot strategies
      • Trading methods
      • Protections
    • Regular strategies (spot trading)
      • ADX
      • ATRTS
      • Bollinger Bands
      • Bollinger Bands (TA)
      • EMA spread
      • Emotionless
      • Gain
      • Ichimoku
      • MACD
      • MACDH
      • Pingpong
      • Stepgain
      • Spotgrid
      • Spotgrid Advanced
      • StepGrid
      • SMA cross
      • Support / Resistance
      • Tssl (trailing stop / stop limit)
      • Time series analysis
    • Margin trading strategies
      • ADX
      • ATRTS
      • Bollinger Bands
      • Bollinger Bands (TA)
      • EMA spread
      • Futures Grid
      • Gain
      • Ichimoku
      • MACD
      • MACDH
      • Pingpong
      • Stepgain
      • SMA cross
      • Tenkan
      • Tssl (trailing stop / stop limit)
      • Time series analysis
    • Custom strategies
    • Balance settings
    • Confirming indicators
    • Dollar Cost Avg (DCA)
    • Reversal trading (RT)
    • TrailMe
    • Misc settings
  • More
    • Config marketplace
  • Various
    • Backups
    • Logs
    • Handling bags
    • Acronyms
  • Troubleshooting
    • Critical errors
    • Bot does not trade
    • Reset password
Powered by GitBook
On this page
  • Steps to create a Telegram bot
  • Demo video
  • Settings descriptions
  • Enabled
  • Bot Nickname
  • Token
  • Chat ID
  • Admin ID / User ID
  • TG PL Only
  • Telegram Order Timeout
  • TG Test

Was this helpful?

  1. Setup & general settings
  2. Profile settings

Telegram

Gunbot comes with a built-in Telegram bot that can be used to receive trade notifications, retrieve stats and control certain options of Gunbot right from from your Telegram client.

PreviousGUI authenticationNextTournament

Last updated 4 years ago

Was this helpful?

To set this up, go to > Telegram.

Steps to create a Telegram bot

Notifications work by first creating a personal bot on Telegram, Gunbot then connects to this bot to push notifications to you.

This is how to create a bot:

  1. Talk to . Create a new bot with the command /newbot and choose a name and username for your bot. Save the bot token shown.

  2. Talk to to see your Chat ID, save it.

  3. Enable Telegram notifications for Gunbot, and enter the token and ID you've just gathered. Use the ID for both the user and admin ID fields, this makes sure that only you can interact with the Telegram bot. Alternatively, you can set a comma separated list for Admin ID, specifying multiple IDs who may interact with the bot.

  4. Start a chat with the username you've picked for your bot, and hit the start button. If you don't see a start button, write "/start" and send it as message.

  5. To enable trade notifications, enable these in the settings menu inside the Telegram bot.

The Telegram bot is fully integrated into Gunbot. All you need to do to start the Telegram bot is enable Telegram notifications in your Gunbot settings.

After setting it up, type /start to your bot to open the menu.

Demo video

Settings descriptions

Below you'll find detailed descriptions of all available parameters for Telegram notifications.

Enabled

Enable this to have Gunbot send trade notifications through Telegram.

Values: true or false

Default value: false

Parameter name in config.js: TELEGRAM_ENABLED

Bot Nickname

Each trade notification starts with the nickname set here.

Use this to easily check from which bot instance the notifications have been sent.

Values: string

Default value: Gunbot

Parameter name in config.js: TELEGRAM_NICK

Token

The Telegram token for your bot.

Values: string

Default value: YOURTOKEN

Parameter name in config.js: TOKEN

Chat ID

The Chat ID for your bot to send its messages to.

Valid options:

"12345"

A positive integer, to send messages directly to a telegram user. Use this method when you just want to receive notifications for your personal use.

To find your telegram id, send /start to @MyTelegramID_bot and it will respond with your ID.

"-12345"

A negative integer, to send messages to a group chat.

replace [tokenhere] (no brackets)

look for "chat":{"id":-[groupchatidnumber],"title":"Group Name","type":"supergroup"}

Values: string

Default value: 123456789

Parameter name in config.js: chat_id

Admin ID / User ID

Defines which Telegram user IDs are allowed to interact with the bot. Must be used next to Chat ID.

When you leave this value empty, every Telegram user is able to interact with your Telegram bot.

Multiple IDs can be entered as a comma separated list.

Values: string

Default value: empty

Parameter name in config.js: user_id

TG PL Only

When enabled notifications will be only sent for strategy sell orders.

Values: true or false

Default value: false

Parameter name in config.js: TG_PL_ONLY

Telegram Order Timeout

When set above 0, you'll receive a Telegram dialog to manually allow or deny every order Gunbot wants to place.

During the set amount of seconds you can choose to allow the order (and it will immediately be placed) or deny it. After the timeout passes without reply, the order will be placed at the exchange.

Values: numerical, represent time in seconds.

Default value: 0

Parameter name in config.js: TG_ORDER_TIMEOUT

TG Test

Enable this to test if your Telegram bot is working.

A test message will be sent on the first round for each pair. Disable after verifying your bot works.

Values: true or false

Default value: false

Parameter name in config.js: TG_TEST

Pull the group id from this link:

https://api.telegram.org/bot[tokenhere]/getUpdates
Profile
@botfather
@myidbot