The Teloscope Telegram Bot: A Guide for Beginners

What is The Teloscope Bot?

The Teloscope Bot is a third-party application that runs inside the messaging app Telegram. Users can interact with The Teloscope Bot by sending messages and commands to it by opening a chat with it.

Here is a list of the bot’s main features:

  • Get information about Telos accounts: display stats about CPU, NET, and RAM resources, total balance, votes cast and inclusion in snapshots.
  • Monitor accounts and premium names: subscribe to real-time notifications and set a threshold to filter out irrelevant Tx.
  • Check TLOS exchange rate in EOS and US dollar, or use the TLOS to USD converter.
  • Know current RAM price on Telos Mainnet in TLOS/KB
  • Create a new Telos account for free.

How to use it

You can access The Teloscope Bot at https://t.me/TeloscopeBot 
Once you’re chatting with the bot type /start or press Start to begin.

Initial screen of The Teloscope Bot

The bot will ask you the “What do you want to do?” question. Now you can press Subscriptions, Any Account Info, Converter, Free Telos Account, Settings, Help or type the common slash (/) to bring up the list of commands.

Options after issuing /start command
List of commands available

The commands are pretty self-explanatory:

  • /help — returns a help message.
  • /start — begins interaction with the user. This command gives you access to the subscription service and information about any account in Telos.
  • /freetelosacct — creates a new Telos account for free. You just need to fill in the account name and the keys.
  • /tlos_price — returns the real-time price of TLOS token for these trading pairs: TLOS/EOS and TLOS/USD.
  • /ram_price_nm — returns the actual price in TLOS of 1 KB of RAM on Telos mainnet.
  • /web — returns the URL of The Teloscope website.

Subscriptions

You can press Telos accounts, or Bid names to select the type of subscription that you want to manage.

Options under Subscriptions action

Accounts

You are allowed to subscribe up to a maximum of five different Telos accounts. Select Show subs for listing all your current subscriptions, New for adding a subscription, or Delete for removing it.

Options under Telos accounts action

You will be notified whenever there are relevant actions from/to any of those accounts. Alerts are sent immediately.

By default, alert threshold is set to 0.1000 TLOS. You can change that value under Settings at the initial bot screen. Please read further below on the Transactions threshold section how to do it.

The current balance and specific links to Tx details on EOSX, TF, and TELOSTRACKER explorers are included in the information that is sent.

If you want to test that bot notifications are working you can proceed as follows: go to your preferred voting application (wallet or web) and submit your votes again.

Names

The Bid names option helps you follow the Telos premium names you want. You are allowed to subscribe up to a maximum of five different ones. You can even subscribe to names that include a dot (.) in them.

Premium names are part of a bidding process. Whenever an account places a bid for any of those names the bot will send you an alert including the bound bid information.

Sample message received after a bid was placed

Contracts

The Contracts option lets you receive alerts whenever the code of a smart contract has been updated. You can subscribe to any Telos contract the same way you do with accounts and bidnames.

This may be useful not only for developers but for anyone who’s especially concerned with possible changes made to custom tokens etc.

Any Account Info

This option gives you plenty of information about any Telos account. You just need to provide the name of the account you want the bot to query about.

Give the name of the account
You can get info about Resources, Votes and Snapshots

Resources

Resources button gives you access to several types of information about the provided account. You can check stats about CPU, NET, RAM and Total balance, either individually or all together.

Available information about any given account

Votes

Votes button returns the list of voted BPs. If you are using a proxy the name of the proxy and its voted BPs are displayed.

List of BPs voted (and proxy if used) by an account

Snapshots

This option lets you check if your account is included in any of the ‘official’ snapshots.

Converter

This option makes quick and easy convert TLOS to and from USD in real-time.

Choose an option and then type the amount you want to convert

Free Telos Account

You can get a free Telos account, compliments of the Telos Foundation who has deposited funds for about 2 million free new user accounts. You just need to fill in the account name and the keys.

The account name must be 12 characters long, and can contain lowercase (a-z) and certain digits (1–5). In case of non availability of the name the bot will warn you.

For the public owner and active keys we recommend you copy-paste new ones created with a secure key pair generator service like the one from TF MONITOR.

And please back up all your keys and do not share your private key with anyone!

Settings

You can customize your settings to make the bot suit your needs and preferences.

Default network

By default, all the available options are executed on the Telos Mainnet. But you can change your default network to the Telos Testnet with this option.

Transactions threshold

By default, the minimum transaction amount set in order to receive a bot alert is 0.1000 TLOS for all and each of your subscribed accounts. You can see current value or modify it. Just keep in mind that it is a global value, so you cannot set it on a per account basis.

Change language

By default, the language of the bot interface and chat messages is English. But as the bot is multilingual you may also chat with it in your local language. You can easily change your interface language by pressing the ‘Change language’ and selecting your preferred one.

Currently languages available are Spanish, Turkish, Russian and English. With the help of the community we plan to expand to more languages over the next updates. Please contact @TheTeloscope in case you like to volunteer to help translate the bot’s interface to your local language.

Options displayed in Spanish language

Troubleshooting

Please note that you must have a username in Telegram, not just a display name, in order for the bot to chat with you. So make sure you set one in the Telegram app settings.

If you are experiencing operational issues (freezing up, general slowness) with the bot, please type /start and check again.

If the problem still persists you can check Telegram Messenger twitter to see if there are any widespread connection issues. It doesn’t happen often but sometimes Telegram experiences difficulties that affect chatbots as well.

Please note that The Teloscope bot is currently in public beta. This means that it is feature ready but might have bugs that can be found only when a wide user base tries it out. If you find any issue with the current version of the bot, please contact us.

Future development

We are always testing refinements that we include as soon as we can in regular updates of the bot. If you have a sound proposal of improvement, please contact us. And check our community channels for new announcements related with The Teloscope Bot.

Protect yourself from scammers

Naturally, any bot should be treated as a stranger. Bots are no different from human users that you meet in groups for example.

Beware of anyone impersonating either our bots or any of The Teloscope team members, even if they chat nicely! Just click on the photo/avatar of the bot/person you are talking to, to check their username and compare this with @TeloscopeBot or @TheTeloscope.

We will never chat with you about our bot from any other account. Moreover we will never ask you for passwords, private keys, Telegram codes or crypto/money.

Also, be careful when opening files sent by bots, same as you would deal with ordinary humans.


This guide has been produced by members of The Teloscope team.

The Teloscope is an independent nonprofit Telos block producer — our work is free from the influence of crypto whales or other BPs. The revenue we get from any service we provide to the Telos network is fully invested in our Telos BP infrastructure, as well as in tools and services for the blockchain community.

You can support us by including theteloscope among the list of BPs that deserve your vote.