Telegram notifications
Notifications work by first creating a personal bot on Telegram, Gunbot then connects to this bot to push notifications to you.
Direct link
#
Steps to create a Telegram botThis is how to create a bot:
- Talk to @botfather. Create a new bot with the command /newbot and choose a name and username for your bot. Save the bot token shown.
- Talk to @myidbot to see your Chat ID, save it. In case myidbot has downtime, @JsonDumpBot can also provide the needed info.
- 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.
- 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.
- To enable trade notifications, enable these in the settings menu inside the Telegram bot.
tip
After setting it up, start a chat with your bot on Telegram, type /start
to your bot to open the menu and configure which kind of notifications you want to receive.
#
Settings descriptionsBelow you'll find detailed descriptions of all available parameters for Telegram notifications.
#
Enable Telegram bot- Description
- Values
- Name
Enable this to have Gunbot send trade notifications through Telegram.
Values: true or false
Default value: false
Parameter name in config.js
: TELEGRAM_ENABLED
#
Enable test message- Description
- Values
- Name
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
#
Bot Nickname- Description
- Values
- Name
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- Description
- Values
- Name
The Telegram token for your bot.
Values: string
Default value: YOURTOKEN
Parameter name in config.js
: TOKEN
#
Chat ID- Description
- Values
- Name
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.
Pull the group id from this link: https://api.telegram.org/bot[tokenhere]/getUpdates
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- Description
- Values
- Name
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